Get-MessageTrace

參考

模組:: ExchangePowerShell

適用於:: Exchange Online, Exchange Online Protection

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

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

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

Syntax

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 Cmdlet。

根據預設，此 Cmdlet 會傳回最多 1000 個結果，而且會在非常大的查詢上逾時。如果您的查詢傳回太多結果，請考慮使用較小的 StartDate 和 EndDate 間隔將它分割。

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

您必須已獲指派權限，才能執行此指令程式。雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。若要尋找在組織中執行任何 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 年 6 月 13 日到 2018 年 6 月 15 日之間所傳送 john@contoso.com 訊息的訊息追蹤資訊。

參數

-EndDate

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

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

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-FromIP

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-MessageId

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

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-MessageTraceId

MessageTraceId 參數會依訊息的訊息追蹤識別碼值來篩選結果。系統 (處理的每個訊息都會產生此 GUID 值，例如 c20e0f7a-f06b-41df-fe33-08d9da155ac1) 。

MessageTraceId 值也可在下列 Cmdlet 的輸出中使用：

Get-MailDetailATPReport
Get-MailDetailDlpPolicyReport
Get-MailDetailEncryptionReport
Get-MailDetailTransportRuleReport
Get-MessageTraceDetail

Type:	Guid
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Page

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-PageSize

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-ProbeTag

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-RecipientAddress

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

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-SenderAddress

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

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-StartDate

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

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Status

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

None: 此郵件沒有傳送狀態，因其遭到拒絕或者重新導向至其他收件人。
GettingStatus：訊息正在等候狀態更新。
Failed：已嘗試郵件傳送卻失敗，或郵件遭篩選為垃圾郵件惡意軟體，或者根據傳輸規則。
Pending：郵件傳送進行中，或者已擱置並重試中。
Delivered：郵件已傳遞到其目的地。
已展開：沒有訊息傳遞，因為訊息已定址至通訊群組，且已擴充散發的成員資格。
已隔離：郵件已隔離。
FilteredAsSpam：郵件已標示為垃圾郵件。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-ToIP

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

輸入

Input types

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

輸出

Output types

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