Set-UMIPGateway

內部部署 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

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