Test-OwaConnectivity

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

上次修改主題的時間： 2010-08-18

使用 Test-OwaConnectivity 指令程式可驗證 Microsoft Office Outlook Web Access 是否如預期般執行。Test-OwaConnectivity 指令程式可針對位於同一個 Active Directory 站台中之 Exchange 2007 伺服器上的所有信箱，測試指定之 Client Access Server 上所有 Microsoft Exchange 2007 虛擬目錄的 Outlook Web Access 連線。Test-OwaConnectivity 也可用於測試個別 Exchange 2007 Outlook Web Access URL 的連線。

語法

Test-OwaConnectivity [-ClientAccessServer <ServerIdParameter>] [-AllowUnsecureAccess <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-LightMode <SwitchParameter>] [-MailboxServer <ServerIdParameter>] [-MonitoringContext <SwitchParameter>] [-ResetTestAccountCredentials <SwitchParameter>] [-Site <AdSiteIdParameter>] [-TestType <Internal | External>] [-Timeout <UInt32>] [-TrustAnySSLCertificate <SwitchParameter>] [-VirtualDirectoryName <String>] [-WhatIf [<SwitchParameter>]]

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

詳細描述

Test-OwaConnectivity 指令程式可以用來測試 Client Access Server 上所有 Exchange 2007 Outlook Web Access 虛擬目錄的連線，或測試單一 Exchange 2007 Outlook Web Access URL 的連線。

若要測試 Client Access Server 上的所有 Exchange 2007 Outlook Web Access 虛擬目錄，則必須要有測試 Active Directory 帳戶。安裝了 Mailbox server role 的每一個 Exchange 2007 伺服器上，也必須要有一個能透過受測之虛擬目錄存取的測試信箱。您可以在 Mailbox Server 安裝的步驟過程中建立測試帳戶及測試信箱。如果未在 Mailbox Server 安裝期間建立測試環境，系統將在您執行 Test-OwaConnectivity 指令程式時，提示您執行可建立測試信箱及測試使用者的指令碼。

如果無法使用主控測試信箱的伺服器，Test-OWAConnectivity 指令程式會傳回錯誤，這個錯誤可能無法清楚地識別問題。為了避免這種情形，請在執行 Test-OWAConnectivity 指令程式之前，檢查確定主控的測試信箱正在執行，而且信箱可以使用。

如果您在 Client Access Server 上執行 Test-OwaConnectivity 指令程式，而沒有使用 ClientAccessServer 參數或 URL 參數，則指令程式將會測試您執行指令程式所在的伺服器。若要測試特定的 Client Access Server，請使用 ClientAccessServer 參數。

若要執行 Test-OwaConnectivity 指令程式以測試 Client Access Server 上所有 Exchange 2007 虛擬目錄的 Outlook Web Access 連線，您使用的帳戶必須得到目標伺服器上之 Exchange Server 系統管理員角色和本機 Administrators 群組中之成員資格的委派。

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

若要測試單一 URL，請針對現有的 Exchange 2007 信箱執行含有 URL 參數及認證的 Test-OwaConnectivity。該 URL 若位在負載平衡器的後方，您將無法預測此指令程式將測試的 Client Access Server。因為在您使用 URL 參數時，認證是參數必要的一部分，所以您可以在使用 URL 參數時使用任何帳戶執行 Test-OwaConnectivity。

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

Test-OwaConnectivity 指令程式可以當成只執行一次的互動式工作執行，或作為受 Microsoft Operations Manager (MOM) 控制的排程工作執行。若要將 Test-OwaConnectivity 當成 MOM 工作來執行，則指令程式要測試的 Mailbox Server 上，必須可以使用用戶端存取的測試環境。

參數

參數	必要	類型	描述
AllowUnsecureAccess	選用	System.Management.Automation.SwitchParameter	若包含此參數，參數可啟用不需要測試 SSL 的虛擬目錄。若不包含此參數，則工作會略過不需要 SSL 的虛擬目錄，並產生錯誤。
ClientAccessServer	選用	Microsoft.Exchange.Configuration.Tasks.ServerIdParameter	此參數可指定要測試的 Client Access Server 名稱。如果包含此參數，Client Access Server 上的所有 Exchange 2007 Outlook Web Access 虛擬目錄，將會針對本機 Active Directory 站台的所有 Exchange 2007 Mailbox Server 進行測試。但不會測試 Microsoft Exchange 2000 Server 及 Microsoft Exchange Server 2003 虛擬目錄。也不會測試不在 Exchange 2007 Mailbox Server 上的信箱。此參數請勿搭配 URL 參數使用。
Confirm	選用	System.Management.Automation.SwitchParameter	Confirm 參數會使得命令暫停處理，並要求確認命令將進行的動作之後才會繼續處理。您不需要為 Confirm 參數指定任何值。
DomainController	選用	Microsoft.Exchange.Data.Fqdn	若要指定從 Active Directory 目錄服務擷取資料之網域控制站的網域全名 (FQDN)，請在指令程式中加入 DomainController 參數。
LightMode	選用	System.Management.Automation.SwitchParameter	不會針對 Test-OwaConnectivity 診斷指令程式實作這個參數。使用這個參數不會變更指令程式的行為。 附註： 會針對其他 Exchange 2007 診斷指令程式實作這個指令程式。尤其是在您想要執行較不密集的指令程式版本時，會使用這個參數。
MailboxCredential	選用	System.Management.Automation.PSCredential	這個參數包含用於單一 URL 測試的信箱認證。
MailboxServer	選用	Microsoft.Exchange.Configuration.Tasks.ServerIdParameter	此參數可指定要測試的 Mailbox Server 名稱。如未指定，則會測試本機 Active Directory 站台上的所有 Mailbox Server。
MonitoringContext	選用	System.Management.Automation.SwitchParameter	如果包含此參數，工作將會透過 MOM 排程來執行。執行含有此參數而不具 MOM 的工作，將導致此工作失敗。如果排除此參數，則必須由系統管理員以互動方式執行工作。
ResetTestAccountCredentials	選用	System.Management.Automation.SwitchParameter	ResetTestAccountCredentials 參數會重設用來執行此命令之測試帳戶的密碼。如果您使用 Microsoft System Center Operations Manager 來管理 Exchange 環境，則測試帳戶的密碼通常每隔七天會重設一次。只要安全上有需要，隨時都可以使用此標幟強制進行密碼重設。
Site	選用	Microsoft.Exchange.Configuration.Tasks.AdSiteIdParameter	Site 參數是用來指定 Active Directory 站台。
TestType	選用	Microsoft.Exchange.Monitoring.OwaConnectivityTestType	此參數會判斷指令程式是否將測試內部或外部 URL。值為 Internal 和 External。此參數不得搭配 URL 參數一起使用。當 TestType 參數及 URL 參數皆未指定時，預設值為 TestType:Internal。
Timeout	選用	System.UInt32	此參數指定要等候測試作業完成的時間量 (以秒為單位)。Timeout 的預設值為 30 秒。指定的 Timeout 值必須大於 0 秒，小於 1 小時 (3600 秒)。建議您一律將此參數值設為大於或等於 5 秒。
TrustAnySSLCertificate	選用	System.Management.Automation.SwitchParameter	若使用此參數，便不會回報 SSL 憑證驗證失敗。因為網際網路資訊服務 (IIS) 並不支援為單一虛擬目錄指派多個憑證，所以這在測試內部 URL 時很有用。某個目錄若有不同的 URL 供內部及外部存取，但只有一個憑證，則此憑證通常是供外部 URL 所用。憑證與 URL 不相符時，此參數可讓工作檢查內部 URL 但不會產生錯誤。
URL	選用	System.String	此參數可指定要測試的 Outlook Web Access URL。如果使用了此參數，則僅會測試指定的 URL。請勿使用將 URL 參數與 ClientAccessServer 參數搭配使用。URL 參數無法與 TestType 參數搭配使用。
VirtualDirectoryName	選用	System.String	此參數可指定特定 Client Access Server 上要測試的虛擬目錄名稱。如未包含此參數，則會測試支援 Exchange 2007 信箱的所有 Outlook Web Access 虛擬目錄。
WhatIf	選用	System.Management.Automation.SwitchParameter	WhatIf 參數指示命令模擬它將對物件採取的動作。使用 WhatIf 參數，則不需要套用任何變更，就能檢視變更。您不需要為 WhatIf 參數指定任何值。

輸入類型

傳回類型

錯誤

例外狀況

範例

第一個程式碼範例使用使用者 contoso\kweku 的認證，測試 URL https://mail.contoso.com/owa 的連線。

第二個程式碼範例測試名為 Contoso12 之特定 Client Access Server 的連線，而且會測試支援 Exchange 2007 信箱的所有 Outlook Web Access 虛擬目錄。包括不需要 SSL 的虛擬目錄。

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

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