Test-OwaConnectivity

參考

模組:: ExchangePowerShell

適用於:: Exchange Server 2010

此 Cmdlet 僅適用于 2010 Exchange Server。

使用 Test-OwaConnectivity Cmdlet 來確認Microsoft Office Outlook Web App如預期般執行。 Test-OwaConnectivity Cmdlet 可用來測試指定用戶端存取伺服器上所有Microsoft Exchange Server 2010 虛擬目錄的連線Outlook Web App，適用于在相同 Active Directory 月臺中執行 Exchange 之伺服器上的所有信箱。 Test-OwaConnectivity Cmdlet 也可以用來測試個別 Exchange Outlook Web App URL 的連線能力。

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

Syntax

Test-OwaConnectivity
    [-URL] <String>
    -MailboxCredential <PSCredential>
    [-AllowUnsecureAccess]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-LightMode]
    [-ResetTestAccountCredentials]
    [-Timeout <UInt32>]
    [-TrustAnySSLCertificate]
    [-WhatIf]
    [<CommonParameters>]

Test-OwaConnectivity
    [[-ClientAccessServer] <ServerIdParameter>]
    [-MailboxServer <ServerIdParameter>]
    [-MonitoringContext]
    [-RSTEndpoint <String>]
    [-TestType <OwaConnectivityTestType>]
    [-VirtualDirectoryName <String>]
    [-AllowUnsecureAccess]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-LightMode]
    [-ResetTestAccountCredentials]
    [-Timeout <UInt32>]
    [-TrustAnySSLCertificate]
    [-WhatIf]
    [<CommonParameters>]

Description

Test-OwaConnectivity Cmdlet 會測試用戶端存取伺服器上所有 Exchange Outlook Web App 虛擬目錄的連線，或測試單一 Exchange Outlook Web App URL 的連線能力。

若要測試用戶端存取伺服器上的所有 Exchange Outlook Web App虛擬目錄，必須要有測試 Active Directory 帳戶。每個 Active Directory 網站中也必須有一個測試信箱，該信箱裝載的信箱可透過所測試的虛擬目錄存取。如果在信箱伺服器安裝期間未建立測試環境，系統會提示您執行腳本，以在您執行 Test-OwaConnectivity Cmdlet 時建立測試信箱和測試使用者。

如果無法使用裝載測試信箱的伺服器，Test-OwaConnectivity Cmdlet 會傳回可能無法清楚識別問題的錯誤。若要避免這種情況，請先確認裝載測試信箱的伺服器正在執行，而且信箱在您執行 Test-OwaConnectivity Cmdlet 之前可供使用。您可以使用 Test-MapiConnectivity Cmdlet 來執行此動作。

如果您在 Client Access 伺服器上執行 Test-OwaConnectivity Cmdlet，而不使用 ClientAccessServer 參數或 URL 參數，此 Cmdlet 會測試您執行 Cmdlet 的伺服器。若要測試特定的用戶端存取伺服器，請使用 ClientAccessServer 參數。

若要測試單一 URL，請使用 URL 參數和現有 Exchange 信箱的認證來執行 Test-OwaConnectivity Cmdlet。如果 URL 位於負載平衡器後方，您就無法預測命令將測試哪個 Client Access 伺服器。因為當您使用 URL 參數時，需要認證作為參數的一部分，所以當您使用 URL 參數時，可以使用任何帳戶來執行Test-OwaConnectivity Cmdlet。

如果命令遇到不需要安全通訊端層 (SSL) 的虛擬目錄，除非使用 AllowUnsecureAccess 參數，否則命令會略過該目錄。如果使用 AllowUnsecureAccess 參數，伺服器之間的通訊會以純文字傳送，以供測試之用。

Test-OwaConnectivity Cmdlet 可以做為一次性互動式工作，或在 System Center Operations Manager 2007 控制項Microsoft排程工作執行。若要以 System Center Operations Manager 2007 工作執行 Test-OwaConnectivity Cmdlet，Cmdlet 所測試的信箱伺服器上必須提供用戶端存取測試信箱。

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

範例

範例 1

Test-OwaConnectivity -URL:https://mail.contoso.com/owa -MailboxCredential:(get-credential contoso\kweku)

此範例會使用使用者 contoso\kweku 的認證來測試 URL https://mail.contoso.com/owa 的連線能力。

範例 2

Test-OwaConnectivity -ClientAccessServer:Contoso12 -AllowUnsecureAccess

此範例會測試特定用戶端存取伺服器 Contoso12 的連線能力，並測試所有支援 Exchange 信箱的 Exchange Outlook Web App虛擬目錄。其中包括不需要 SSL 的虛擬目錄。

參數

-AllowUnsecureAccess

AllowUnsecureAccess 參數會指定是否測試不需要 SSL 的虛擬目錄。您不需要使用此參數指定值。

如果您未使用此參數，此命令會略過不需要 SSL 的虛擬目錄，並產生錯誤。

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

-ClientAccessServer

此參數僅適用于 2010 Exchange Server

ClientAccessServer 參數會指定要測試的用戶端存取伺服器名稱。如果包含此參數，用戶端存取伺服器上的所有 Exchange Outlook Web App虛擬目錄都會針對本機 Active Directory 網站中的所有 Exchange 信箱伺服器進行測試。

請勿將此參數與 URL 參數搭配使用。

Type:	ServerIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-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

-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

-LightMode

此診斷命令未實作 LightMode 參數。使用此參數並不會變更命令的行為。

此參數會針對用來執行較不密集版本命令的其他 Exchange 診斷命令實作。

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

-MailboxCredential

MailboxCredential 參數會指定單一 URL 測試的信箱認證。

此參數的值需要使用 Get-Credential Cmdlet。若要暫停此命令並收到輸入認證的提示，請使用值 (Get-Credential)。或者，在您執行此命令之前，將認證儲存在變數中 (例如，$cred = Get-Credential)，然後將變數名稱 ($cred) 用於此參數。如需詳細資訊，請參閱 Get-Credential。

只有在使用 URL 參數時，才需要 MailboxCredential 參數。

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

-MailboxServer

MailboxServer 參數會指定要測試的信箱伺服器名稱。如果未指定，則會測試本機 Active Directory 網站中的所有信箱伺服器。

Type:	ServerIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MonitoringContext

MonitoringContext 參數在結果中會納入相關的監視事件與效能計數器。您不需要使用此參數指定值。

一般而言，當輸出傳遞至 Microsoft System Center Operations Manager (SCOM) 時，您會在結果中包含監視事件和效能計數器。

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

-ResetTestAccountCredentials

ResetTestAccountCredentials 參數會針對用來執行此命令的測試帳戶重設密碼。您不需要使用此參數指定值。

通常每 7 天就會重設一次測試帳戶的密碼。使用此參數，可隨時基於安全性理由來強制重設密碼。

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

-RSTEndpoint

將保留此參數供 Microsoft 內部使用。

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

-TestType

TestType 參數會指定命令是測試內部 URL 還是外部 URL。值為 Internal 和 External。您無法搭配 URL 參數使用此參數。當未指定 TestType 參數或 URL 參數時，預設值為 TestType：Internal。

Type:	OwaConnectivityTestType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Timeout

Timeout 參數會指定要等候測試作業完成的時間量 (以秒為單位)。 Timeout 參數的預設值為 30 秒。您必須指定大於 0 秒且小於 1 小時的逾時值， (3，600 秒) 。我們建議您一律以 5 秒或以上的值來設定此參數。

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-TrustAnySSLCertificate

TrustAnySSLCertificate 參數可讓 Exchange 接受來自不受信任憑證授權單位單位的憑證， (CA) 。您不需要使用此參數指定值。

TrustAnySSLCertificate 參數會指定是否要忽略安全通訊端層 (SSL) 憑證驗證失敗。您不需要指定此參數的值。

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

-URL

URL 參數會指定要測試的 URL。只有當您想要測試單一Outlook Web App URL 時，才需要此參數。

如果使用此參數，也需要 MailboxCredential 參數。

您無法搭配 TestType 或 ClientAccessServer 參數使用 URL 參數。

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

-VirtualDirectoryName

VirtualDirectoryName 參數會指定要在特定用戶端存取伺服器上測試的虛擬目錄名稱。如果未包含此參數，則會測試所有支援 Exchange 信箱的 Exchange Outlook Web App虛擬目錄。

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

-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

輸入

Input types

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

輸出

Output types

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