Test-OwaConnectivity (RTM)

  • [アーティクル]

 

適用先: Exchange Server 2007

トピックの最終更新日: 2010-08-18

Test-OwaConnectivity コマンドレットは、Microsoft Office Outlook Web Access が正常に実行されているかどうかを確認するために使用します。Test-OwaConnectivity コマンドレットを使用すると、同一の Active Directory サイト内の Exchange 2007 サーバー上にあるすべてのメールボックスで使用される、指定されたクライアント アクセス サーバー上にあるすべての 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 コマンドレットを使用すると、クライアント アクセス サーバー上にあるすべての Exchange 2007 Outlook Web Access 仮想ディレクトリの接続をテストしたり、1 つの Exchange 2007 Outlook Web Access の URL の接続をテストしたりすることができます。

クライアント アクセス サーバー上にあるすべての Exchange 2007 Outlook Web Access 仮想ディレクトリをテストするには、テスト Active Directory アカウントが存在する必要があります。また、メールボックス サーバーの役割がインストールされている各 Exchange 2007 サーバーに、テスト対象の仮想ディレクトリを通してアクセスできるテスト メールボックスが存在する必要があります。テスト アカウントとテスト メールボックスは、メールボックス サーバーのセットアップ時に作成できます。メールボックス サーバーのセットアップ中にテスト環境が作成されなかった場合、Test-OwaConnectivity コマンドレットを実行すると、テスト メールボックスとテスト ユーザーを作成するスクリプトを実行するよう求められます。

テスト メールボックスをホストするサーバーが使用可能でない場合、Test-OWAConnectivity コマンドレットがエラーを返し、問題を明確に識別できないことがあります。これを回避するには、Test-OWAConnectivity コマンドレットを実行する前に、テスト メールボックスをホストするサーバーが実行中であること、およびメールボックスが使用可能であることを確認します。

クライアント アクセス サーバー上で、ClientAccessServer パラメータまたは URL パラメータを使用せずに Test-OwaConnectivity コマンドレットを実行すると、コマンドレットを実行したサーバーがテストされます。特定のクライアント アクセス サーバーをテストするには、ClientAccessServer パラメータを使用します。

クライアント アクセス サーバー上のすべての Exchange 2007 仮想ディレクトリに対する Outlook Web Access 接続をテストするために Test-OwaConnectivity コマンドレットを実行するには、使用するアカウントに Exchange サーバーの管理者の役割、および対象サーバーのローカルの Administrators グループのメンバシップが委任されている必要があります。

アクセス許可、役割の委任、および Exchange Server 2007 を管理するために必要な権限の詳細については、「アクセス許可に関する考慮事項」を参照してください。

1 つの URL をテストするには、URL パラメータと既存の Exchange 2007 メールボックスの資格情報を指定して、Test-OwaConnectivity を実行します。その URL が負荷分散装置の背後にある場合、このコマンドレットによってテストされるクライアント アクセス サーバーがどれになるかは予測できません。URL パラメータを使用する場合はパラメータに資格情報を含める必要があるため、URL パラメータを使用するときには任意のアカウントを使用して Test-OwaConnectivity を実行できます。

SSL (Secure Sockets Layer) を必要としない仮想ディレクトリがコマンドレットによって検出されると、AllowUnsecureAccess パラメータが使用されている場合を除き、そのディレクトリのテストはスキップされます。AllowUnsecureAccess パラメータが使用されている場合、テストのためにサーバー間の通信はクリア テキストで送信されます。

Test-OwaConnectivity コマンドレットは、1 回限りの対話的タスクとして実行することができます。また、Microsoft Operations Manager (MOM) の制御によるスケジュールされたタスクとして実行することもできます。MOM タスクとして Test-OwaConnectivity を実行するには、このコマンドレットでテストするメールボックス サーバー上に、クライアント アクセスのテスト環境が用意されている必要があります。

パラメータ

パラメータ 必須 種類 説明

AllowUnsecureAccess

省略可能

System.Management.Automation.SwitchParameter

このパラメータを含めると、SSL を必要としない仮想ディレクトリのテストを行うことができます。このパラメータが含まれていない場合は、SSL を必要としない仮想ディレクトリに対してタスクは実行されず、エラーが生成されます。

ClientAccessServer

省略可能

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

このパラメータには、テストするクライアント アクセス サーバーの名前を指定します。このパラメータが含まれている場合は、指定されたクライアント アクセス サーバー上にあるすべての Exchange 2007 Outlook Web Access 仮想ディレクトリが、ローカルの Active Directory サイト内にあるすべての Exchange 2007 メールボックス サーバーに対してテストされます。Microsoft Exchange 2000 Server および Microsoft Exchange Server 2003 の仮想ディレクトリはテストされません。Exchange 2007 メールボックス サーバー上にないメールボックスはテストされません。このパラメータは、URL パラメータと同時に使用できません。

DomainController

省略可能

Microsoft.Exchange.Data.Fqdn

Active Directory ディレクトリ サービスからデータを取得するドメイン コントローラの完全修飾ドメイン名 (FQDN) を指定するには、コマンドレットに DomainController パラメータを含めます。

MailboxCredential

省略可能

System.Management.Automation.PSCredential

このパラメータには、1 つの URL をテストする場合に使用するメールボックスの資格情報を含めます。

MailboxServer

省略可能

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

このパラメータには、テストするメールボックス サーバーの名前を指定します。指定されていない場合、ローカルの Active Directory サイト内にあるすべてのメールボックス サーバーがテストされます。

MonitoringContext

省略可能

System.Management.Automation.SwitchParameter

このパラメータが含まれている場合は、タスクは MOM のスケジュール設定によって実行されます。このパラメータを指定して MOM を利用せずにタスクを実行すると、タスクは失敗します。このパラメータを指定しない場合、管理者がタスクを対話的に実行する必要があります。

ResetTestAccountCredentials

省略可能

System.Management.Automation.SwitchParameter

ResetTestAccountCredentials パラメータは、このコマンドを実行するために使用されるテスト アカウントのパスワードをリセットします。Microsoft System Center Operations Manager を使用して Exchange 環境を管理している場合、テスト アカウントのパスワードは一般に 7 日ごとにリセットされます。セキュリティ上の理由で必要になったときにはいつでもこのフラグを使用して、パスワードをリセットできます。

TestType

省略可能

Microsoft.Exchange.Monitoring.OwaConnectivityTestType

このパラメータは、コマンドレットが内部と外部のどちらの URL をテストするかを決定します。値は、Internal および External です。このパラメータを URL パラメータと共に使用することはできません。TestType パラメータと URL パラメータのいずれも指定されていない場合、既定値は TestType:Internal です。

TrustAnySSLCertificate

省略可能

System.Management.Automation.SwitchParameter

このパラメータが使用されている場合、SSL 証明書の検証エラーは報告されません。インターネット インフォメーション サービス (IIS) では、1 つの仮想ディレクトリに複数の証明書を割り当てることができないため、このパラメータは内部の URL をテストする場合に役立ちます。ディレクトリに、内部アクセス用と外部アクセス用に異なる URL が存在し、証明書が割り当てられている場合、その証明書は通常は外部 URL 用のものです。このパラメータを使用すると、タスクは証明書と URL が対応していない場合、エラーを生成せずに内部 URL をチェックします。

URL

省略可能

System.String

このパラメータには、テストする Outlook Web Access の URL を指定します。このパラメータが使用されている場合は、指定された URL のみがテストされます。URL パラメータは、ClientAccessServer パラメータと同時に使用することはできません。また、URL パラメータを TestType パラメータと共に使用することはできません。

VirtualDirectoryName

省略可能

System.String

このパラメータには、特定のクライアント アクセス サーバー上にある、テストする仮想ディレクトリの名前を指定します。このパラメータが含まれていない場合、Exchange 2007 メールボックスをサポートするすべての Outlook Web Access 仮想ディレクトリがテストされます。

入力の種類

戻り値の種類

エラー

エラー 説明

 

 

例外

例外 説明

 

 

例

最初のコード例は、ユーザー contoso\kweku の資格情報を使用して、https://mail.contoso.com/owa という URL の接続性をテストします。

2 番目のコード例は、Contoso12 という名前のクライアント アクセス サーバーの接続をテストします。このコード例では、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 TechCenter を参照してください。