Test-OwaConnectivity
このコマンドレットは Exchange Server 2010 でのみ使用可能です。
Test-OwaConnectivity コマンドレットを使用して、Microsoft Office Outlook Web App が正常に実行されていることを確認します。 Test-OwaConnectivity コマンドレットを使用すると、同じ Active Directory サイト内にある Exchange を実行しているサーバー上のすべてのメールボックスについて、指定したクライアント アクセス サーバー上のすべての Microsoft Exchange Server 2010 仮想ディレクトリのOutlook Web App接続をテストできます。 Test-OwaConnectivity コマンドレットを使用して、個々の Exchange Outlook Web App URL の接続をテストすることもできます。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
URL
Test-OwaConnectivity
[-URL] <String>
-MailboxCredential <PSCredential>
[-AllowUnsecureAccess]
[-Confirm]
[-DomainController <Fqdn>]
[-LightMode]
[-ResetTestAccountCredentials]
[-Timeout <UInt32>]
[-TrustAnySSLCertificate]
[-WhatIf]
[<CommonParameters>]
Identity
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 パラメーターを使用します。
単一の URL をテストするには、Test-OwaConnectivity コマンドレットを既存の Exchange メールボックスの URL パラメーターと資格情報で実行します。 URL がロード バランサーの背後にある場合、コマンドがテストするクライアント アクセス サーバーを予測することはできません。 URL パラメーターを使用する場合は、パラメーターの一部として資格情報が必要であるため、URL パラメーターを使用する場合は、任意のアカウントを使用して Test-OwaConnectivity コマンドレットを実行できます。
このコマンドがトランスポート層セキュリティ (TLS) を必要としない仮想ディレクトリを検出した場合、AllowUnsecureAccess パラメーターが使用されない限り、コマンドはそのディレクトリをスキップします。 AllowUnsecureAccess パラメーターが使用されている場合、サーバー間の通信はテストの目的でクリア テキストで送信されます。
Test-OwaConnectivity コマンドレットは、1 回限りの対話型タスクとして、または Microsoft System Center Operations Manager 2007 の制御下でスケジュールされたタスクとして実行できます。 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 仮想ディレクトリをテストします。 これらの情報には、TLS を必要としない仮想ディレクトリが含まれます。
パラメーター
-AllowUnsecureAccess
適用対象: Exchange Server 2010
AllowUnsecureAccess スイッチは、TLS を必要としない仮想ディレクトリをテストするかどうかを指定します。 このスイッチで値を指定する必要はありません。
このスイッチを使用しない場合、このコマンドは TLS を必要としない仮想ディレクトリをスキップし、エラーが生成されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ClientAccessServer
適用対象: Exchange Server 2010
このパラメーターは、Exchange Server 2010 でのみ使用できます
ClientAccessServer パラメーターは、テストするクライアント アクセス サーバーの名前を指定します。 このパラメーターを含めると、クライアント アクセス サーバー上のすべての Exchange Outlook Web App 仮想ディレクトリが、ローカル Active Directory サイトにあるすべての Exchange メールボックス サーバーに対してテストされます。
このパラメーターと URL パラメーターを組み合わせて使用しないでください。
パラメーターのプロパティ
| 型: | ServerIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Identity
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Confirm
適用対象: Exchange Server 2010
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットに与える影響は、コマンドレットが続行する前に確認を必要とするかどうかによって異なります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値を指定せずに Confirm スイッチを指定すると、一時停止が発生し、続行する前にコマンドの確認を強制されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | Cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DomainController
適用対象: Exchange Server 2010
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
パラメーターのプロパティ
| 型: | Fqdn |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-LightMode
適用対象: Exchange Server 2010
LightMode パラメーターは、この診断コマンドには実装されていません。 このパラメーターを使用しても、コマンドの動作は変わりません。
このパラメーターは、負荷の低いバージョンのコマンドを実行するために使用される、他の Exchange 診断コマンド用に実装されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MailboxCredential
適用対象: Exchange Server 2010
MailboxCredential パラメーターは、単一の URL テストのメールボックス資格情報を指定します。
このパラメーターの値には、Get-Credential コマンドレットが必要です。 このコマンドを一時停止し、資格情報の入力を求めるメッセージを表示するには、値(Get-Credential)を使用します。 または、このコマンドを実行する前に、資格情報を変数 (たとえば、$cred = Get-Credential) に保存し、このパラメーターに変数名 ($cred) を使用します。 詳細については、Get-Credentialに関するページをご覧ください。
MailboxCredential パラメーターは、URL パラメーターを使用する場合にのみ必須です。
パラメーターのプロパティ
| 型: | PSCredential |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
URL
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MailboxServer
適用対象: Exchange Server 2010
MailboxServer パラメータでは、テストするメールボックス サーバーの名前を指定します。 指定しない場合は、ローカル Active Directory サイト内のすべてのメールボックス サーバーがテストされます。
パラメーターのプロパティ
| 型: | ServerIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Identity
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MonitoringContext
適用対象: Exchange Server 2010
MonitoringContext スイッチは、関連する監視イベントおよびパフォーマンス カウンターを結果に含めます。 このスイッチで値を指定する必要はありません。
通常、出力が Microsoft System Center Operations Manager (SCOM) に渡されるときに、結果に監視イベントとパフォーマンス カウンターを含めます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Identity
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ResetTestAccountCredentials
適用対象: Exchange Server 2010
ResetTestAccountCredentials スイッチは、このコマンドを実行するために使用されるテスト アカウントのパスワードをリセットします。 このスイッチで値を指定する必要はありません。
テスト アカウントのパスワードは、通常、7 日ごとにリセットされます。 セキュリティ上の理由でパスワードのリセットが必要になったときはいつでも、このパラメーターを使用してパスワードを強制的にリセットできます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-RSTEndpoint
適用対象: Exchange Server 2010
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Identity
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-TestType
適用対象: Exchange Server 2010
TestType パラメーターは、コマンドが内部と外部のどちらの URL をテストするかを指定します。 値は Internal と External です。 このパラメーターと URL パラメーターを組み合わせて使用することはできません。 TestType パラメーターも URL パラメーターも指定されていない場合、既定値は TestType:Internal になります。
パラメーターのプロパティ
| 型: | OwaConnectivityTestType |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Identity
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Timeout
適用対象: Exchange Server 2010
Timeout パラメーターは、テスト操作が終了するまでの待機時間を秒単位で指定します。 Timeout パラメーターの既定値は 30 秒です。 0 秒より大きく、1 時間 (3,600 秒) より小さいタイムアウト値を指定する必要があります。 このパラメーターは常に 5 秒以上の値で構成することをお勧めします。
パラメーターのプロパティ
| 型: | UInt32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-TrustAnySSLCertificate
適用対象: Exchange Server 2010
TrustAnySSLCertificate スイッチを使用すると、Exchange は信頼されていない証明機関 (CA) からの証明書を受け入れることができます。 このスイッチで値を指定する必要はありません。
TrustAnySSLCertificate スイッチは、Secure Sockets Layer (SSL) 証明書の検証エラーを無視するかどうかを指定します。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-URL
適用対象: Exchange Server 2010
URL パラメーターには、テストする URL を指定します。 このパラメーターは、1 つの Outlook Web App URL をテストする場合にのみ必要です。
このパラメーターを使用する場合は、MailboxCredential パラメーターも必須です。
URL パラメーターを TestType パラメーターまたは ClientAccessServer パラメーターと一緒に使用することはできません。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
URL
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-VirtualDirectoryName
適用対象: Exchange Server 2010
VirtualDirectoryName パラメーターは、特定のクライアント アクセス サーバーでテストする仮想ディレクトリの名前を指定します。 このパラメーターが含まれていない場合、Exchange メールボックスをサポートするすべての Exchange Outlook Web App 仮想ディレクトリがテストされます。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Identity
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
適用対象: Exchange Server 2010
[WhatIf] スイッチは、何も変更を加えずにコマンドが実行する内容を表示します。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | wi |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。