共用方式為


Get-MessageTraceDetail

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

注意事項

此 cmdlet 將被 Get-MessageTraceDetailV2 指令檔取代,最終將被棄用。

使用 Get-MessageTraceDetail 指令程式檢視特定訊息的訊息追蹤事件詳細資訊。 這些詳細結果的回報速度比 Get-MessageTrace 結果慢。

如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法

語法

Default (預設值)

Get-MessageTraceDetail
    -MessageTraceId <Guid>
    -RecipientAddress <String>
    [-Action <MultiValuedProperty>]
    [-EndDate <DateTime>]
    [-Event <MultiValuedProperty>]
    [-MessageId <String>]
    [-Page <Int32>]
    [-PageSize <Int32>]
    [-ProbeTag <String>]
    [-SenderAddress <String>]
    [-StartDate <DateTime>]
    [<CommonParameters>]

Description

你可以用這個 cmdlet 搜尋過去 10 天的訊息資料。 如果你輸入超過 10 天的時間段,會收到錯誤,指令也不會回傳任何結果。

若要搜尋超過 10 天的訊息資料,請使用 Start-HistoricalSearch 並 Get-HistoricalSearch 指令碼。

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

範例

範例 1

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

此範例取得訊息追蹤 ID 為 ae5c1219-4c90-41bf-fef5-08d837917e7c robert@contoso.com的訊息詳細追蹤資訊。

範例 2

Get-MessageTrace -MessageTraceId 2bbad36aa4674c7ba82f4b307fff549f -SenderAddress john@contoso.com -StartDate 06/13/2018 -EndDate 06/15/2018 | Get-MessageTraceDetail

此範例使用 Get-MessageTrace cmdlet 取得 Exchange Network 訊息 ID 值為 2bbad36aa4674c7ba82f4b307fff549f 的訊息追蹤資訊,該訊息於 2018 年 6 月 13 日至 2018 年 6 月 15 日之間由 2bbad36aa474c 發送 john@contoso.com ,並將結果流水線傳送至 Get-MessageTraceDetail cmdlet。

參數

-Action

適用:Exchange Online,內建本地信箱安全外掛

Action 參數會根據對訊息所採取的行動來過濾報告。 要查看該參數的完整有效值清單,請執行指令: Get-MailFilterListReport -SelectionTarget Actions。 你指定的動作必須對應報告類型。 例如,你只能在惡意軟體報告中指定惡意軟體過濾動作。

Action 參數會依照 DLP 原則、傳輸規則、惡意程式碼篩選或垃圾郵件篩選所採取的動作篩選報告。若要檢視此參數完整的有效值清單,請執行 Get-MailFilterListReport -SelectionTarget Actions 命令。您指定的動作必須有對應的報告類型。例如,您只能為惡意程式碼報告指定惡意程式碼篩選動作。

參數屬性

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

參數集

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

-EndDate

適用:Exchange Online,內建本地信箱安全外掛

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

在您要執行命令的電腦上,使用該電腦的 [地區選項] 設定中定義的簡短日期格式。 例如,如果電腦設定使用短日期格式 MM/dd/yyyy,請輸入 09/01/2018 以指定 2018 年 9 月 1 日。 您可以只輸入日期,或者也可以輸入日期和時間。 如果輸入日期和時間,請使用引號 (") 括住值,例如 "09/01/2018 5:00 PM"。

如果不使用開始日期和結束日期參數,則只會回傳過去48小時的資料。

參數屬性

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

參數集

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

-Event

適用:Exchange Online,內建本地信箱安全外掛

Event 參數會依據郵件事件來篩選報告。 以下是常見事件的範例:

  • 接收:訊息已被服務接收。
  • 發送:訊息是由服務發送的。
  • 失敗:訊息未能送達。
  • 傳遞:訊息被送到信箱。
  • 展開:訊息被發送給一個被擴展的分發群組。
  • 傳輸:收件人因內容轉換、訊息接收者限制或代理人員而被移至分段訊息。
  • DEFER:訊息傳遞被延後,可能會稍後重新嘗試。

您可以指定多個以逗號分隔的值。

參數屬性

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

參數集

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

-MessageId

適用:Exchange Online,內建本地信箱安全外掛

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

參數屬性

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

參數集

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

-MessageTraceId

適用:Exchange Online,內建本地信箱安全外掛

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

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

  • Get-MailDetailATPReport
  • Get-MailDetailDlpPolicyReport
  • Get-MailDetailEncryptionReport
  • Get-MailDetailTransportRuleReport
  • Get-MessageTrace

參數屬性

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

參數集

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

-Page

適用:Exchange Online,內建本地信箱安全外掛

Page 參數會指定您要檢視的結果頁數。 此參數的有效輸入是 1 與 1000 之間的整數。 預設值為 1。

參數屬性

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

參數集

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

-PageSize

適用:Exchange Online,內建本地信箱安全外掛

PageSize 參數會指定每頁的顯示項目數上限。 此參數的有效輸入是 1 與 5000 之間的整數。 預設值為 1000。

參數屬性

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

參數集

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

-ProbeTag

適用:Exchange Online,內建本地信箱安全外掛

將保留此參數供 Microsoft 內部使用。

參數屬性

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

參數集

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

-RecipientAddress

適用:Exchange Online,內建本地信箱安全外掛

RecipientAddress 參數會依收件者電子郵件地址來篩選結果。

參數屬性

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

參數集

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

-SenderAddress

適用:Exchange Online,內建本地信箱安全外掛

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

參數屬性

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

參數集

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

-StartDate

適用:Exchange Online,內建本地信箱安全外掛

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

在您要執行命令的電腦上,使用該電腦的 [地區選項] 設定中定義的簡短日期格式。 例如,如果電腦設定使用短日期格式 MM/dd/yyyy,請輸入 09/01/2018 以指定 2018 年 9 月 1 日。 您可以只輸入日期,或者也可以輸入日期和時間。 如果輸入日期和時間,請使用引號 (") 括住值,例如 "09/01/2018 5:00 PM"。

如果不使用開始日期和結束日期參數,則只會回傳過去48小時的資料。

參數屬性

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

參數集

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

CommonParameters

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

輸入

Input types

若要查看此指令程式可接受的輸入類型,請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的,表示指令程式不接受輸入資料。

輸出

Output types

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。