Get-MessageTraceV2

構文

Default (既定)

Get-MessageTraceV2

    [[-EndDate] <System.DateTime>]
    [[-FromIP] <String>]
    [[-MessageId] <MultiValuedProperty>]
    [[-MessageTraceId] <System.Guid>]
    [[-RecipientAddress] <MultiValuedProperty>]
    [[-ResultSize] <Int32>]
    [[-SenderAddress] <MultiValuedProperty>]
    [[-StartDate] <System.DateTime>]
    [[-StartingRecipientAddress] <String>]
    [[-Status] <MultiValuedProperty>]
    [[-SubjectFilterType] <String>]
    [[-Subject] <String>]
    [[-ToIP] <String>]
    [<CommonParameters>]

説明

例

例 1

Get-MessageTraceV2 -SenderAddress john@contoso.com -StartDate 06/13/2025 -EndDate 06/15/2025

パラメーター

-EndDate

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

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

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

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

パラメーター セット

-FromIP

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

FromIP パラメーターは、送信元の IP アドレス別に結果をフィルター処理します。 受信メッセージの場合、FromIP の値は、メッセージを送信する SMTP 電子メール サーバーのパブリック IP アドレスです。

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

パラメーター セット

-MessageId

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

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

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

パラメーター セット

-MessageTraceId

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

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

MessageTraceId の値は、次のコマンドレットの出力でも使用できます。

• Get-MailDetailATPReport
• Get-MailDetailDlpPolicyReport
• Get-MailDetailEncryptionReport
• Get-MailDetailTransportRuleReport
• Get-MessageTraceDetailV2

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

パラメーター セット

-RecipientAddress

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

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

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

パラメーター セット

-ResultSize

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

ResultSize パラメーターは、返される結果の最大数を指定します。 有効な値は 1 から 5000 です。 既定値は 1,000 です。

注: このパラメーターは、Get-MessageTrace コマンドレットで使用可能だった PageSize パラメーターを置き換えます。

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

パラメーター セット

-SenderAddress

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

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

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

パラメーター セット

-StartDate

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

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

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

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

パラメーター セット

-StartingRecipientAddress

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

StartingRecipientAddress パラメーターを EndDate パラメーターと共に使用して、重複を回避しながら、後続のデータに対して部分的な結果を照会します。 後続のデータのクエリを実行するには、部分的な結果の最後のレコードの Recipient アドレス と 受信時刻 の値を取得し、次のクエリでそれぞれ StartingRecipientAddress パラメーターと EndDate パラメーターの値として使用します。

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

パラメーター セット

-Status

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

Status パラメーターは、メッセージの配信状態別に結果をフィルター処理します。 有効な値は次のとおりです。

• Delivered: メッセージは送信先に配信されました。
• 展開済み: メッセージが配布グループに送信され、配布のメンバーシップが展開されたため、メッセージの配信はありませんでした。
• 失敗: メッセージ配信が試行されましたが失敗しました。
• FilteredAsSpam: メッセージはスパムとしてマークされました。
• GettingStatus: メッセージはステータスの更新を待機しています。
• Pending: メッセージ配信は処理中、または遅延されて再試行中です。
• 検疫済み: メッセージは検疫済みです。

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

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

パラメーター セット

-Subject

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

[件名] パラメーターは、メッセージの件名で結果をフィルター処理します。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

SubjectFilterType パラメーターを使用して、メッセージの件名で値を評価する方法を指定します。

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

パラメーター セット

-SubjectFilterType

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

SubjectFilterType パラメーターは、サブジェクト パラメーターの値を評価する方法を指定します。 有効な値は次のとおりです。

• Contains
• EndsWith
• StartsWith

可能な限り、Contains ではなく StartsWith または EndsWith を使用することをお勧めします。

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

パラメーター セット

-ToIP

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

ToIP パラメーターは、送信先の IP アドレス別に結果をフィルター処理します。 送信メッセージの場合、ToIP の値は、送信先ドメインの解決された MX レコードのパブリック IP アドレスです。 Exchange Online への受信メッセージの場合、値は空白です。

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

パラメーター セット

CommonParameters