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/2024 09:00:00" -End "03/15/2024 17:00:00" -Sender "john@contoso.com"次の使用例は、Mailbox01 という名前のメールボックス サーバー上のメッセージ追跡ログを検索し、2024 年 3 月 13 日 09:00 から 2024 年 3 月 15 日 17:00 まで送信者 john@contoso.comによって送信されたすべてのメッセージに関する情報を検索します。
例 2
Get-MessageTrackingLog -Server Mailbox01 -Start "03/13/2024 09:00:00" -Recipients @("john@contoso.com","alice@contoso.com")次の使用例は、Mailbox01 という名前のメールボックス サーバー上のメッセージ追跡ログを検索し、2024 年 3 月 13 日 9:00 から今日まで送信されたすべてのメッセージについて、受信者の john@contoso.com や alice@contoso.comに関する情報を検索します。
パラメーター
-DomainController
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
DomainController パラメーターは、エッジ トランスポート サーバーではサポートされません。 エッジ トランスポート サーバーは、Active Directory ライトウェイト ディレクトリ サービス (AD LDS) のローカル インスタンスを使用してデータの読み書きを行います。
| 型: | Fqdn |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-End
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
End パラメーターは、期間の終了日時を指定します。 指定した日時より前のメッセージ配信情報が返されます。
コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。 たとえば、コンピューターが短い日付形式 MM/dd/yyyy を使用するように構成されている場合は、「2018 年 9 月 1 日」と入力して、2018 年 9 月 1 日を指定します。 日付のみを入力したり、日付と時刻を入力することもできます。 日付と時刻を入力する場合は、値を引用符 (”) で囲む必要があります (例: "09/01/2018 5:00 PM")。
| 型: | DateTime |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-EventId
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
EventId パラメーターは、EventId フィールドの値でメッセージ追跡ログのエントリをフィルターします。 EventId 値は、各メッセージ イベントを分類します。 DSN、Defer、Deliver、Send、Receive などの値があります。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InternalMessageId
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
InternalMessageId パラメーターは、InternalMessageId フィールドの値でメッセージ追跡ログのエントリをフィルターします。 InternalMessageId の値は、現在メッセージを処理している Exchange サーバーによって割り当てられたメッセージ識別子です。
各メッセージの internal-message-id の値は、メッセージ配信に関わるすべての Exchange サーバーのメッセージ追跡ログで、それぞれ違う値になります。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-MessageId
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
MessageId パラメーターは、MessageId フィールドの値でメッセージ追跡ログのエントリをフィルターします。 MessageId の値は、メッセージの Message-Id: ヘッダー フィールドの値に対応します。 Message-ID ヘッダー フィールドが空白か存在しない場合、任意の値が割り当てられます。 完全な MessageId 文字列 (山かっこを含む場合があります) を必ず含め、値を引用符 ("d9683b4c-127b-413a-ae2e-fa7dfb32c69d@contoso.com" など) で囲んでください。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-MessageSubject
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
MessageSubject パラメーターは、メッセージの件名の値でメッセージ追跡ログのエントリをフィルターします。 MessageSubject パラメーターの値は、ワイルドカードや特別な文字を使用しなくても、自動的に部分一致をサポートします。 たとえば、MessageSubject の値として sea を指定すると、結果には、件名の一部が Seattle のメッセージが含まれます。 既定では、メッセージの件名はメッセージ追跡ログに格納されます。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-NetworkMessageId
適用対象: Exchange Server 2016、Exchange Server 2019
NetworkMessageId パラメーターは、NetworkMessageId フィールドの値によってメッセージ追跡ログ エントリをフィルター処理します。 このフィールドには、分岐または配布グループの拡張によって作成される可能性があるメッセージのコピー間で保持される一意のメッセージ ID 値が含まれています。 たとえば、1341ac7b13fb42ab4d4408cf7f55890f のような値です。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Recipients
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Recipients パラメーターは、メッセージ受信者の SMTP 電子メールアドレスでメッセージ追跡ログのエントリをフィルターします。 1 つのメッセージの受信者が複数の場合、それらの受信者は 1 つのメッセージ追跡ログ エントリにまとめて記録されます。 展開されない配布グループ受信者は、グループの SMTP 電子メール アドレスでログに出力されます。 メール アドレスの配列を使用して、複数の受信者を指定できます。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Reference
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Reference パラメーターは、Reference フィールドの値でメッセージ追跡ログのエントリをフィルターします。 Reference フィールドには、特定の種類のイベントについての追加情報が含まれます。 たとえば、DSN メッセージ追跡エントリの Reference フィールドの値には、DSN の原因となったメッセージの InternalMessageId 値が含まれます。 多くのイベント タイプでは、Reference の値は空白です。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ResultSize
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
ResultSize パラメーターは、返される結果の最大数を指定します。 クエリに一致するすべてのリクエストを返す場合は、このパラメーターの値に unlimited を使用します。 既定値は 1,000 です。
| 型: | Unlimited |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Sender
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Sender パラメーターは、送信者の SMTP 電子メール アドレスでメッセージ追跡ログのエントリをフィルターします。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Server
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Server パラメーターは、このコマンドの実行先となる Exchange サーバーを指定します。 サーバーを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- FQDN
- 識別名 (DN)
- Exchange の従来の DN
このパラメーターを使用しない場合、コマンドはローカル サーバー上で実行されます。
| 型: | ServerIdParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Source
適用対象: Exchange Server 2016、Exchange Server 2019
Source パラメーターは、Source フィールドの値でメッセージ追跡ログのエントリをフィルターします。 これらの値は、メッセージ追跡イベントを処理するトランスポート コンポーネントを示します。 詳細については、「Source values in the message tracking log」を参照してください。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Start
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Start パラメーターは、期間の開始日時を指定します。
コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。 たとえば、コンピューターが短い日付形式 MM/dd/yyyy を使用するように構成されている場合は、「2018 年 9 月 1 日」と入力して、2018 年 9 月 1 日を指定します。 日付のみを入力したり、日付と時刻を入力することもできます。 日付と時刻を入力する場合は、値を引用符 (”) で囲む必要があります (例: "09/01/2018 5:00 PM")。
| 型: | DateTime |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-TransportTrafficType
適用対象: Exchange Server 2016、Exchange Server 2019
TransportTrafficType パラメーターは、TransportTrafficType フィールドの値でメッセージ追跡ログのエントリをフィルターします。 ただし、このフィールドは、オンプレミスの Exchange 組織にとって興味深いことではありません。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。