Set-UMIPGateway (RTM)
適用版本： Exchange Server 2007
上次修改主題的時間： 2007-07-12
Set-UMIPGateway 指令程式是用來修改單一整合通訊 (UM) IP 閘道的組態設定，或是傳回可以在特定 UM IP 閘道上修改的組態設定清單。
語法
Set-UMIPGateway -Identity <UMIPGatewayIdParameter> [-Address <UMSmartHost>] [-DomainController <Fqdn>] [-Name <String>] [-OutcallsAllowed <$true | $false>] [-Port <Int32>] [-Simulator <$true | $false>] [-Status <Enabled | Disabled | NoNewCalls>]
Set-UMIPGateway [-Address <UMSmartHost>] [-DomainController <Fqdn>] [-Instance <UMIPGateway>] [-Name <String>] [-OutcallsAllowed <$true | $false>] [-Port <Int32>] [-Simulator <$true | $false>] [-Status <Enabled | Disabled | NoNewCalls>]
詳細描述
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/Private Branch eXchange (PBX) 上設定的 IP 位址。 |
DomainController |
選用 |
Microsoft.Exchange.Data.Fqdn |
若要指定將此組態變更寫入至 Active Directory 目錄服務之網域控制站的網域全名，請在指令程式中加入 DomainController 參數。 |
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 閘道。 |
輸入類型
傳回類型
錯誤
| 錯誤 | 描述 |
|---|---|
|
|
例外狀況
| 例外狀況 | 描述 |
|---|---|
|
|
範例
第一個程式碼範例會修改名稱為 MyUMIPGateway 之 UM IP 閘道的 IP 位址。
第二個程式碼範例會防止 UM IP 閘道接受撥入的呼叫並防止撥出呼叫。
第三個範例會讓 UM IP 閘道作用為 IP/VoIP 模擬器。
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 技術資源中心.