共用方式為

Get-MessageTrace

模組:
Exchange PowerShell

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

注意事項

此 cmdlet 會被 Get-MessageTraceV2 指令檔取代，最終將被棄用。

使用 Get-MessageTrace 指令程式追蹤訊郵件送至基於雲端的組織過程。

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

語法

Default (預設值) 

Get-MessageTrace

    [-EndDate <DateTime>]
    [-FromIP <String>]
    [-MessageId <MultiValuedProperty>]
    [-MessageTraceId <Guid>]
    [-Page <Int32>]
    [-PageSize <Int32>]
    [-ProbeTag <String>]
    [-RecipientAddress <MultiValuedProperty>]
    [-SenderAddress <MultiValuedProperty>]
    [-StartDate <DateTime>]
    [-Status <MultiValuedProperty>]
    [-ToIP <String>]
    [<CommonParameters>]

Description

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

如果你輸入的開始日期超過10天，會收到錯誤，指令不會回傳任何結果。

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

預設情況下，此指令小程式最多回傳 1000 筆結果，且在非常大型查詢時會逾時。 如果你的查詢回傳太多結果，可以考慮用較小的 StartDate 和 EndDate 區間來分開查詢。

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

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

範例

範例 1

Get-MessageTrace -SenderAddress john@contoso.com -StartDate 06/13/2018 -EndDate 06/15/2018

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

參數

-EndDate

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

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

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

參數屬性

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

參數集

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

-FromIP

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

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

參數屬性

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

參數集

(All)
Position:Named
必要:False
來自管線的值:True
來自管線按屬性名稱的值: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: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-MessageTraceDetail

參數屬性

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

參數集

(All)
Position:Named
必要:False
來自管線的值: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 參數會依收件者電子郵件地址來篩選結果。 您可以指定多個以逗號分隔的值。

參數屬性

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

參數集

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

-SenderAddress

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

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

參數屬性

類型:MultiValuedProperty
預設值: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"。

參數屬性

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

參數集

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

-Status

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

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

  • None: 此郵件沒有傳送狀態，因其遭到拒絕或者重新導向至其他收件人。
  • GettingStatus：訊息正在等待狀態更新。
  • Failed：已嘗試郵件傳送卻失敗，或郵件遭篩選為垃圾郵件惡意軟體，或者根據傳輸規則。
  • Pending：郵件傳送進行中，或者已擱置並重試中。
  • Delivered： 郵件已傳遞到其目的地。
  • 擴展：沒有訊息傳遞，因為訊息是寄給分發群組，且分發的成員範圍擴大了。
  • 隔離：訊息已被隔離。
  • FilteredAsSpam：該訊息被標記為垃圾郵件。

參數屬性

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

參數集

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

-ToIP

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

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

參數屬性

類型:String
預設值: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

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