Get-MessageTrackingLog

リファレンス

モジュール:: ExchangePowerShell

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

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

Get-MessageTrackingLog コマンドレットを使用して、メッセージ追跡ログに格納されたメッセージ配信情報を検索します。

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

構文

Get-MessageTrackingLog
   [-DomainController <Fqdn>]
   [-End <DateTime>]
   [-EventId <String>]
   [-InternalMessageId <String>]
   [-MessageId <String>]
   [-MessageSubject <String>]
   [-Recipients <String[]>]
   [-Reference <String>]
   [-ResultSize <Unlimited>]
   [-Sender <String>]
   [-Server <ServerIdParameter>]
   [-Start <DateTime>]
   [-NetworkMessageId <String>]
   [-Source <String>]
   [-TransportTrafficType <String>]
   [<CommonParameters>]

説明

メールボックスサーバー上のトランスポートサービス、メールボックスサーバーおよびエッジトランスポートサーバー上のメールボックストランスポートサービスに対する一意のメッセージ追跡ログが存在します。メッセージ追跡ログはコンマで区切られた値 (CSV) のファイルであり、電子メールメッセージが Exchange サーバーを経由して到達するまでの履歴についての詳細情報が含まれます。

Get-MessageTrackingLog コマンドレットからの結果に表示されるフィールド名は、メッセージ追跡ログで使われる実際のフィールド名とほぼ同じです。違いは次のとおりです。

ダッシュは、フィールド名から削除されます。たとえば、internal-message-id は、InternalMessageId と表示されます。
date-time フィールドは、Timestampとして表示されます。
recipient-address フィールドは、Recipients として表示されます。
sender-address フィールドは、Sender として表示されます。

メッセージ追跡ログファイルの詳細については、「メッセージの追跡」を参照してください。

結果をファイルに書き込むには、出力をConvertTo-HtmlまたはConvertTo-Csvにパイプしてコマンドに追加 > <filename> します。 (例: Get-MessageTrackingLog -Start "03/13/2020 09:00:00" -End "03/13/2020 09:10:00" | ConvertTo-Html > "C:\My Documents\message track.html")。

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

例

例 1

Get-MessageTrackingLog -Server Mailbox01 -Start "03/13/2018 09:00:00" -End "03/15/2018 17:00:00" -Sender "john@contoso.com"

次の使用例は、Mailbox01 という名前のメールボックスサーバー上のメッセージ追跡ログを検索し、送信者が 2018 年 3 月 13 日 09:00 から 2018 年 3 月 15 日 17:00 に送信したすべてのメッセージに関する情報を検索します john@contoso.com。

パラメーター

-DomainController

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

DomainController パラメーターは、エッジトランスポートサーバーではサポートされません。エッジトランスポートサーバーは、Active Directory ライトウェイトディレクトリサービス (AD LDS) のローカルインスタンスを使用してデータの読み書きを行います。

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

-End

End パラメーターは、期間の終了日時を指定します。指定した日時より前のメッセージ配信情報が返されます。

コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。たとえば、短い日付形式 mm/dd/yyyy を使用するようにコンピューターが構成されている場合は、「09/01/2018」と入力して 2018 年 9 月 1 日を指定します。日付のみを入力したり、日付と時刻を入力することもできます。日付と時刻を入力する場合は、値を引用符 (”) で囲む必要があります (例: "09/01/2018 5:00 PM")。

Type:	DateTime
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

-EventId

EventId パラメーターは、EventId フィールドの値でメッセージ追跡ログのエントリをフィルターします。 EventId 値は、各メッセージイベントを分類します。 DSN、Defer、Deliver、Send、Receive などの値があります。

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

-InternalMessageId

InternalMessageId パラメーターは、InternalMessageId フィールドの値でメッセージ追跡ログのエントリをフィルターします。 InternalMessageId の値は、現在メッセージを処理している Exchange サーバーによって割り当てられたメッセージ識別子です。

各メッセージの internal-message-id の値は、メッセージ配信に関わるすべての Exchange サーバーのメッセージ追跡ログで、それぞれ違う値になります。

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

-MessageId

MessageId パラメーターは、MessageId フィールドの値でメッセージ追跡ログのエントリをフィルターします。 MessageId の値は、メッセージの Message-Id: ヘッダーフィールドの値に対応します。 Message-ID ヘッダーフィールドが空白か存在しない場合、任意の値が割り当てられます。完全な MessageId 文字列 (山かっこを含む場合があります) を必ず含め、値を引用符 ("d9683b4c-127b-413a-ae2e-fa7dfb32c69d@contoso.com" など) で囲んでください。

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

-MessageSubject

MessageSubject パラメーターは、メッセージの件名の値でメッセージ追跡ログのエントリをフィルターします。 MessageSubject パラメーターの値は、ワイルドカードや特別な文字を使用しなくても、自動的に部分一致をサポートします。たとえば、MessageSubject の値として sea を指定すると、結果には、件名の一部が Seattle のメッセージが含まれます。既定では、メッセージの件名はメッセージ追跡ログに格納されます。

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

-NetworkMessageId

NetworkMessageId パラメーターは、NetworkMessageId フィールドの値によってメッセージ追跡ログエントリをフィルター処理します。このフィールドには、分岐または配布グループの拡張によって作成される可能性があるメッセージのコピー間で保持される一意のメッセージ ID 値が含まれています。たとえば、1341ac7b13fb42ab4d4408cf7f55890f のような値です。

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

-Recipients

Recipients パラメーターは、メッセージ受信者の SMTP 電子メールアドレスでメッセージ追跡ログのエントリをフィルターします。 1 つのメッセージの受信者が複数の場合、それらの受信者は 1 つのメッセージ追跡ログエントリにまとめて記録されます。展開されない配布グループ受信者は、グループの SMTP 電子メールアドレスでログに出力されます。複数の受信者電子メールアドレスをコンマで区切って指定できます。

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

-Reference

Reference パラメーターは、Reference フィールドの値でメッセージ追跡ログのエントリをフィルターします。 Reference フィールドには、特定の種類のイベントについての追加情報が含まれます。たとえば、DSN メッセージ追跡エントリの Reference フィールドの値には、DSN の原因となったメッセージの InternalMessageId 値が含まれます。多くのイベントタイプでは、Reference の値は空白です。

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

-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

-Sender

Sender パラメーターは、送信者の SMTP 電子メールアドレスでメッセージ追跡ログのエントリをフィルターします。

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

-Server

Server パラメーターは、このコマンドの実行先となる Exchange サーバーを指定します。サーバーを一意に識別する任意の値を使用できます。次に例を示します。

名前
FQDN
識別名 (DN)
Exchange の従来の DN

このパラメーターを使用しない場合、コマンドはローカルサーバー上で実行されます。

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

-Source

Source パラメーターは、Source フィールドの値でメッセージ追跡ログのエントリをフィルターします。これらの値は、メッセージ追跡イベントを処理するトランスポートコンポーネントを示します。詳細については、「Source values in the message tracking log」を参照してください。

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

-Start

Start パラメーターは、期間の開始日時を指定します。

Type:	DateTime
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

-TransportTrafficType

TransportTrafficType パラメーターは、TransportTrafficType フィールドの値でメッセージ追跡ログのエントリをフィルターします。ただし、このフィールドは、オンプレミスの Exchange 組織にとって興味深いことではありません。

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

入力

Input types

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

出力

Output types

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