Get-MessageTraceV2

模組:: Exchange PowerShell

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

使用 Get-MessageTraceV2 Cmdlet 在訊息通過雲端組織傳遞時進行追蹤。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 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 天的資料。

根據預設，此 Cmdlet 最多會傳回 1000 個結果，最多傳回 5000 個結果。如果您的資料超過結果大小，請分多輪查詢，或使用較小的 StartDate 和 EndDate 間隔。

輸出上的時間戳記為 UTC 時間格式。這可能與您用於 -StartDate 和 -EndDate 參數的時間格式不同。

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

此 Cmdlet 不支援分頁。若要查詢後續資料，請在下一個查詢中分別使用 StartingRecipientAddress 和 EndDate 參數搭配上一個結果的 [收件者地址 ] 和 [接收時間] 屬性中的值。

最佳做法：

使用 ResultSize 參數來調整結果的大小。
盡可能精確。縮小 StartDate 和 EndDate 之間的差距，並盡可能使用其他參數 (例如 SenderAddress) 。
如果可能，請使用 MessageTraceId， (傳送給) 個以上收件者的郵件是必要的。

您必須已獲指派權限，才能執行此指令程式。雖然本文列出 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 日到 2025 年 6 月 15 日之間所傳送 john@contoso.com 訊息的訊息追蹤資訊。

參數

-EndDate

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

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

參數屬性

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

參數集

(All)

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

-MessageId

MessageId 參數會依郵件的 Message-ID 標頭欄位來篩選結果。此值也稱為「用戶端識別碼」。 Message-ID 的格式取決於傳送郵件的訊息伺服器。每封郵件都僅具有唯一值。然而，並非所有訊息伺服器都使用相同的方法來建立 Message-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

MessageTraceId 參數會依據訊息的訊息追蹤識別碼值來篩選結果。此 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

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

參數屬性

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

參數集

(All)

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

-ResultSize

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

注意：此參數會取代 Get-MessageTrace Cmdlet 上提供的 PageSize 參數。

參數屬性

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

參數集

(All)

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

-SenderAddress

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

參數屬性

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

參數集

(All)

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

-StartDate

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

參數屬性

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

參數集

(All)

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

-StartingRecipientAddress

StartingRecipientAddress 參數與 EndDate 參數搭配使用，可查詢後續資料的部分結果，同時避免重複。查詢後續資料的方法為，方法是在部分結果的最後一筆記錄中使用收 件者位址 和 接收時間 值，並將它們分別用作下一個查詢中 StartingRecipientAddress 和 EndDate 參數的值。

參數屬性

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

參數集

(All)

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

-Status

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

Delivered：郵件已傳遞到其目的地。
已展開：沒有傳遞郵件，因為郵件已傳送至通訊群組，且發佈的成員資格已展開。
失敗：已嘗試傳遞訊息，但失敗了。
FilteredAsSpam：此郵件已標示為垃圾郵件。
GettingStatus：訊息正在等候狀態更新。
Pending：郵件傳送進行中，或者已擱置並重試中。
已隔離：郵件已隔離。

您可以分隔多個值，並以逗號分隔。

參數屬性

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

參數集

(All)

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

-Subject

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

您可以使用 SubjectFilterType 參數指定如何在訊息主旨中評估值。

參數屬性

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

參數集

(All)

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

-SubjectFilterType

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

包含
EndsWith
StartsWith

建議您盡可能使用 StartsWith 或 EndsWith，而非 Contains。

參數屬性

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

參數集

(All)

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

-ToIP

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。

意見反應

此頁面對您有幫助嗎？