次の方法で共有

Get-MessageTraceDetailV2

モジュール:
ExchangePowerShell
適用対象:
Exchange Online

構文

Get-MessageTraceDetailV2
   [-MessageTraceId] <Guid>
   [-RecipientAddress] <String>
   [[-Action] <MultiValuedProperty>]
   [[-EndDate] <System.DateTime>]
   [[-Event] <MultiValuedProperty>]
   [[-MessageId] <String>]
   [[-SenderAddress] <String>]
   [[-StartDate] <System.DateTime>]
   [<CommonParameters>]

説明

このコマンドレットを使用して、過去 90 日間のメッセージ データを検索できます。 クエリを実行できるのは、クエリごとに 10 日分のデータのみです。 90 日を超える期間を入力すると、エラーが発生し、コマンドは結果を返しません。

調整の制限: 実行時間が 5 分以内に最大 100 個のクエリ要求が受け入れられます。 要求レートが過去 5 分間に 100 件の要求より低い場合、調整は自動的に適用されません

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

例

例 1

Get-MessageTraceDetailV2 -MessageTraceId ae5c1219-4c90-41bf-fef5-08d837917e7c -RecipientAddress robert@contoso.com

次の使用例は、メッセージ トレース ID 値 ae5c1219-4c90-41bf-fef5-08d837917e7c が受信したメッセージの詳細なメッセージ トレース情報を取得 robert@contoso.com。

例 2

Get-MessageTraceV2 -MessageTraceId 2bbad36aa4674c7ba82f4b307fff549f -SenderAddress john@contoso.com -StartDate 06/13/2025 -EndDate 06/15/2025 | Get-MessageTraceDetailV2

この例では、Get-MessageTraceV2 コマンドレットを使用して、Exchange Network Message ID 値 2bbad36aa4674c7ba82f4b307fff549f john@contoso.com が 2025 年 6 月 13 日から 2025 年 6 月 15 日の間に送信したメッセージのメッセージ トレース情報を取得し、結果を Get-MessageTraceDetailV2 コマンドレットにパイプライン処理します。

パラメーター

-Action

適用対象: Exchange Online

Action パラメーターは、メッセージに対して実行されたアクションによってレポートをフィルター処理します。 このパラメーターの有効な値の完全な一覧を表示するには、コマンド Get-MailFilterListReport -SelectionTarget Actionsを実行します。 指定するアクションは、レポートの種類に対応している必要があります。 たとえば、マルウェア レポートのマルウェア フィルター アクションのみを指定できます。

Action パラメーターは、DLP ポリシー、トランスポート ルール、マルウェア フィルター、またはスパム フィルターによって実行された操作別にレポートをフィルター処理します。このパラメーターの有効な値の完全な一覧を表示するには、コマンド Get-MailFilterListReport -SelectionTarget Actions を実行します。指定する操作は、レポートの種類に対応している必要があります。たとえば、マルウェア レポートの場合に指定できるのはマルウェア フィルターの操作のみです。

型:MultiValuedProperty
配置:1
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-EndDate

適用対象: Exchange Online

EndDate パラメーターには、日付範囲の終了日を指定します。

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

StartDate パラメーターと EndDate パラメーターを使用しない場合は、過去 48 時間のデータのみが返されます。

型:System.DateTime
配置:2
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Event

適用対象: Exchange Online

Event パラメーターは、メッセージ イベント別にレポートをフィルター処理します。 以下は一般的なイベントの例です。

  • RECEIVE: サービスによってメッセージが受信されました。
  • SEND: メッセージはサービスによって送信されました。
  • FAIL: メッセージの配信に失敗しました。
  • 配信: メッセージがメールボックスに配信されました。
  • 展開: 展開された配布グループにメッセージが送信されました。
  • 転送: 受信者は、コンテンツの変換、メッセージ受信者の制限、またはエージェントのために、分岐されたメッセージに移動されました。
  • DEFER: メッセージ配信は延期され、後で再試行される可能性があります。

複数の値をコンマで区切って指定できます。

型:MultiValuedProperty
配置:3
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-MessageId

適用対象: Exchange Online

MessageId パラメーターは、メッセージの Message-ID 件名フィールド別に結果をフィルター処理します。 この値はクライアント ID とも呼ばれます。 Message-ID の形式は、メッセージを送信したメッセージング サーバーによって異なります。 値はメッセージごとに一意である必要があります。 ただし、すべてのメッセージング サーバーが同じ方法で Message-ID の値を作成するわけではありません。 完全なメッセージ ID 文字列 (山かっこを含む場合があります) を必ず含め、値を引用符 ("d9683b4c-127b-413a-ae2e-fa7dfb32c69d@DM3NAM06BG401.Eop-nam06.prod.protection.outlook.com" など) で囲んでください。

型:String
配置:4
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-MessageTraceId

適用対象: Exchange Online

MessageTraceId パラメーターは、メッセージのメッセージ トレース ID 値によって結果をフィルター処理します。 この GUID 値は、システムによって処理されるすべてのメッセージに対して生成されます (例: c20e0f7a-f06b-41df-fe33-08d9da155ac1)。

型:Guid
配置:5
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-RecipientAddress

適用対象: Exchange Online

RecipientAddress パラメーターは、受信者の電子メール アドレスで結果をフィルター処理します。

型:String
配置:6
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-SenderAddress

適用対象: Exchange Online

SenderAddress パラメーターは、送信者の電子メール アドレスで結果をフィルター処理します。 複数の値をコンマで区切って指定できます。

型:String
配置:7
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-StartDate

適用対象: Exchange Online

StartDate パラメーターは、日付範囲の開始日を指定します。

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

StartDate パラメーターと EndDate パラメーターを使用しない場合は、過去 48 時間のデータのみが返されます。

型:System.DateTime
配置:8
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False