Set-UMIPGateway
適用版本： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
上次修改主題的時間： 2007-07-17
Set-UMIPGateway 指令程式是用來修改單一整合通訊 (UM) IP 閘道的組態設定，或是傳回可以在特定 UM IP 閘道上修改的組態設定清單。
語法
Set-UMIPGateway -Identity <UMIPGatewayIdParameter> [-Address <UMSmartHost>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Name <String>] [-OutcallsAllowed <$true | $false>] [-Port <Int32>] [-Simulator <$true | $false>] [-Status <Enabled | Disabled | NoNewCalls>] [-WhatIf [<SwitchParameter>]]
Set-UMIPGateway [-Address <UMSmartHost>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Instance <UMIPGateway>] [-Name <String>] [-OutcallsAllowed <$true | $false>] [-Port <Int32>] [-Simulator <$true | $false>] [-Status <Enabled | Disabled | NoNewCalls>] [-WhatIf [<SwitchParameter>]]
詳細描述
Set-UMIPGateway指令程式會修改特定 UM IP 閘道的組態設定，例如 IP 閘道的 IP 位址。這些修改包括允許撥出的電話，以及控制與已啟用工作階段初始通訊協定 (SIP) 之 IP PBX 或 IP 閘道之間的通訊。
.gif "important") 重要事項： |
|---|
| 修改 UM IP 閘道設定可能會中斷 Unified Messaging Server 與已啟用 SIP 之 IP PBX 或 IP 閘道間的通訊。應該只能由徹底了解對 UM IP 閘道進行組態變更含意的系統管理員執行 UM IP 閘道物件的修改。 |
若要執行 Set-UMIPGateway 指令程式，必須對您使用的帳戶委派 Exchange 組織系統管理員角色。
如需管理 Microsoft Exchange Server 2007 所需之權限、委派角色及權利的相關資訊，請參閱權限考量。
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
Microsoft.Exchange.Configuration.Tasks.UMIPGatewayIdParameter |
此參數指定正在修改之 UM IP 閘道的識別碼。此參數是 UM IP 閘道的目錄物件識別碼。 |
Address |
選用 |
Microsoft.Exchange.Data.UMSmartHost |
此參數可指定在 IP 閘道或已啟用 SIP 之 IP/專用交換機 (PBX) 上所設定的 IP 位址。 |
Confirm |
選用 |
System.Management.Automation.SwitchParameter |
此參數會使得命令暫停處理，並要求系統管理員確認命令將進行的動作之後才會繼續處理。預設值為 $true。 |
DomainController |
選用 |
Microsoft.Exchange.Data.Fqdn |
此參數指定將組態變更寫入至 Active Directory 目錄服務之網域控制站的網域全名 (FQDN)。 |
Instance |
選用 |
Microsoft.Exchange.Data.Directory.SystemConfiguration.UMIPGateway |
此參數指定代表新 IP 閘道的輸入參數。 |
Name |
選用 |
System.String |
此參數指定將用於 UM IP 閘道的顯示名稱。此顯示名稱限制在 64 個字元內。 |
OutcallsAllowed |
選用 |
System.Boolean |
此參數指定是否允許這個 IP 閘道物件用於撥出的電話。這不會管理電話轉接。 |
Port |
選用 |
System.Int32 |
這個參數會指定 IP 閘道或 IP PBX 正在接聽的 IP 通訊埠。依預設，此通訊埠為 5060。此參數的範圍為 0 到 65535。 |
Simulator |
選用 |
System.Boolean |
此參數指定將用於所檢視之 UM IP 閘道的模擬器。模擬器允許用戶端連接 Unified Messaging Server。此連線通常用於 Exchange 測試電話應用程式。 |
Status |
選用 |
Microsoft.Exchange.Data.Directory.SystemConfiguration.GatewayStatus |
這個參數會指定是否要啟用或停用 UM IP 閘道。 |
WhatIf |
選用 |
System.Management.Automation.SwitchParameter |
此參數指示命令模擬它將對物件採取的動作。藉由使用 WhatIf 參數的方式，系統管理員不需實際套用變更，就能先檢視任何變更。預設值為 $true。 |
輸入類型
傳回類型
錯誤
| 錯誤 | 描述 |
|---|---|
|
|
例外狀況
| 例外狀況 | 描述 |
|---|---|
|
|
範例
第一個程式碼範例會修改名稱為 MyUMIPGateway 之 UM IP 閘道的 IP 位址。
第二個程式碼範例會防止 UM IP 閘道接受撥入的呼叫並防止撥出呼叫。
第三個範例會使 UM IP 閘道可當成 IP 閘道模擬器使用，並且能與 Test-UMConnectivity 指令程式或 Exchange 整合通訊測試電話應用程式搭配使用。
Set-UMIPGateway -Identity MyUMIPGateway -Address 10.10.10.1
Set-UMIPGateway -Identity MyUMIPGateway -Address 10.10.10.1 -Status 2 -OutcallsAllowed $false
Set-UMIPGateway -Identity MyUMIPGateway -Simulator $true
若要確保您目前閱讀的是最新資訊，並尋找其他的 Exchange Server 2007 說明文件，請造訪 Exchange Server 技術資源中心.