Set-UMIPGateway

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。

Set-UMIPGateway コマンドレットを使用すると、単一のユニファイドメッセージング (UM) IP ゲートウェイの構成情報を変更することも、また UM IP ゲートウェイを指定して変更可能な構成設定の一覧を取得することもできます。

以下の構文セクションのパラメーターセットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

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

Address パラメーターには、UM IP ゲートウェイまたは SIP 対応の IP PBX に構成されている IP アドレスまたは完全修飾ドメイン名 (FQDN) を指定します。 UM IP ゲートウェイに関連付けられている UM ダイヤルプランが、セキュリティで保護された SIP モード、またはセキュリティで保護されたモードで運用されている場合、FQDN は必須です。 FQDN を使用している場合は、ドメインネームシステム(DNS) が正しく構成されているかどうかを確認してください。

Type:	UMSmartHost
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-Confirm

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。

破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-DelayedSourcePartyInfoEnabled

DelayedSourcePartyInfoEnabled パラメーターには、呼び出しの対応する SIP INVITE に呼び出し元と迂回路情報が含まれていない場合に、ユニファイドメッセージングによってボイスオーバー IP (VoIP) ゲートウェイからの着信呼び出しの受け付け処理を遅延させるかどうかを指定します。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-DomainController

DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメインコントローラーを指定します。ドメインコントローラーは、完全修飾ドメイン名 (FQDN) で識別します。たとえば、dc01.contoso.com です。

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-ForceUpgrade

ForceUpgrade スイッチは、オブジェクトが以前のバージョンの Exchange で作成された場合に表示される確認メッセージを抑制します。このスイッチで値を指定する必要はありません。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-Identity

Identity パラメーターには、変更対象の UM IP ゲートウェイの ID を指定します。このパラメーターは UM IP ゲートウェイのディレクトリオブジェクト ID です。

Type:	UMIPGatewayIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-IPAddressFamily

IPAddressFamily パラメーターは、UM IP ゲートウェイが通信にインターネットプロトコルバージョン 4 (IPv4) を使用するか、IPv6 を使用するか、または両方を使用するかを指定します。有効な値は次のとおりです。

IPv4Only: UM IP ゲートウェイは IPv4 のみを使用して通信します。これは既定の値です。
IPv6Only: UM IP ゲートウェイでは IPv6 のみが使用されます。
Any: IPv6 が最初に使用され、必要に応じて IPv4 にフォールバックされます。

Type:	IPAddressFamily
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016

-MessageWaitingIndicatorAllowed

MessageWaitingIndicatorAllowed パラメーターには、UM ダイヤルプランおよび UM IP ゲートウェイに関連付けられているユーザーに対して、UM IP ゲートウェイからの SIP NOTIFY メッセージを送信できるようにするかどうかを指定します。既定値は $true です。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-Name

Name パラメーターには、UM IP ゲートウェイの表示名を指定します。この表示名は、最大 64 文字です。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-OutcallsAllowed

OutcallsAllowed パラメーターには、この UM IP ゲートウェイを使用した発信呼び出しを許可するかどうかを指定します。呼び出しの転送は制御されません。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-Port

Port パラメーターには、IP ゲートウェイまたは IP PBX が要求待ちを行っている IP ポートを指定します。既定では、ポート 5060 です。このパラメーターの範囲は 0 ～ 65,535 です。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-Simulator

Simulator パラメーターには、表示対象の UM IP ゲートウェイに使用されるシミュレータを指定します。シミュレータを使用すると、クライアントとメールボックスサーバーを接続できます。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-Status

Status パラメーターには、UM IP ゲートウェイを有効または無効のどちらにするのかを指定します。有効な値は次のとおりです。

Enabled
無効
NoNewCalls

Type:	GatewayStatus
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-WhatIf

WhatIf スイッチは、コマンドの操作をシミュレートします。このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。このスイッチで値を指定する必要はありません。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

入力

Input types

このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。

出力

Output types

このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。

次の方法で共有