Get-MessageTrackingReport

リファレンス

モジュール:: ExchangePowerShell

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

このコマンドレットは、オンプレミスの Exchange でのみ機能します。

Get-MessageTrackingReport コマンドレットを使用して、特定のメッセージ追跡レポートのデータを返します。このコマンドレットは、配信レポート機能によって使用されます。

Exchange Onlineでは、配信レポートはメッセージトレース (Get-MessageTrace コマンドレットと Get-MessageTraceDetail コマンドレット) に置き換えられました。

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

構文

Get-MessageTrackingReport
   [-Identity] <MessageTrackingReportId>
   [-BypassDelegateChecking]
   [-DetailLevel <MessageTrackingDetailLevel>]
   [-DomainController <Fqdn>]
   [-DoNotResolve]
   [-RecipientPathFilter <SmtpAddress>]
   [-Recipients <String[]>]
   [-ReportTemplate <ReportTemplate>]
   [-ResultSize <Unlimited>]
   [-Status <DeliveryStatus>]
   [-TraceLevel <TraceLevel>]
   [<CommonParameters>]

説明

このコマンドレットには、表示するメッセージ追跡レポートの ID を指定する必要があります。そのため、最初に Search-MessageTrackingReport コマンドレットを使用して、特定のメッセージのメッセージ追跡レポート ID を検索し、次に、結果をこのコマンドレットに渡します。詳細については、「Search-MessageTrackingReport」を参照してください。

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

例

例 1

$Temp = Search-MessageTrackingReport -Identity "David Jones" -Recipients "wendy@contoso.com"

Get-MessageTrackingReport -Identity $Temp.MessageTrackingReportID -ReportTemplate Summary

この例では、あるユーザーから別のユーザーに送信されたメッセージに対するメッセージ追跡レポートを取得します。この例では、David Jones が Wendy Richardson に送信したメッセージのメッセージ追跡レポートの概要を返します。

例 2

Search-MessageTrackingReport -Identity "Cigdem Akin" -Sender "joe@contoso.com" -ByPassDelegateChecking -DoNotResolve | ForEach-Object { Get-MessageTrackingReport -Identity $_.MessageTrackingReportID -DetailLevel Verbose -BypassDelegateChecking -DoNotResolve -RecipientPathFilter "cigdem@fabrikam.com" -ReportTemplate RecipientPath }

この例では、次のシナリオのメッセージ追跡レポートを取得します。ユーザー Cigdem Akin は、届かないメールメッセージ joe@contoso.com を想定していました。ヘルプデスクに問い合わせ、Cigdem に代わってメッセージ追跡レポートを生成する必要があり、表示名を表示する必要はありません。

次の使用例は、特定のメッセージ追跡レポートのメッセージ追跡データを検索し、特定の受信者パスの詳細なトラブルシューティング情報を返します。

パラメーター

-BypassDelegateChecking

BypassDelegateChecking スイッチを使用すると、ヘルプデスクのスタッフと管理者は、任意のユーザーのメッセージ追跡レポートを取得することができます。このスイッチで値を指定する必要はありません。

既定では、各ユーザーは、自分自身が送信または受信したメッセージのメッセージ追跡レポートのみを参照できます。このスイッチを使用すると、他のユーザー間で交換されたメッセージのメッセージ追跡レポートを表示することができます。

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

-DetailLevel

DetailLevel パラメーターでは、結果で返される詳細情報の量を指定します。有効な値は次のとおりです。

基本: 単純な配信レポート情報が返されます。これはユーザーにとってより適切です。
詳細: サーバー名や物理トポロジ情報など、完全なレポート情報が返されます。

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

-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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DoNotResolve

DoNotResolve スイッチは、電子メールアドレスから表示名への解決を禁止するかどうかを指定します。このスイッチで値を指定する必要はありません。

このスイッチを使用すると、パフォーマンスが向上しますが、表示名がないと結果を解釈することが困難になる場合があります。

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

-Identity

Identity パラメーターでは、表示するメッセージ追跡レポート ID を指定します。

Search-MessageTrackingReport コマンドレットを実行して、追跡している特定のメッセージのメッセージ追跡レポート ID を検索し、次に MessageTrackingReportID フィールドの値をこのパラメーターに渡す必要があります。

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

-RecipientPathFilter

RecipientPathFilter パラメーターは、値 RecipientPath の ReportTemplate パラメーターを使用するときに受信者の電子メールアドレスを指定します。

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

-Recipients

Recipients パラメーターは、値 Summary の ReportTemplate パラメーターを使用するときに受信者の電子メールアドレスを指定します。複数のメールアドレスをコンマで区切って指定できます。

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

-ReportTemplate

ReportTemplate パラメーターでは、出力に対して定義済みの形式を指定します。有効な値は次のとおりです。

RecipientPath: メッセージの 1 人の受信者の詳細な追跡レポートを返します。 RecipientPathFilter パラメーターを使用して受信者を指定します。
概要: メッセージのすべての受信者の概要を返します。 Recipients パラメーターを使用して受信者を指定します。

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

-ResultSize

ResultSize パラメーターは、返される結果の最大数を指定します。クエリに一致するすべてのリクエストを返す場合は、このパラメーターの値に unlimited を使用します。既定値は 1,000 です。

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

-Status

Status パラメーターは、指定された配信のステータスコードを使用して結果をフィルター処理します。有効な値は次のとおりです。

配信済み
読み取り
Pending
転送
失敗

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

-TraceLevel

TraceLevel パラメーターでは、結果に含める詳細を指定します。有効な値は次のとおりです。

低: アクセスされたサーバー、タイミング、メッセージ追跡検索結果の数、エラー情報など、最小限の追加データが返されます。
中: Low 設定で返されるデータに加えて、実際のメッセージ追跡検索結果も返されます。
高: 完全な診断データが返されます。

このパラメーターは、メッセージ追跡の問題をトラブルシューティングするときだけに使用する必要があります。

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

入力

Input types

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

出力

Output types

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