Get-MessageTrackingLog
このコマンドレットは、オンプレミスの 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 パラメーターは、期間の開始日時を指定します。
コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。 たとえば、短い日付形式 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 |
-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
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。