共用方式為

Get-MessageTraceV2

模組:
Exchange PowerShell

此指令程式只能在雲端式服務中使用。

使用 Get-MessageTraceV2 指令碼來追蹤訊息在雲端組織中流傳的過程。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

語法

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>]

Description

你可以用這個 cmdlet 搜尋過去 90 天的訊息資料。 如果你執行這個 cmdlet 而不使用任何參數，只會回傳過去 48 小時的資料。 每次查詢只能回傳 10 天的資料。

預設情況下，此指令組最多回傳 1000 筆結果，最多可達 5000 筆。 如果資料超過結果大小，請分多輪查詢，或使用較小的起始日期與結束日期區間。

輸出時間為UTC時間格式。 這可能和你用來設定 -StartDate 和 -EndDate 參數的時間格式不同。

限速限制：在 5 分鐘的運行視窗內，最多可接受 100 筆查詢請求。 如果請求速率在過去 5 分鐘內低於 100 個請求，則自動不會套用限速

這個指令本不支援分頁。 查詢後續資料時，使用開始接收地址（StartingRecipientAddress）和結束日期（EndDate）參數，分別取自前一查詢結果的接收地址與接收時間屬性。

最佳實務：

  • 使用 ResultSize 參數來調整結果大小。
  • 盡可能精確。 縮小起始日期與結束日期之間的差距，並盡可能使用額外參數 (例如寄件人地址) 。
  • 在可能的情況下使用 MessageTraceId， (對於發送給超過 1000 名收件人的訊息) 。

您必須已獲指派權限，才能執行此指令程式。 雖然這篇文章列出了 cmdlet 的所有參數，但如果某些參數未包含在你分配的權限中，你可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

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

此範例取得 2025 年 6 月 13 日至 6 月 15 日之間發送 john@contoso.com 的訊息追蹤資訊。

參數

-EndDate

適用：Exchange Online，內建本地信箱安全外掛

EndDate 參數會指定日期範圍的結束日期。

在您要執行命令的電腦上，使用該電腦的 [地區選項] 設定中定義的簡短日期格式。 例如，若電腦設定為短日期格式 MM/dd/yyyy，請輸入 09/01/2025 以指定 2025 年 9 月 1 日。 您可以只輸入日期，或者也可以輸入日期和時間。 如果你輸入日期和時間，請用引號 ( ) ，例如「09/01/2025 5：00 PM」，將數值包起來。

參數屬性

類型:System.DateTime
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:1
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-FromIP

適用：Exchange Online，內建本地信箱安全外掛

FromIP 參數會依來源 IP 位址篩選結果。 針對接收郵件，FromIP 的值為發送該郵件的 SMTP 電子郵件伺服器之公開 IP 位址。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:2
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-MessageId

適用：Exchange Online，內建本地信箱安全外掛

MessageId 參數會依郵件的 Message-ID 標頭欄位來篩選結果。 此值也稱為「用戶端識別碼」。 Message-ID 的格式取決於傳送郵件的訊息伺服器。 每封郵件都僅具有唯一值。 然而，並非所有訊息伺服器都使用相同的方法來建立 Message-ID 的值。 請務必包含完整的訊息 ID 字串 (，可能包含) 角括號，並以 (引號包圍，例如「d9683b4c-127b-413a-ae2e-fa7dfb32c69d@DM3NAM06BG401.Eop-nam06.prod.protection.outlook.com) 」。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:3
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-MessageTraceId

適用：Exchange Online，內建本地信箱安全外掛

MessageTraceId 參數會依訊息的訊息追蹤 ID 值來過濾結果。 這個 GUID 值會根據系統處理的每一則訊息產生，例如 (c20e0f7a-f06b-41df-fe33-08d9da155ac1) 。

MessageTraceId 值也可在以下 cmdlet 的輸出中取得：

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

參數屬性

類型:System.Guid
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:4
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-RecipientAddress

適用：Exchange Online，內建本地信箱安全外掛

RecipientAddress 參數會依收件者電子郵件地址來篩選結果。 您可以指定多個以逗號分隔的值。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:5
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-ResultSize

適用：Exchange Online，內建本地信箱安全外掛

ResultSize 參數會指定傳回的結果筆數上限。 有效值為1到5000。 預設值為 1000。

注意：此參數取代了 Get-MessageTrace cmdlet 中可用的 PageSize 參數。

參數屬性

類型:Int32
預設值:0
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:6
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-SenderAddress

適用：Exchange Online，內建本地信箱安全外掛

SenderAddress 參數會依寄件者電子郵件地址來篩選結果。 您可以指定多個以逗號分隔的值。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:7
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-StartDate

適用：Exchange Online，內建本地信箱安全外掛

StartDate 參數會指定日期範圍的開始日期。

在您要執行命令的電腦上，使用該電腦的 [地區選項] 設定中定義的簡短日期格式。 例如，若電腦設定為短日期格式 MM/dd/yyyy，請輸入 09/01/2025 以指定 2025 年 9 月 1 日。 您可以只輸入日期，或者也可以輸入日期和時間。 如果你輸入日期和時間，請用引號 ( ) ，例如「09/01/2025 5：00 PM」，將數值包起來。

參數屬性

類型:System.DateTime
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:8
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-StartingRecipientAddress

適用：Exchange Online，內建本地信箱安全外掛

StartingRecipientAddress 參數與 EndDate 參數一起使用，用來查詢後續資料以尋找部分結果，同時避免重複。 查詢後續資料時，取部分結果最後記錄的 Recipient 位址 與 Received Time 值，分別作為 StartingRecipientAddress 與 EndDate 參數的值，進行下一次查詢。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:9
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Status

適用：Exchange Online，內建本地信箱安全外掛

Status 參數會依據郵件的傳送狀態來篩選結果。 有效值為：

  • Delivered： 郵件已傳遞到其目的地。
  • 擴展：沒有訊息傳遞，因為訊息是寄給分發群組，且分發的成員範圍擴大了。
  • 失敗：嘗試傳遞訊息但失敗。
  • FilteredAsSpam：該訊息被標記為垃圾郵件。
  • GettingStatus：訊息正在等待狀態更新。
  • Pending：郵件傳送進行中，或者已擱置並重試中。
  • 隔離：訊息已被隔離。

你可以用逗號分隔多個數值。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:10
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Subject

適用：Exchange Online，內建本地信箱安全外掛

主旨參數會依訊息主旨篩選結果。 如果值包含空格，請使用引號 (") 括住值。

你可以用 SubjectFilterType 參數來指定訊息主旨中值的評估方式。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:11
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-SubjectFilterType

適用：Exchange Online，內建本地信箱安全外掛

SubjectFilterType 參數指定如何評估 Subject 參數的值。 有效值為：

  • 包含
  • 結束
  • 起始

我們建議盡可能使用 StartsWith 或 EndsWith 代替 Constains。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:12
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-ToIP

適用：Exchange Online，內建本地信箱安全外掛

ToIP 參數會依目的地 IP 位址篩選結果。 針對傳送的郵件， ToIP 的值為目的地網域已解析 MX 記錄中的公開 IP 位址。 寄至 Exchange Online 的郵件，值為空白。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:13
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

CommonParameters

此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。