Test-OwaConnectivity (RTM)

  • 發行項

 

適用版本： Exchange Server 2007

上次修改主題的時間： 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>] [-DomainController <Fqdn>] [-MailboxServer <ServerIdParameter>] [-MonitoringContext <SwitchParameter>] [-ResetTestAccountCredentials <SwitchParameter>] [-TestType <Internal | External>] [-TrustAnySSLCertificate <SwitchParameter>] [-VirtualDirectoryName <String>]

Test-OwaConnectivity [-URL <String>] [-AllowUnsecureAccess <SwitchParameter>] [-DomainController <Fqdn>] [-MailboxCredential <PSCredential>] [-ResetTestAccountCredentials <SwitchParameter>] [-TrustAnySSLCertificate <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 參數使用。

DomainController

選用

Microsoft.Exchange.Data.Fqdn

若要指定從 Active Directory 目錄服務擷取資料之網域控制站的網域全名 (FQDN)，請在指令程式中加入 DomainController 參數。

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 環境，則測試帳戶的密碼通常每隔七天會重設一次。只要安全上有需要，隨時都可以使用此標幟強制進行密碼重設。

TestType

選用

Microsoft.Exchange.Monitoring.OwaConnectivityTestType

此參數會判斷指令程式是否將測試內部或外部 URL。值為 Internal 和 External。此參數不得搭配 URL 參數使用。當 TestType 參數及 URL 參數皆未指定時，預設值為 TestType:Internal。

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 虛擬目錄。

輸入類型

傳回類型

錯誤

錯誤 描述

 

 

例外狀況

例外狀況 描述

 

 

範例

第一個程式碼範例使用使用者 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 技術資源中心.