Test-UMConnectivity

參考

模組:: ExchangePowerShell

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

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

使用 Test-UMConnectivity Cmdlet 來測試整合通訊 (UM) 伺服器的作業。

注意：此 Cmdlet 在 Exchange 2010 中效果最佳。在更新版本的 Exchange 中，此 Cmdlet 的功能已由受控可用性取代。為了獲得最佳結果，請使用 Invoke-MonitoringProbe Cmdlet 並指定相關的作用中監視器探查，而不是使用此 Cmdlet。

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

Syntax

Test-UMConnectivity
    -Phone <String>
    -PIN <String>
    -TUILogon <Boolean>
    -UMDialPlan <UMDialPlanIdParameter>
    [-CertificateThumbprint <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ListenPort <Int32>]
    [-MediaSecured <Boolean>]
    [-MonitoringContext <Boolean>]
    [-RemotePort <Int32>]
    [-Secured <Boolean>]
    [-Timeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Test-UMConnectivity
    -Phone <String>
    -UMIPGateway <UMIPGatewayIdParameter>
    [-DiagDtmfDurationInMilisecs <Int32>]
    [-DiagDtmfSequence <String>]
    [-DiagInitialSilenceInMilisecs <Int32>]
    [-DiagInterDtmfDiffGapInMilisecs <String>]
    [-DiagInterDtmfGapInMilisecs <Int32>]
    [-From <String>]
    [-CertificateThumbprint <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ListenPort <Int32>]
    [-MediaSecured <Boolean>]
    [-MonitoringContext <Boolean>]
    [-Secured <Boolean>]
    [-Timeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Test-UMConnectivity
    -ResetPIN <Boolean>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-MonitoringContext <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

Test-UMConnectivity
    -TUILogonAll <Boolean>
    [-CertificateThumbprint <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ListenPort <Int32>]
    [-MediaSecured <Boolean>]
    [-MonitoringContext <Boolean>]
    [-RemotePort <Int32>]
    [-Secured <Boolean>]
    [-Timeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Test-UMConnectivity
    [-CallRouter]
    [-CertificateThumbprint <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ListenPort <Int32>]
    [-MediaSecured <Boolean>]
    [-MonitoringContext <Boolean>]
    [-RemotePort <Int32>]
    [-Secured <Boolean>]
    [-Timeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Description

這兩個診斷測試是設計用於測試信箱伺服器軟體的作業 (模式 1)，以及整個系統 (包括已連線的電話語音元件在內) 的作業 (模式 2)。

Test-UMConnectivity 指令程式可以用於測試 Mailbox Server 和相關已連線電話語音設備的作業。當您執行此指令程式並加入 UMIPGateway 參數時，Mailbox Server 會測試 Mailbox 系統的完整端對端作業。這項測試包括連線到信箱伺服器的電話語音元件，例如 IP 閘道、私人分支 eXchanges (PBX) 和纜線。如果未指定 UMIPGateway 參數，Mailbox Server 只會測試伺服器上安裝與設定的 Mailbox 元件的作業。

當您在內部部署整合通訊部署中執行此 Cmdlet 時，必須為此 Cmdlet 測試的電腦或伺服器建立 UM IP 閘道物件。當您建立 UM IP 閘道物件時，必須為其設定完整網域名稱 (FQDN)，且該 FQDN 必須符合將執行此指令程式的電腦名稱。

這項工作完成後，指令程式就已測試 Mailbox Server 和相關電話語音元件的作業。

您必須已獲指派權限，才能執行此指令程式。雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

Test-UMConnectivity

本範例在本機 Mailbox Server 上執行連線和操作測試，然後顯示 Voice over IP (VoIP) 連線資訊。

範例 2

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

本範例測試本機 Mailbox Server 使用不安全的 TCP 連線 (而非安全的相互 TLS 連線)，使用電話號碼 56780 及透過 UM IP 閘道 MyUMIPGateway 進行通話的能力。

範例 3

Test-UMConnectivity -Phone sip:sipdp.contoso.com@contoso.com -UMIPGateway MyUMIPGateway -Secured $true -From sip:user1@contoso.com -MediaSecured $true

此範例會使用 SIP URI 測試 SIP 撥號對應表。此範例可用於包含 Lync Server 或商務用 Skype Server 的環境中。

參數

-CallRouter

CallRouter 參數會指定是否要在前端) (測試 Microsoft Exchange Unified Messaging Call Router 服務。您不需要使用此參數指定值。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016

-CertificateThumbprint

CertificateThumbprint 參數會指定用於 SIP 保護和安全模式的憑證指紋。

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

-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

-DiagDtmfDurationInMilisecs

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

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

-DiagDtmfSequence

DiagDtmfSequence 參數會指定傳送每一個數字的順序。

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

-DiagInitialSilenceInMilisecs

DiagInitialSilenceInMilisecs 參數會指定在傳送數字順序之前指令程式將暫停的時間 (以毫秒為單位)。

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

-DiagInterDtmfDiffGapInMilisecs

DiagInterDtmfDiffGapInMilisecs 參數會指定是否要自訂診斷順序中各數字相隔的時間。這是可以接受 NULL 項目的逗號分隔清單。這應該包含多個值。

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

-DiagInterDtmfGapInMilisecs

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

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

-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

-From

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

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

-ListenPort

ListenPort 參數會指定要接聽的 IP 通訊埠號碼。如果未指定，則使用 IP 通訊埠 9000。

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

-MediaSecured

MediaSecured 參數會指定要使用安全 RTP 模式還是 RTP (不安全) 模式。

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

-MonitoringContext

MonitoringContext 參數指定是否要在結果中納入相關的監視事件與效能計數器。有效值為：

$true：命令結果中包含監視事件和效能計數器。一般而言，當輸出傳遞至 Microsoft System Center Operations Manager (SCOM) 時，您會在結果中包含監視事件和效能計數器。
$false：監視事件和效能計數器不會包含在命令結果中。這是預設值。

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

-Phone

Phone 參數會指定當重新導向測試電話時要使用的電話號碼或工作階段初始通訊協定 (SIP) 統一資源識別碼 (URI)。應在 PBX 中設定分機號碼，以便將電話轉接至 UM 群組搜尋。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-PIN

PIN 參數會指定與啟用 UM 的信箱關聯的 PIN 碼。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-RemotePort

RemotePort 參數會指定通話使用的通訊埠。如果未指定，預設將通訊埠 5060 用於傳輸控制通訊協定 (TCP)，並且將通訊埠 5061 用於相互傳輸層安全性 (TLS)。

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

-ResetPIN

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-Secured

Secured 參數會指定是否在 SIP 安全模式下執行測試。

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

-Timeout

Timeout 參數會指定要等候測試作業完成的時間長度 (以秒為單位)。預設為 600 秒。您不能以小於 60 秒的值設定此參數。不過，建議您一律將此參數值設為大於或等於 60 秒。此參數的最大值是 1800 秒。

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

-TUILogon

TUILogon 參數會指定是否要讓指令程式嘗試登入一個或多個啟用 UM 的信箱。信箱必須啟用 UM，並與執行 Microsoft Exchange 整合通訊服務的信箱伺服器所屬的 UM 撥號對應表相關聯。預設值是 $false。

Type:	Boolean
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-TUILogonAll

TUILogonAll 參數會指定是否嘗試連線到目前 Active Directory 網站中的所有測試信箱。預設值是 $false。進行測試的帳戶必須是經由呼叫 New-TestCasConnectivityUser.ps1 指令碼所產生，同時對應的信箱必須已啟用 UM。否則，不會採取其他動作。

Type:	Boolean
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-UMDialPlan

UMDialPlan 參數會指定要測試的 UM 撥號對應表。此參數必須與 TUILogon 參數搭配使用。

Type:	UMDialPlanIdParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-UMIPGateway

UMIPGateway 參數會指定用於撥出測試電話的 UM IP 閘道或 IP PBX 名稱。

Type:	UMIPGatewayIdParameter
Position:	Named
Default value:	None
Required:	True
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

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