Test-UMConnectivity
內部部署 Exchange 才有提供此 Cmdlet。
使用 Test-UMConnectivity Cmdlet 來測試整合通訊 (UM) 伺服器的作業。
注意：此 Cmdlet 在 Exchange 2010 中效果最佳。 在更新版本的 Exchange 中，此 Cmdlet 的功能會由受控可用性取代。 為了獲得最佳結果，請使用 Invoke-MonitoringProbe Cmdlet 並指定相關的作用中監視器探查，而不是使用此 Cmdlet。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
TuiLogonSpecific
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>]
EndToEnd
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>]
PinReset
Test-UMConnectivity
-ResetPIN <Boolean>
[-Confirm]
[-DomainController <Fqdn>]
[-MonitoringContext <Boolean>]
[-WhatIf]
[<CommonParameters>]
TuiLogonGeneral
Test-UMConnectivity
-TUILogonAll <Boolean>
[-CertificateThumbprint <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-ListenPort <Int32>]
[-MediaSecured <Boolean>]
[-MonitoringContext <Boolean>]
[-RemotePort <Int32>]
[-Secured <Boolean>]
[-Timeout <Int32>]
[-WhatIf]
[<CommonParameters>]
LocalLoop
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 必須符合將執行此指令程式的電腦名稱。
完成這項工作之後，Cmdlet 會測試信箱伺服器和相關電話語音元件的作業。
您必須已獲指派權限，才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數，但如果某些參數未包含在指派給您的許可權中，您可能無法存取這些參數。 若要尋找在組織中執行任何 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
適用：Exchange Server 2013 Exchange Server 2016 年
CallRouter 參數會指定是否要在前端) (測試 Microsoft Exchange Unified Messaging Call Router 服務。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
LocalLoop
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-CertificateThumbprint
適用：Exchange Server 2010 Exchange Server 2013 Exchange Server 2016
CertificateThumbprint 參數會指定用於 SIP 保護和安全模式的憑證指紋。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
TuiLogonSpecific
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
EndToEnd
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
TuiLogonGeneral
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
LocalLoop
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
適用：Exchange Server 2010 Exchange Server 2013 Exchange Server 2016
Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。
- 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停，它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：
-Confirm:$false。
- 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 在使用這些 Cmdlet 時，指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。
參數屬性
| 類型: | SwitchParameter
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | cf |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DiagDtmfDurationInMilisecs
適用：Exchange Server 2010 Exchange Server 2013 Exchange Server 2016
DiagDtmfDurationInMilisecs 參數會指定傳送每一個數字的持續時間。
參數屬性
| 類型: | Int32
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
EndToEnd
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DiagDtmfSequence
適用：Exchange Server 2010 Exchange Server 2013 Exchange Server 2016
DiagDtmfSequence 參數會指定傳送每一個數字的順序。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
EndToEnd
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DiagInitialSilenceInMilisecs
適用：Exchange Server 2010 Exchange Server 2013 Exchange Server 2016
DiagInitialSilenceInMilisecs 參數會指定在傳送數字順序之前指令程式將暫停的時間 (以毫秒為單位)。
參數屬性
| 類型: | Int32
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
EndToEnd
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DiagInterDtmfDiffGapInMilisecs
適用：Exchange Server 2010 Exchange Server 2013 Exchange Server 2016
DiagInterDtmfDiffGapInMilisecs 參數會指定是否要自訂診斷順序中各數字相隔的時間。 這是可以接受 NULL 項目的逗號分隔清單。 這應該包含多個值。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
EndToEnd
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DiagInterDtmfGapInMilisecs
適用：Exchange Server 2010 Exchange Server 2013 Exchange Server 2016
DiagInterDtmfGapInMilisecs 參數會指定在數字順序中傳送的每一個數字相隔的時間 (以毫秒為單位)。 這是單一值。
參數屬性
| 類型: | Int32
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
EndToEnd
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DomainController
適用：Exchange Server 2010 Exchange Server 2013 Exchange Server 2016
DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如，dc01.contoso.com。
參數屬性
| 類型: | Fqdn
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-From
適用：Exchange Server 2010 Exchange Server 2013 Exchange Server 2016
From 參數會指定撥出通話的 SIP URI 或 SIP 位址。 它只能在使用 Phone 參數時使用。 預設值是當您在使用 Phone 參數時指定的 SIP URI。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
EndToEnd
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ListenPort
適用：Exchange Server 2010 Exchange Server 2013 Exchange Server 2016
ListenPort 參數會指定要接聽的 IP 通訊埠號碼。 如果未指定，則使用 IP 通訊埠 9000。
參數屬性
| 類型: | Int32
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
TuiLogonSpecific
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
EndToEnd
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
TuiLogonGeneral
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
LocalLoop
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
適用：Exchange Server 2010 Exchange Server 2013 Exchange Server 2016
MediaSecured 參數會指定要使用安全 RTP 模式還是 RTP (不安全) 模式。
| 類型: | Boolean
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
TuiLogonSpecific
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
EndToEnd
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
TuiLogonGeneral
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
LocalLoop
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MonitoringContext
適用：Exchange Server 2010 Exchange Server 2013 Exchange Server 2016
MonitoringContext 參數指定是否要在結果中納入相關的監視事件與效能計數器。 有效值為：
- $true：命令結果中包含監視事件和性能計數器。 一般而言，當輸出傳遞至 Microsoft System Center Operations Manager (SCOM) 時，您會在結果中包含監視事件和性能計數器。
- $false：監視事件和性能計數器不會包含在命令結果中。 此值為預設值。
參數屬性
| 類型: | Boolean
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Phone
適用：Exchange Server 2010 Exchange Server 2013 Exchange Server 2016
Phone 參數會指定當重新導向測試電話時要使用的電話號碼或工作階段初始通訊協定 (SIP) 統一資源識別碼 (URI)。 應在 PBX 中設定分機號碼，以便將電話轉接至 UM 群組搜尋。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
TuiLogonSpecific
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
EndToEnd
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PIN
適用：Exchange Server 2010 Exchange Server 2013 Exchange Server 2016
PIN 參數會指定與啟用 UM 的信箱關聯的 PIN 碼。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
TuiLogonSpecific
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RemotePort
適用：Exchange Server 2010 Exchange Server 2013 Exchange Server 2016
RemotePort 參數會指定通話使用的通訊埠。 如果未指定，預設將通訊埠 5060 用於傳輸控制通訊協定 (TCP)，並且將通訊埠 5061 用於相互傳輸層安全性 (TLS)。
參數屬性
| 類型: | Int32
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
TuiLogonSpecific
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
TuiLogonGeneral
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
LocalLoop
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ResetPIN
適用：Exchange Server 2010 Exchange Server 2013 Exchange Server 2016
ResetPIN 參數會指定要為目前網站的所有測試信箱產生或重新產生新的 PIN 碼。
參數屬性
| 類型: | Boolean
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
PinReset
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Secured
適用：Exchange Server 2010 Exchange Server 2013 Exchange Server 2016
Secured 參數會指定是否在 SIP 安全模式下執行測試。
參數屬性
| 類型: | Boolean
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
TuiLogonSpecific
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
EndToEnd
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
TuiLogonGeneral
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
LocalLoop
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Timeout
適用：Exchange Server 2010 Exchange Server 2013 Exchange Server 2016
Timeout 參數會指定要等候測試作業完成的時間長度 (以秒為單位)。 預設為 600 秒。 您不能以小於 60 秒的值設定此參數。 不過，建議您一律將此參數值設為大於或等於 60 秒。 此參數的最大值是 1800 秒。
參數屬性
| 類型: | Int32
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
TuiLogonSpecific
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
EndToEnd
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
TuiLogonGeneral
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
LocalLoop
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-TUILogon
適用：Exchange Server 2010 Exchange Server 2013 Exchange Server 2016
TUILogon 參數會指定是否要讓指令程式嘗試登入一個或多個啟用 UM 的信箱。 信箱必須啟用UM且與執行 Microsoft Exchange Unified Messaging 服務的信箱伺服器所屬的 UM 撥號對應表相關聯。 預設值是 $false。
參數屬性
| 類型: | Boolean
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
TuiLogonSpecific
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-TUILogonAll
適用：Exchange Server 2010 年 Exchange Server 2013 Exchange Server 2016 年
TUILogonAll 參數會指定是否嘗試連線到目前 Active Directory 網站中的所有測試信箱。 預設值是 $false。 進行測試的帳戶必須是經由呼叫 New-TestCasConnectivityUser.ps1 指令碼所產生，同時對應的信箱必須已啟用 UM。 否則，不會採取其他動作。
參數屬性
| 類型: | Boolean
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
TuiLogonGeneral
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-UMDialPlan
適用：Exchange Server 2010 年 Exchange Server 2013 Exchange Server 2016 年
UMDialPlan 參數會指定要測試的 UM 撥號對應表。 此參數必須與 TUILogon 參數搭配使用。
參數屬性
| 類型: | UMDialPlanIdParameter
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
TuiLogonSpecific
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-UMIPGateway
適用：Exchange Server 2010 年 Exchange Server 2013 Exchange Server 2016 年
UMIPGateway 參數會指定用於撥出測試電話的 UM IP 閘道或 IP PBX 名稱。
參數屬性
| 類型: | UMIPGatewayIdParameter
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
EndToEnd
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
適用：Exchange Server 2010 年 Exchange Server 2013 Exchange Server 2016 年
WhatIf 參數會模擬命令的動作。 使用此參數時，您不需要實際套用變更即可檢視可能會發生的變更。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 無線 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
Input types
若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。