Test-UMConnectivity

  • 發行項

 

適用版本： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上次修改主題的時間： 2008-01-30

Test-UMConnectivity 指令程式可以用來測試已安裝 Unified Messaging server role 之電腦的作業。

語法

test-UMConnectivity [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Fax <$true | $false>] [-ListenPort <Int32>] [-MediaSecured <$true | $false>] [-MonitoringContext <$true | $false>] [-RemotePort <Int32>] [-Secured <$true | $false>] [-Timeout <Int32>] [-WhatIf [<SwitchParameter>]]

test-UMConnectivity -TUILogonAll <$true | $false> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ListenPort <Int32>] [-MediaSecured <$true | $false>] [-MonitoringContext <$true | $false>] [-RemotePort <Int32>] [-Secured <$true | $false>] [-Timeout <Int32>] [-WhatIf [<SwitchParameter>]]

test-UMConnectivity -ResetPIN <$true | $false> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>] [-WhatIf [<SwitchParameter>]]

test-UMConnectivity -Phone <String> -UMIPGateway <UMIPGatewayIdParameter> [-Confirm [<SwitchParameter>]] [-DiagDtmfDurationInMilisecs <Int32>] [-DiagDtmfSequence <String>] [-DiagInitialSilenceInMilisecs <Int32>] [-DiagInterDtmfDiffGapInMilisecs <String>] [-DiagInterDtmfGapInMilisecs <Int32>] [-DomainController <Fqdn>] [-Fax <$true | $false>] [-From <String>] [-ListenPort <Int32>] [-MediaSecured <$true | $false>] [-MonitoringContext <$true | $false>] [-Secured <$true | $false>] [-Timeout <Int32>] [-WhatIf [<SwitchParameter>]]

test-UMConnectivity -Phone <String> -PIN <String> -TUILogon <$true | $false> -UMDialPlan <UMDialPlanIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ListenPort <Int32>] [-MediaSecured <$true | $false>] [-MonitoringContext <$true | $false>] [-RemotePort <Int32>] [-Secured <$true | $false>] [-Timeout <Int32>] [-WhatIf [<SwitchParameter>]]

詳細描述

這兩個診斷測試是設計來測試 Microsoft Exchange Server 2007 Unified Messaging Server 軟體的作業 (模式 1)，以及整個系統 (包括已連線的電話語音元件在內) 的作業 (模式 2)。

Test-UMConnectivity 指令程式可以用來測試 Unified Messaging (UM) Server 和相關已連線的電話語音設備的作業。當系統管理員執行此指令程式並加入 UMIPGateway 參數時，Unified Messaging Server 會測試 UM 系統的完整端對端作業。這包括連接到 Unified Messaging Server 的電話語音元件，例如 IP 閘道、專用交換機 (PBX) 和佈線。若不指定 IPGateway 參數，Unified Messaging Server 只會測試伺服器上安裝與設定的 UM 元件作業。

若要執行 Test-UMConnectivity 指令程式，您使用的帳戶必須已委派 Exchange Server 系統管理員角色及目標伺服器的本機 Administrators 群組。

如需管理 Exchange 2007 所需之權限、委派角色及權利的相關資訊，請參閱權限考量。

參數

參數 必要 類型 描述

Phone

必要

System.String

此參數可指定當重新導向測試電話時要使用的電話號碼或 SIP URI。應在 PBX 中設定分機號碼以轉接至 UM 群組搜尋。

PIN

必要

System.String

此參數可讓您指定與啟用 UM 的信箱關聯的 PIN 碼。

ResetPIN

必要

System.Boolean

此參數可指定要為目前網站的所有測試信箱產生或重新產生新的 PIN。

TUILogon

必要

System.Boolean

此參數可指定是否要讓指令程式嘗試登入一或多個啟用 UM 的信箱。信箱必須啟用 UM，並與 Unified Messaging Server 所屬的 UM 撥號對應表關聯。預設設定是 false。

TUILogonAll

必要

System.Boolean

此參數可指定是否要測試目前 Active Directory 網站的所有信箱，再測試每個啟用 UM 的信箱連線。預設設定是 false。

UMDialPlan

必要

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

此參數可指定將測試的 UM 撥號對應表。它必須與 TUILogin 參數搭配使用。

UMIPGateway

必要

Microsoft.Exchange.Configuration.Tasks.UMIPGatewayIdParameter

此參數指定用於外送測試電話的 UM IP 閘道或 IP PBX 的名稱。

Confirm

選用

System.Management.Automation.SwitchParameter

此參數會使得命令暫停處理，並要求您確認命令將進行的動作之後才會繼續處理。預設值為 $true。

DiagDtmfDurationInMilisecs

選用

System.Int32

此參數指定傳送每一個數字的持續時間。

DiagDtmfSequence

選用

System.String

此參數指定所傳送的數字順序。

DiagInitialSilenceInMilisecs

選用

System.Int32

此參數指定在傳送數字順序之前指令程式將暫停的時間 (毫秒)。

DiagInterDtmfDiffGapInMilisecs

選用

System.String

此參數用來自訂診斷順序中各數字相隔的時間。這是可以接受 NULL 項目的清單，以逗號區隔。這應該包含多個值。

DiagInterDtmfGapInMilisecs

選用

System.Int32

此參數指定在數字順序中傳送的每一個數字相隔的時間 (以毫秒為單位)。這是單一值。

DomainController

選用

Microsoft.Exchange.Data.Fqdn

此參數指定將組態變更寫入至 Active Directory 目錄服務之網域控制站的網域全名 (FQDN)。

Fax

選用

System.Boolean

此參數指定測試的電話是傳真電話。預設值是 $true。

From

選用

System.String

此參數會指定發出通話的 SIP URI 或 SIP 位址。它只能在使用 -Phone 參數時使用。預設值是當您在使用 -Phone 參數時指定的 SIP URI。

ListenPort

選用

System.Int32

此參數可指定要在其上接聽的 IP 通訊埠號碼。如果未指定，則使用 IP 通訊埠 9000。

MediaSecured

選用

System.Boolean

此參數指定要使用安全 RTP 或不安全模式。

MonitoringContext

選用

System.Boolean

此參數指定是否會在命令列執行指令程式，或是否將輸出物件傳遞至 Microsoft Operations Manager。依預設，指令程式會從命令列執行。

RemotePort

選用

System.Int32

此參數指定要用於呼叫的通訊埠。如果未指定，預設值是通訊埠 5060 (若為 TCP) 及 5061 (若為 MTLS)。

Secured

選用

System.Boolean

此參數指定是否以安全模式執行測試。

Timeout

選用

System.Int32

此參數可指定要等候測試作業完成的時間長度 (以秒為單位)。預設為 180 秒。您可以小於 5 秒的值設定此參數。但建議您一律將此參數值設為大於或等於 5 秒。

WhatIf

選用

System.Management.Automation.SwitchParameter

此參數指示命令模擬它將對物件採取的動作。使用 WhatIf 參數，則不需要套用任何變更，就能檢視變更。預設值為 $true。

輸入類型

傳回類型

錯誤

錯誤 描述

 

 

例外狀況

例外狀況 描述

 

 

範例

第一個範例會在本機 Unified Messaging Server 上執行連線和操作測試，然後顯示 VoIP 連線資訊。

第二個範例會測試本機 Unified Messaging Server 使用不安全的傳輸控制通訊協定 (TCP) 連線 (而非安全的交互傳輸層安全性 (MTLS) 連線)，使用電話號碼 56780 及透過名為 MyUMIPGateway 的 UM IP 閘道進行呼叫的能力。

第三個範例會使用 SIP URI，測試撥號對應表上的使用者存取號碼。此範例可用於包含 Microsoft Office Communications Server 2007 的環境。

第四個範例會使用 SIP URI 測試自動語音應答。此範例可用於包含 Communications Server 2007 的環境。

Test-UMConnectivity

Test-UMConnectivity -UMIPGateway MyUMIPGateway -Phone 56780 -Secured $false

Test-UMConnectivity -UMIPGateway OCSGateway1 -Phone "sip:SIPdialplan.contoso.com@contoso.com"

Test-UMConnectivity -UMIPGateway OCSGateway1 -Phone "sip:SIPAutoAttendant.SIPDialPlan.contoso.com@contoso.com"

若要確保您目前閱讀的是最新資訊，並尋找其他的 Exchange Server 2007 說明文件，請造訪 Exchange Server 技術資源中心.