Get-MessageTrackingReport

モジュール:
Exchange PowerShell

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

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

Exchange Onlineでは、配信レポートはメッセージ追跡 (Get-MessageTraceV2 および Get-MessageTraceDetailV2 コマンドレット) に置き換えられます。

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

構文

Default (既定) 

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"

foreach ($reportId in $Temp.MessageTrackingReportId) {
    Get-MessageTrackingReport -Identity $reportId -ReportTemplate Summary -Status Delivered
}

この例では、あるユーザーから別のユーザーに送信されたメッセージに対するメッセージ追跡レポートを取得します。 この例では、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

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

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

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

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DetailLevel

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

  • 基本: ユーザーにより適した単純な配信レポート情報が返されます。
  • Verbose: サーバー名や物理トポロジ情報など、完全なレポート情報が返されます。

パラメーターのプロパティ

型:MessageTrackingDetailLevel
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DomainController

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。

パラメーターのプロパティ

型:Fqdn
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DoNotResolve

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

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

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

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Identity

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

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

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

注意: Identityパラメータの値$nullまたは存在しない値は、IdentityパラメータなしでGet-コマンドを実行したかのように、 すべての オブジェクトを返します。 Identity パラメーターの値のリストが正確であり、存在しない$null値が含まれていないことを確認します。

パラメーターのプロパティ

型:MessageTrackingReportId
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:1
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-RecipientPathFilter

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

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

パラメーターのプロパティ

型:SmtpAddress
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Recipients

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

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

パラメーターのプロパティ

型:

String[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ReportTemplate

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

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

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

パラメーターのプロパティ

型:ReportTemplate
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ResultSize

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

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

パラメーターのプロパティ

型:Unlimited
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Status

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

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

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

パラメーターのプロパティ

型:_DeliveryStatus
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-TraceLevel

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

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

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

パラメーターのプロパティ

型:TraceLevel
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(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

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