Test-OwaConnectivity
このコマンドレットは Exchange Server 2010 でのみ使用可能です。
Test-OwaConnectivity コマンドレットを使用して、Microsoft Office Outlook Web Appが期待どおりに実行されていることを確認します。 Test-OwaConnectivity コマンドレットを使用すると、指定したクライアント アクセス サーバー上のすべてのMicrosoft Exchange Server 2010 仮想ディレクトリのOutlook Web App接続を、同じ Active Directory サイト内にある Exchange を実行しているすべてのメールボックスに対してテストできます。 Test-OwaConnectivity コマンドレットを使用して、個々の Exchange Outlook Web App URL の接続をテストすることもできます。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
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>] 説明
Test-OwaConnectivity コマンドレットは、クライアント アクセス サーバー上のすべての Exchange Outlook Web App仮想ディレクトリの接続をテストするか、単一の Exchange Outlook Web App URL の接続をテストします。
クライアント アクセス サーバー上のすべての Exchange Outlook Web App仮想ディレクトリをテストするには、Active Directory アカウントがテストされている必要があります。 各 Active Directory サイトには、テスト対象の仮想ディレクトリを介してアクセスできるメールボックスをホストするテスト メールボックスも存在する必要があります。 メールボックス サーバーのセットアップ中にテスト環境が作成されなかった場合は、Test-OwaConnectivity コマンドレットを実行するときに、テスト メールボックスを作成し、ユーザーをテストするスクリプトを実行するように求められます。
テスト メールボックスをホストしているサーバーを使用できない場合、Test-OwaConnectivity コマンドレットは、問題を明確に特定できない可能性があるエラーを返します。 これを回避するには、テスト メールボックスをホストするサーバーが実行されていることと、Test-OwaConnectivity コマンドレットを実行する前にメールボックスが使用可能であることを確認します。 これを行うには、Test-MapiConnectivity コマンドレットを使用できます。
ClientAccessServer パラメーターまたは URL パラメーターを使用せずにクライアント アクセス サーバーで Test-OwaConnectivity コマンドレットを実行する場合、コマンドレットはコマンドレットを実行するサーバーをテストします。 特定のクライアント アクセス サーバーをテストするには、ClientAccessServer パラメーターを使用します。
1 つの URL をテストするには、既存の Exchange メールボックスの URL パラメーターと資格情報を使用して、Test-OwaConnectivity コマンドレットを実行します。 URL がロード バランサーの背後にある場合、コマンドでテストするクライアント アクセス サーバーを予測できません。 URL パラメーターを使用する場合はパラメーターの一部として資格情報が必要であるため、URL パラメーターを使用するときに任意のアカウントを使用して、Test-OwaConnectivity コマンドレットを実行できます。
コマンドで Secure Sockets Layer (SSL) を必要としない仮想ディレクトリが検出された場合、AllowUnsecureAccess パラメーターが使用されていない限り、コマンドはそのディレクトリをスキップします。 AllowUnsecureAccess パラメーターを使用すると、テストのためにサーバー間の通信がクリア テキストで送信されます。
Test-OwaConnectivity コマンドレットは、1 回限りの対話型タスクとして、または System Center Operations Manager 2007 コントロールMicrosoftスケジュールされたタスクとして実行できます。 Test-OwaConnectivity コマンドレットを System Center Operations Manager 2007 タスクとして実行するには、コマンドレットがテストするメールボックス サーバーでクライアント アクセス テスト メールボックスを使用できる必要があります。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 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
このパラメーターは、Exchange Server 2010 でのみ使用できます
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 スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- 破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。 これらのコマンドレットの場合、値なしで 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 パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは 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 パラメーターは、1 つの URL テストのメールボックス資格情報を指定します。
このパラメーターの値には、Get-Credential コマンドレットが必要です。 このコマンドを一時停止し、資格情報の入力を求めるメッセージを表示するには、値(Get-Credential)を使用します。 または、このコマンドを実行する前に、資格情報を変数 (たとえば、$cred = Get-Credential) に保存し、このパラメーターに変数名 ($cred) を使用します。 詳細については、Get-Credentialに関するページをご覧ください。
MailboxCredential パラメーターは、URL パラメーターを使用する場合にのみ必要です。
| 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 スイッチは、関連する監視イベントおよびパフォーマンス カウンターを結果に含めます。 このスイッチで値を指定する必要はありません。
通常、出力が System Center Operations Manager (SCOM) に渡されるときに、結果に監視イベントとパフォーマンス カウンター Microsoft含めます。
| 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 をテストするかを指定します。 値は 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 スイッチは、Secure Sockets Layer (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 パラメーターも必要です。
URL パラメーターは、TestType パラメーターまたは ClientAccessServer パラメーターでは使用できません。
| 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
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。