Test-OwaConnectivity

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Exchange Server 2010

このコマンドレットは 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

このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。