Set-UMIPGateway

參考

模組:: ExchangePowerShell

適用於:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

內部部署 Exchange 才有提供此 Cmdlet。

使用 Set-UMIPGateway 指令程式來修改單一整合通訊 (UM) IP 閘道的組態設定，或是傳回可以在指定 UM IP 閘道上修改的組態設定清單。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

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>]

Description

Set-UMIPGateway 指令程式會修改特定 UM IP 閘道的組態設定，例如 IP 閘道的 IP 位址。這些修改包括允許傳出呼叫，以及控制與已啟用工作階段初始通訊協定 (SIP) 之 IP 專用交換機 (PBX) 或 IP 閘道之間的通訊。

修改 UM IP 閘道設定可能會中斷 Mailbox Server 和已啟用 SIP 的 IP PBX 或 IP 閘道之間的通訊。修改 UM IP 閘道的工作，應該只能由完全了解變更 UM IP 閘道組態之影響的系統管理員來執行。

在這個工作完成後，便會在 UM IP 閘道上設定指定的參數和值。

您必須已獲指派權限，才能執行此指令程式。雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 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

此範例將阻止名為 MyUMIPGateway 的 UM IP 閘道接受來電以及撥出電話、設定 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 參數會指定要顯示或隱藏確認提示。這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。

例如，具破壞性的 Cmdlet (例如 Remove-* Cmdlet) 內建暫停，可強制您在繼續之前確認命令。對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：-Confirm:$false。
其他大部分的 Cmdlet (例如，New-* 和 Set-* Cmdlet) 沒有內建暫停。在使用這些 Cmdlet 時，指定不含任何值的 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 未包含呼叫方與轉接資訊，整合通訊是否應延遲接受由 Voice over 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 參數會指定此 Cmdlet 用來向 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

如果物件是在舊版 Exchange 中建立，則 ForceUpgrade 參數會隱藏出現的確認訊息。您不需要使用此參數指定值。

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 閘道的識別碼。此參數是 UM IP 閘道的目錄物件識別碼。

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 閘道是否會使用第四版網際網路協定 (IPv4)、IPv6 或兩者以通訊。有效值為：

IPv4Only：UM IP 閘道只會使用 IPv4 進行通訊。這是預設值。
IPv6Only：UM IP 閘道只會使用 IPv6。
任何：會先使用 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 IP 閘道，允許 SIP NOTIFY 訊息傳送給與 UM 撥號對應表及 UM IP 閘道相關聯的使用者。預設值為 $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 到 65535。

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 閘道的模擬器。模擬器允許用戶端連接 Mailbox Server。

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

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。

共用方式為