Test-OutlookConnectivity

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。

Test-OutlookConnectivity コマンドレットを使用して、Microsoft Exchange 組織内のエンドツーエンドMicrosoft Outlook クライアント接続をテストします。これには、Outlook Anywhere (RPC over HTTP) と MAPI over HTTP 接続の両方のテストが含まれます。

以下の構文セクションのパラメーターセットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

Test-OutlookConnectivity
    [-ProbeIdentity] <String>
    [-Credential <PSCredential>]
    [-Hostname <String>]
    [-MailboxId <MailboxIdParameter>]
    [-RunFromServerId <ServerIdParameter>]
    [-TimeOutSeconds <String>]
    [<CommonParameters>]

Test-OutlookConnectivity
    [[-Identity] <MailboxIdParameter>]
    -Protocol <Protocol>
    [-Archive <Boolean>]
    [-Confirm]
    [-MailboxCredential <PSCredential>]
    [-MonitoringContext]
    [-TotalTimeoutInMinutes <Int32>]
    [-TrustAnySslCert]
    [-WhatIf]
    [<CommonParameters>]

Test-OutlookConnectivity
    [[-Identity] <MailboxIdParameter>]
    -GetDefaultsFromAutodiscover <Boolean>
    [-Archive <Boolean>]
    [-Confirm]
    [-MailboxCredential <PSCredential>]
    [-MonitoringContext]
    [-RpcAuthenticationType <RpcAuthenticationType>]
    [-RpcClientAccessServer <ClientAccessServerIdParameter>]
    [-RpcProxyAuthenticationType <RPCProxyAuthenticationType>]
    [-RpcProxyServer <ServerIdParameter>]
    [-TotalTimeoutInMinutes <Int32>]
    [-TrustAnySslCert]
    [-WhatIf]
    [<CommonParameters>]

Test-OutlookConnectivity
    [[-Identity] <MailboxIdParameter>]
    -RpcTestType <RpcTestType>
    [-Archive <Boolean>]
    [-Confirm]
    [-MailboxCredential <PSCredential>]
    [-MonitoringContext]
    [-RpcAuthenticationType <RpcAuthenticationType>]
    [-RpcClientAccessServer <ClientAccessServerIdParameter>]
    [-RpcProxyAuthenticationType <RPCProxyAuthenticationType>]
    [-RpcProxyTestType <RpcProxyTestType>]
    [-TotalTimeoutInMinutes <Int32>]
    [-TrustAnySslCert]
    [-WhatIf]
    [<CommonParameters>]

Test-OutlookConnectivity
    [[-Identity] <MailboxIdParameter>]
    -WSTestType <VirtualDirectoryUriScope>
    [-Archive <Boolean>]
    [-Confirm]
    [-MailboxCredential <PSCredential>]
    [-MonitoringContext]
    [-TotalTimeoutInMinutes <Int32>]
    [-TrustAnySslCert]
    [-WhatIf]
    [<CommonParameters>]

説明

Test-OutlookConnectivity コマンドレットを実行すると、指定されたパラメーターによって定義された Outlook 接続が検証されます。コマンドは、1 つのメールボックスを検証できます。

Test-OutlookConnectivity コマンドレットは、監視プローブと同じプロセスを実行します。 Microsoft Exchange Health Manager (MSExchangeHM) サービスが実行されていて、テストされるコンピューターに Outlook プローブが作成されている必要があります。テストを実行するには、いずれかの Outlook プローブ ID を選択する必要があります。 Get-MonitoringItemIdentity コマンドレットを使用して、アクティブなプローブを確認します。

この例では、メールボックスサーバー上のバックエンドサービスで実行されているプローブの一覧を示します。 Get-MonitoringItemIdentity -Server MailboxServer1 -Identity outlook.protocol | ?{$_.Name -like '*probe'}

この例では、メールボックスサーバー上のクライアントアクセスサービスで実行されているプローブの一覧を示します。 Get-MonitoringItemIdentity -Server MailboxServer1 -Identity outlook | ?{$_.Name -like '*probe'}

プローブと監視フレームワークの詳細については、「 Managed Availability」、「 Managed Availability and Server Health」、および「 Managed Availability のカスタマイズ」を参照してください。

既定では、コマンドレットは、指定したプローブにアタッチされたテスト監視アカウントを使用します。 MailboxId パラメーターを使用して、別のメールボックスを入力することもできます。オプションと結果を次に示します。

MailboxId と資格情報が指定されていません: システムのテスト資格情報を使用して、テストメールボックスに対する汎用接続テスト。
MailboxId が指定されています。資格情報は指定されていません。システムのテスト資格情報を使用して特定のメールボックスへの接続テストを行います。
MailboxId と Credential が両方とも指定されている:特定のメールボックスに対する接続テスト、および指定した資格情報がこのメールボックスに対して有効かどうかを確認するテストが実行されます。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例

例 1

Test-OutlookConnectivity -ProbeIdentity OutlookMapiHttp.Protocol\OutlookMapiHttpSelfTestProbe

Exchange 2013 以降では、この例では、現在接続しているメールボックスサーバーで HTTP OutlookRpcSelfTestProbe 経由で MAPI を実行します。

例 2

Test-OutlookConnectivity "Outlook.Protocol\OutlookRpcDeepTestProbe\Mailbox Database 1234512345" -RunFromServerId PrimaryMailbox -MailboxId johnd@contoso.com

Exchange 2013 以降では、この例では、"メールボックスデータベース 1234512345" にマウントされているメールボックス "" の "johnd@contoso.comPrimaryMailbox" サーバーから OutlookRpcDeepTestProbe を実行します。 Credential パラメーターが指定されていないため、プローブでは既定のテストの資格情報が使用されます。

例 3

Test-OutlookConnectivity -Protocol HTTP -GetDefaultsFromAutoDiscover $true

Exchange 2010 では、この例では、Outlook Anywhere の最も一般的なエンドツーエンドの Outlook 接続シナリオをテストします。これには、自動検出サービスを介した接続のテスト、ユーザープロファイルの作成、ユーザーメールボックスへのログオンが含まれます。必要なすべての値は自動検出サービスから取得されます。 Identity パラメーターが指定されていないため、コマンドは、New-TestCasConnectivityUser.ps1 スクリプトを使用して作成した一時的なテストユーザーを使用します。このコマンド例は、プロトコルパラメーターを RPC に設定することで、TCP/IP 接続をテストするために実行できます。

例 4

Test-OutlookConnectivity -RpcProxyTestType:Internal -RpcTestType:Server

Exchange 2010 では、この例では、RpcProxy エンドポイントと RPC エンドポイントとしてローカルサーバーを使用して Outlook Anywhere 接続をテストします。 Identity パラメーターが指定されていないため、コマンドは、New-TestCasConnectivityUser.ps1 スクリプトを使用して作成した一時的なテストユーザーを使用します。 RpcProxyTestType パラメーターを External に設定して、パブリック外部 URL を使用するようにこの例を変更します。さらに、このコマンドの例では、RpcTestType パラメーターを Array に設定することで、クライアントアクセスサーバー配列を RPC エンドポイントとして使用できます。 TCP/IP 接続のみを検証するには、RpcProxyTestType パラメーターを省略します。

例 5

Test-OutlookConnectivity -RpcProxyServer RpcProxySrv01 -RpcProxyAuthenticationType Basic -RpcClientAccessServer CAS01 -RpcAuthenticationType NTLM

Exchange 2010 では、この例では、1 台のサーバーで RpcProxy 経由の Outlook 接続を検証し、外部認証層には Basic を、内部認証層には NTLM を使用してクライアントアクセスサーバーの役割を実行している別のサーバーに検証します。これらのパラメーターを使用すると、ほとんどの種類の Outlook 接続構成を検証できます。このコマンドは、1 つまたは 2 つのパラメーターのみをオーバーライドする必要がある場合に、GetDefaultsFromAutoDiscover パラメーターを $true に設定して使用することもできます。次のコマンドは、RPC Ping ユーティリティを使用して接続テストを実行するのと似ていますが、より強力な検証を提供します。

パラメーター

-Archive

このパラメーターは Exchange Server 2010 でのみ使用できます。

Archive パラメーターは、ユーザーのオンプレミスアーカイブメールボックスに接続するためにテストを実行するかどうかを指定します。有効な値は次のとおりです。

$true: ユーザーのオンプレミスアーカイブメールボックスに接続します。

$false: ユーザーのオンプレミスメールボックスに接続しないでください。これは既定の値です。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Confirm

このパラメーターは Exchange Server 2010 でのみ使用できます。

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

-Credential

Credential パラメーターは、プローブが使用する資格情報を指定します。システムのテスト資格情報は、既定で使用されます

このパラメーターの値には、Get-Credential コマンドレットが必要です。このコマンドを一時停止し、資格情報の入力を求めるメッセージを表示するには、値(Get-Credential)を使用します。または、このコマンドを実行する前に、資格情報を変数 (たとえば、$cred = Get-Credential) に保存し、このパラメーターに変数名 ($cred) を使用します。詳細については、Get-Credentialに関するページをご覧ください。

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-GetDefaultsFromAutodiscover

このパラメーターは Exchange Server 2010 でのみ使用できます。

GetDefaultsFromAutodiscover パラメーターは、自動検出サービス設定からコマンドの他のすべてのパラメーターの既定値を取得するかどうかを指定します。他のパラメーターの値を指定するコマンドを実行した場合、これらの値は自動検出サービスの既定値をオーバーライドします。このパラメーターの既定値は $true です。

Type:	Boolean
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Hostname

Hostname パラメーターは、プローブのプロトコルエンドポイントターゲットを指定します。特定のメールボックスサーバーを使用することも、分散ネームサービスサーバー経由でルーティングすることもできます。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

このパラメーターは Exchange Server 2010 でのみ使用できます。

Identity パラメーターは、ターゲットユーザーメールボックスを指定します。メールボックスを一意に識別する任意の値を使用できます。次に例を示します。

名前
Alias
識別名 (DN)
正規 DN
Domain\Username
電子メールアドレス
GUID
LegacyExchangeDN
SamAccountName
ユーザー ID またはユーザープリンシパル名 (UPN)

このパラメーターを使用しない場合、コマンドは、New-TestCasConnectivityUser.ps1 スクリプトを使用して以前に作成した Active Directory のテストユーザーを探します。

Type:	MailboxIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MailboxCredential

このパラメーターは Exchange Server 2010 でのみ使用できます。

MailboxCredential パラメーターは、ユーザーのメールボックスへのログオンアクセスを許可する特定の資格情報を指定します。アクセス許可がない場合は、Identity パラメーターと共にパラメーターを使用してユーザーのメールボックスにアクセスします。

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MailboxId

MailboxID パラメーターには、ターゲットメールボックスを指定します。

Exchange 2013 以降では、Identity パラメーターはターゲットユーザーメールボックスを指定します。メールボックスを一意に識別する任意の値を使用できます。次に例を示します。

名前
Alias
識別名 (DN)
正規 DN
Domain\Username
電子メールアドレス
GUID
LegacyExchangeDN
SamAccountName
ユーザー ID またはユーザープリンシパル名 (UPN)

このパラメーターを使用しない場合、コマンドはテストアカウントを使用します。

Type:	MailboxIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MonitoringContext

このパラメーターは Exchange Server 2010 でのみ使用できます。

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

-ProbeIdentity

ProbeIdentity パラメーターは、使用するプローブを指定します。有効な値は次のとおりです。

Outlook Anywhere (RPC over HTTP) プローブ:

Outlook.Protocol\OutlookRpcSelfTestProbe: RPC/HTTP エンドポイントがメールボックスサーバーでトラフィックを受信できることを検証します。メールボックスへのログインは試行されません。高レベルの接続チェックです。
Outlook.Protocol\OutlookRpcDeepTestProbe: RPC/HTTP エンドポイントがメールボックスサーバーで動作していることを検証します。メールボックスへの接続とメールボックスへのログインが試行されます。データベースが指定されていないので、Get-MailboxDatabase コマンドレットによって返された最初のデータベースへの接続が試行されます。
Outlook.Protocol\OutlookRpcDeepTestProbe\<Case-sensitive Mailbox Database Name>: RPC/HTTP エンドポイントがメールボックスサーバーで動作していることを検証します。指定したメールボックスデータベースに接続し、メールボックスにログインしようとします。メールボックスデータベース名にスペースが含まれている場合は、値全体を引用符で囲みます (例: "Outlook.Protocol\OutlookRpcDeepTestProbe\Mailbox Database 0352791530")。

HTTP プローブ経由の MAPI:

OutlookMapiHttp.Protocol\OutlookMapiHttpSelfTestProbe: MAPI/HTTP エンドポイントがメールボックスサーバーでトラフィックを受信できることを検証します。メールボックスへのログインは試行されません。高レベルの接続チェックです。
OutlookMapiHttp.Protocol\OutlookMapiHttpDeepTestProbe: MAPI/HTTP エンドポイントがメールボックスサーバーで動作していることを検証します。メールボックスへの接続とログインが試行されます。データベースが指定されていないので、Get-MailboxDatabase コマンドレットによって返された最初のデータベースへの接続が試行されます。
OutlookMapiHttp.Protocol\OutlookRpcDeepTestProbe\<Case-sensitive Mailbox Database Name>: MAPI/HTTP エンドポイントがメールボックスサーバーで動作していることを検証します。指定したデータベース内のメールボックスへの接続とログインが試行されます。メールボックスデータベース名にスペースが含まれている場合は、値全体を引用符で囲みます (例: "Outlook.Protocol\OutlookRpcDeepTestProbe\Mailbox Database 0352791530")。

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Protocol

このパラメーターは Exchange Server 2010 でのみ使用できます。

Protocol パラメーターは、Outlook Anywhere 接続をテストするか、RPC または TCP/IP 接続を直接テストするかを指定します。値は HTTP または TCP です。

Type:	Protocol
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RpcAuthenticationType

このパラメーターは Exchange Server 2010 でのみ使用できます。

RpcAuthenticationType パラメーターは、RPC レイヤーをテストする認証設定を指定します。このパラメーターを使用すると、RPC プロキシ仮想ディレクトリで別の認証の種類が設定されている場合に役立ちます。次の値を使用できます。

NTLM
Kerberos
交渉

既定値は Negotiate です。

Type:	RpcAuthenticationType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RpcClientAccessServer

このパラメーターは Exchange Server 2010 でのみ使用できます。

RpcClientAccessServer パラメーターは、テストするクライアントアクセスサーバーロールがインストールされているターゲットサーバーを指定します。サーバーの完全修飾ドメイン名 (FQDN) または GUID を指定できます。

Type:	ClientAccessServerIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RpcProxyAuthenticationType

このパラメーターは Exchange Server 2010 でのみ使用できます。

RpcProxyAuthenticationType パラメーターは、RPC プロキシエンドポイントの認証設定を指定します。値は、Basic、NTLM、または Negotiate として指定できます。 GetDefaultsFromAutodiscover パラメーターと共に使用しない限り、既定値はありません。

Type:	RPCProxyAuthenticationType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RpcProxyServer

このパラメーターは Exchange Server 2010 でのみ使用できます。

RpcProxyServer パラメーターは、テスト対象の RpcProxy サーバーを設定するかどうかを指定します。このパラメーターは、RpcProxy サーバーがクライアントアクセスサーバーと異なる場合に使用できます。

Type:	ServerIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RpcProxyTestType

このパラメーターは Exchange Server 2010 でのみ使用できます。

RpcProxyTestType パラメーターは、コマンドが接続する HTTP エンドポイントを指定します。有効な値は次のとおりです。

内部: ローカルコンピューター名 (https://<localcomputername>例: https://CAS01) を参照します。
外部: パブリック名前空間 (/rpc 仮想ディレクトリの外部 HTTP URL など https://mail.contoso.com) を参照します。

Type:	RpcProxyTestType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RpcTestType

このパラメーターは Exchange Server 2010 でのみ使用できます。

RpcTestType パラメーターは、コマンドでテストする必要がある RPC エンドポイントの種類を指定します。有効な値は次のとおりです。

サーバー: コマンドは、RPC エンドポイントとしてローカルサーバーを使用します。
配列: コマンドは、ローカル Active Directory サイトで ClientAccessArray オブジェクトを検索します。

Type:	RpcTestType
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RunFromServerId

RunFromServerID パラメーターは、プローブが実行されるサーバーを指定します。

Type:	ServerIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-TimeOutSeconds

TimeOutSeconds パラメーターには、プローブが終了するまでのタイムアウト期間を秒単位で指定します。既定値は 30 秒です。この数値は引用符を使って入力することもできます。 10 または "10" が動作します。入力エラーがあると既定の 30 秒に戻ります。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-TotalTimeoutInMinutes

このパラメーターは Exchange Server 2010 でのみ使用できます。

TotalTimeoutInMinutes パラメーターは、要求を終了する前にコマンドがテスト結果を待機する時間制限を分単位で指定します。既定値は 2 分です。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-TrustAnySslCert

このパラメーターは Exchange Server 2010 でのみ使用できます。

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

-WhatIf

このパラメーターは Exchange Server 2010 でのみ使用できます。

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

-WSTestType

このパラメーターは Exchange Server 2010 でのみ使用できます。

WSTestType パラメーターは、Outlook 接続テストに含めるサーバーの種類を指定します。次の値を使用できます。

不明 (既定値です)。
内部
外部

Type:	VirtualDirectoryUriScope
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

入力

Input types

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

出力

Output types

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

Test-OutlookConnectivity

構文

説明

例

例 1

例 2

例 3

例 4

例 5

パラメーター

-Archive

-Confirm

-Credential

-GetDefaultsFromAutodiscover

-Hostname

-Identity

-MailboxCredential

-MailboxId

-MonitoringContext

-ProbeIdentity

-Protocol

-RpcAuthenticationType

-RpcClientAccessServer

-RpcProxyAuthenticationType

-RpcProxyServer

-RpcProxyTestType

-RpcTestType

-RunFromServerId

-TimeOutSeconds

-TotalTimeoutInMinutes

-TrustAnySslCert

-WhatIf

-WSTestType

入力

出力

フィードバック

フィードバック

その他のリソース