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のコマンドレット構文」を参照してください。
構文
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 パラメーターを使用します。
1 つの URL をテストするには、既存の Exchange メールボックスの URL パラメーターと資格情報を使用して、Test-OwaConnectivity コマンドレットを実行します。 URL がロード バランサーの背後にある場合、コマンドでテストするクライアント アクセス サーバーを予測できません。 URL パラメーターを使用する場合はパラメーターの一部として資格情報が必要であるため、URL パラメーターを使用するときに任意のアカウントを使用して、Test-OwaConnectivity コマンドレットを実行できます。
コマンドで Secure Sockets Layer (SSL) を必要としない仮想ディレクトリが検出された場合、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仮想ディレクトリをテストします。 これには、SSL を必要としない仮想ディレクトリが含まれます。
パラメーター
-AllowUnsecureAccess
適用対象: Exchange Server 2010
AllowUnsecureAccess スイッチは、SSL を必要としない仮想ディレクトリをテストするかどうかを指定します。 このスイッチで値を指定する必要はありません。
このスイッチを使用しない場合、コマンドは SSL を必要としない仮想ディレクトリをスキップし、エラーが生成されます。
パラメーターのプロパティ
| 型: | 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 パラメーターは、1 つの 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 を指定します。 このパラメーターは、単一の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: | ウィスコンシン |
パラメーター セット
(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
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。