Set-UMIPGateway
このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。
Set-UMIPGateway コマンドレットを使用すると、単一のユニファイド メッセージング (UM) IP ゲートウェイの構成情報を変更することも、また UM IP ゲートウェイを指定して変更可能な構成設定の一覧を取得することもできます。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
Set-UMIPGateway
[-Identity] <UMIPGatewayIdParameter>
[-Address <UMSmartHost>]
[-Confirm]
[-DelayedSourcePartyInfoEnabled <Boolean>]
[-DomainController <Fqdn>]
[-ForceUpgrade]
[-IPAddressFamily <IPAddressFamily>]
[-MessageWaitingIndicatorAllowed <Boolean>]
[-Name <String>]
[-OutcallsAllowed <Boolean>]
[-Port <Int32>]
[-Simulator <Boolean>]
[-Status <GatewayStatus>]
[-WhatIf]
[<CommonParameters>]
説明
Set-UMIPGateway コマンドレットは、IP ゲートウェイに割り当てられた IP アドレスなど、特定の UM IP ゲートウェイの構成設定を変更します。 これらの変更には、発信呼び出しの許可とセッション開始プロトコル (SIP) に対応する IP 構内交換機 (PBX) または IP ゲートウェイとの通信の制御が含まれます。
UM IP ゲートウェイの設定を変更すると、メールボックス サーバーと SIP 対応 IP PBX または IP ゲートウェイ間の通信が中断される可能性があります。 UM IP ゲートウェイの変更は、UM IP ゲートウェイの構成を変更した場合の影響を完全に理解している管理者のみが実行する必要があります。
このタスクを完了すると、UM IP ゲートウェイで、指定したパラメーターおよび値が構成されます。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事ではコマンドレットのすべてのパラメーターを一覧表示しますが、割り当てられたアクセス許可にパラメーターが含まれていない場合は、一部のパラメーターにアクセスできない可能性があります。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Set-UMIPGateway -Identity MyUMIPGateway -Address 10.10.10.1
この例では、UM IP ゲートウェイ MyUMIPGateway の IP アドレスを変更します。
例 2
Set-UMIPGateway -Identity MyUMIPGateway -Address 10.10.10.1 -Status Disabled -OutcallsAllowed $false
この例では、UM IP ゲートウェイが着信呼び出しを受け付けないようにし、また、発信呼び出しを行えないようにします。
例 3
Set-UMIPGateway -Identity MyUMIPGateway -Address fe80::39bd:88f7:6969:d223%11 -IPAddressFamily Any -Status Disabled -OutcallsAllowed $false
この例では、UM IP ゲートウェイ MyUMIPGateway が着信することおよび発信することを禁止し、IPv6 アドレスを設定し、この UM IP ゲートウェイで IPv4 および IPv6 アドレスを使用することを許可します。
例 4
Set-UMIPGateway -Identity MyUMIPGateway -Simulator $true
この例では、UM IP ゲートウェイが IP ゲートウェイのシミュレーターとして機能できるようにして、Test-UMConnectivity コマンドレットで使用できるようにします。
パラメーター
-Address
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016
Address パラメーターには、UM IP ゲートウェイまたは SIP 対応の IP PBX に構成されている IP アドレスまたは完全修飾ドメイン名 (FQDN) を指定します。 UM IP ゲートウェイに関連付けられている UM ダイヤル プランが、セキュリティで保護された SIP モード、またはセキュリティで保護されたモードで運用されている場合、FQDN は必須です。 FQDN が使用されている場合は、ドメイン ネーム システム (DNS) が正しく構成されていることを確認します。
パラメーターのプロパティ
| 型: | UMSmartHost |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DelayedSourcePartyInfoEnabled
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016
DelayedSourcePartyInfoEnabled パラメーターには、呼び出しの対応する SIP INVITE に呼び出し元と迂回路情報が含まれていない場合に、ユニファイド メッセージングによってボイスオーバー IP (VoIP) ゲートウェイからの着信呼び出しの受け付け処理を遅延させるかどうかを指定します。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DomainController
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
パラメーターのプロパティ
| 型: | Fqdn |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ForceUpgrade
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016
ForceUpgrade スイッチは、オブジェクトが以前のバージョンの Exchange で作成された場合に表示される確認メッセージを抑制します。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016
Identity パラメーターには、変更対象の UM IP ゲートウェイの ID を指定します。 このパラメーターは UM IP ゲートウェイのディレクトリ オブジェクト ID です。
パラメーターのプロパティ
| 型: | UMIPGatewayIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-IPAddressFamily
適用対象: Exchange Server 2013、Exchange Server 2016
IPAddressFamily パラメーターは、使用するインターネット プロトコル (IP) バージョンを指定します。 有効な値は次のとおりです。
- IPv4Only: UM IP ゲートウェイは IPv4 のみを使用して通信します。 この値が既定値です。
- IPv6Only: UM IP ゲートウェイは IPv6 のみを使用します。
- Any: IPv6 が最初に使用されます。 IPv6 が使用できない場合は、IPV4 が使用されます。
パラメーターのプロパティ
| 型: | IPAddressFamily |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MessageWaitingIndicatorAllowed
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016
MessageWaitingIndicatorAllowed パラメーターには、UM ダイヤル プランおよび UM IP ゲートウェイに関連付けられているユーザーに対して、UM IP ゲートウェイからの SIP NOTIFY メッセージを送信できるようにするかどうかを指定します。 既定値は $true です。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016
Name パラメーターには、UM IP ゲートウェイの表示名を指定します。 この表示名は、最大 64 文字です。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-OutcallsAllowed
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016
OutcallsAllowed パラメーターには、この UM IP ゲートウェイを使用した発信呼び出しを許可するかどうかを指定します。 呼び出しの転送は制御されません。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Port
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016
Port パラメーターには、IP ゲートウェイまたは IP PBX が要求待ちを行っている IP ポートを指定します。 既定では、ポート 5060 です。 このパラメーターの範囲は 0 ～ 65,535 です。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Simulator
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016
Simulator パラメーターには、表示対象の UM IP ゲートウェイに使用されるシミュレータを指定します。 シミュレータを使用すると、クライアントとメールボックス サーバーを接続できます。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Status
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016
Status パラメーターには、UM IP ゲートウェイを有効または無効のどちらにするのかを指定します。 有効な値は次のとおりです。
- 有効
- 無効
- NoNewCalls
パラメーターのプロパティ
| 型: | GatewayStatus |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016
WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。