Test-EcpConnectivity
內部部署 Exchange 才有提供此 Cmdlet。
使用 Test-EcpConnectivity Cmdlet 測試與 Exchange 控制台 (ECP) 虛擬目錄的連線能力。
注意：此 Cmdlet 在 Exchange 2010 中效果最佳。 在較新版本的 Exchange 中，此 Cmdlet 的功能會由「受管理可用性」取代。 為了達得最佳結果，請使用 Invoke-MonitoringProbe Cmdlet，並指定相關的主動監視器探查，而不要使用此 Cmdlet。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
Test-EcpConnectivity
[[-ClientAccessServer] <ServerIdParameter>]
[-Confirm]
[-DomainController <Fqdn>]
[-LightMode]
[-MailboxServer <ServerIdParameter>]
[-MonitoringContext]
[-ResetTestAccountCredentials]
[-RSTEndpoint <String>]
[-TestType <OwaConnectivityTestType>]
[-Timeout <UInt32>]
[-TrustAnySSLCertificate]
[-VirtualDirectoryName <String>]
[-WhatIf]
[<CommonParameters>]
Description
Test-EcpConnectivity Cmdlet 會連線到指定的 EAC 虛擬目錄、指定 Exchange 伺服器上的任何 EAC 虛擬目錄，或本機 Active Directory 站台中可用的任何 EAC 虛擬目錄，藉此測試 EAC 連線能力。
第一次使用此指令程式時，您可能需要建立測試使用者。 若要建立測試使用者，請執行下列命令：
& $env:ExchangeInstallPath\Scripts\New-TestCasConnectivityUser.ps1
測試結果會顯示在螢幕上。 此 Cmdlet 傳回下列結果：
- CasServer：用戶端連線的 Exchange 伺服器。
- LocalSite：本機 Active Directory 網站的名稱。
- 案例：測試的作業。 值為：登入和登入。
- 結果：傳回的值通常是 Success、Skipped 或 Failure。
- MS) (延遲：完成測試所需的時間，以毫秒為單位。
- 錯誤：發生的任何錯誤訊息。
您可以透過管道將輸出傳送至 ConvertTo-Html 和 Set-Content，將結果寫入檔案。 例如：Test-EcpConnectivity -ClientAccessServer MBX01 | ConvertTo-Html | Set-Content -Path "C:\My Documents\EAC Test.html"。
您必須已獲指派權限，才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數，但如果指派給您的權限中未包含某些參數，您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Test-EcpConnectivity -ClientAccessServer Server01
此範例測試使用者與 Server01 上 Exchange 系統管理中心的連線能力。
參數
-ClientAccessServer
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
ClientAccessServer 參數會指定要測試的 Exchange 伺服器。 此伺服器已安裝用戶端存取伺服器角色，並負責接受用戶端連線。
您可以使用唯一識別伺服器的任何值。 例如：
- 名稱
- 辨別名稱 (DN)
- ExchangeLegacyDN
- GUID
參數屬性
| 類型: | ServerIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Confirm
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
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 |
-DomainController
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如，dc01.contoso.com。
參數屬性
| 類型: | Fqdn |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-LightMode
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此診斷命令未實作此參數。 使用這個參數不會變更命令的行為。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MailboxServer
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
MailboxServer 參數可指定您要測試的 Exchange 信箱伺服器。 此參數會識別接受來自用戶端連線之前端伺服器的 Proxy 連線的後端伺服器。
MailboxServer 參數會指定要測試的 exExchange2k16 或 exExchange2k13 信箱伺服器名稱。 例如：
- 名稱
- 辨別名稱 (DN)
- ExchangeLegacyDN
- GUID
如果不使用此參數，則會測試與本機 Active Directory 站台中所有信箱伺服器的連線。
參數屬性
| 類型: | ServerIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MonitoringContext
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
MonitoringContext 參數在結果中會納入相關的監視事件與效能計數器。 您不需要使用此參數指定值。
通常，當輸出傳遞至 System Center Operations Manager Microsoft (SCOM) 時，您會在結果中包含監視事件和效能計數器。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ResetTestAccountCredentials
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
ResetTestAccountCredentials 參數會針對用來執行此命令的測試帳戶重設密碼。 您不需要使用此參數指定值。
通常每 7 天就會重設一次測試帳戶的密碼。 使用此參數，可隨時基於安全性理由來強制重設密碼。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RSTEndpoint
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-TestType
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
TestType 參數會指定命令是測試內部 URL 還是外部 URL。 值為 Internal 和 External。 預設值為 Internal。
參數屬性
| 類型: | OwaConnectivityTestType |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Timeout
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Timeout 參數會指定要等候測試作業完成的時間量 (以秒為單位)。 Timeout 參數的預設值為 30 秒。 您必須指定大於 0 秒且小於 1 小時 (3,600 秒) 逾時值。 建議您一律將此參數設定為 5 秒或以上的值。
參數屬性
| 類型: | UInt32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-TrustAnySSLCertificate
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
TrustAnySSLCertificate 參數允許 Exchange 接受來自不受信任的憑證授權單位 (CA) 的憑證。 您不需要使用此參數指定值。
TrustAnySSLCertificate 參數會指定是否要忽略安全通訊端層 (SSL) 憑證驗證失敗。 您不需要指定此參數的值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-VirtualDirectoryName
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
VirtualDirectoryName 參數會指定您想要測試之 EAC 虛擬目錄的名稱。 以雙引號 (") 括住含有空格的值。
如果不使用此參數，則會測試所有可用的 EAC 虛擬目錄。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
WhatIf 參數會顯示命令在不進行任何變更的情況下執行的動作。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | WI |
參數集
(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
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。