Get-MessageTrackingLog

內部部署 Exchange 才有提供此 Cmdlet。

使用 Get-MessageTrackingLog 指令程式來搜尋儲存在郵件追蹤記錄中的郵件傳遞資訊。

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

Syntax

Get-MessageTrackingLog
   [-DomainController <Fqdn>]
   [-End <DateTime>]
   [-EventId <String>]
   [-InternalMessageId <String>]
   [-MessageId <String>]
   [-MessageSubject <String>]
   [-Recipients <String[]>]
   [-Reference <String>]
   [-ResultSize <Unlimited>]
   [-Sender <String>]
   [-Server <ServerIdParameter>]
   [-Start <DateTime>]
   [-NetworkMessageId <String>]
   [-Source <String>]
   [-TransportTrafficType <String>]
   [<CommonParameters>]

Description

信箱伺服器上的傳輸服務、信箱伺服器上的信箱傳輸服務以及 Edge Transport Server 都有唯一郵件追蹤記錄。 郵件追蹤記錄是逗號分隔值 (CSV) 檔案,內含每封電子郵件在遊歷 Exchange 伺服器時之歷程的詳細資訊。

顯示於來自 Get-MessageTrackingLog 指令程式結果中的欄位名稱與郵件追蹤記錄中使用的實際欄位名稱類似。 差異在於:

  • 破折號已從欄位名稱中移除。 例如,internal-message-id 將顯示為 InternalMessageId。
  • date-time 欄位將顯示為 Timestamp。
  • recipient-address 欄位將顯示為 Recipients。
  • sender-address 欄位將顯示為 Sender。

如需訊息追蹤記錄檔的詳細資訊,請參閱 訊息追蹤

您可以將輸出管線傳送至 ConvertTo-Html 或 ConvertTo-Csv,並將 > <filename> 新增至 命令,以將結果寫入檔案。 例如:Get-MessageTrackingLog -Start "03/13/2020 09:00:00" -End "03/13/2020 09:10:00" | ConvertTo-Html > "C:\My Documents\message track.html"

您必須已獲指派權限,才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數,不過,如果某些參數並未包含在指派給您的權限中,您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet

範例

範例 1

Get-MessageTrackingLog -Server Mailbox01 -Start "03/13/2018 09:00:00" -End "03/15/2018 17:00:00" -Sender "john@contoso.com"

此範例會搜尋 Mailbox01 信箱伺服器上的郵件追蹤記錄,以取得寄件者 john@contoso.com 從 2018 年 3 月 13 日 09:00 到 2018 年 3 月 15 日 17:00 傳送的所有訊息相關資訊。

參數

-DomainController

DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如,dc01.contoso.com。

Edge Transport Server 不支援 DomainController 參數。 Edge Transport Server 會使用 Active Directory 輕量型目錄服務 (AD LDS) 的本機執行個體來讀寫資料。

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-End

End 參數會指定日期範圍的結束日期與時間。 傳回郵件傳遞資訊的時間到 (但不包括) 指定的日期與時間為止。

在您要執行命令的電腦上,使用該電腦的 [地區選項] 設定中定義的簡短日期格式。 例如,如果電腦設定成使用簡短日期格式 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:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-EventId

EventId 參數將根據 EventId 欄位的值篩選郵件追蹤記錄項目。 EventId 值會分類每個訊息事件。 範例值包括 DSN、Defer、Deliver、Send、或 Receive。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-InternalMessageId

InternalMessageId 參數將根據 InternalMessageId 欄位的值篩選郵件追蹤記錄項目。 InternalMessageId 值是目前處理郵件之 Exchange 伺服器所指派的郵件識別碼。

特定郵件的 internal-message-id 值在每個與郵件傳遞相關的 Exchange 伺服器之郵件追蹤記錄中皆不同。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MessageId

MessageId 參數將根據 MessageId 欄位的值篩選郵件追蹤記錄項目。 MessageId 的值將呼應郵件中 Message-Id: 標題欄位的值。 如果 Message-ID 標頭欄位空白或不存在,則會指派任意值。 請務必包含完整的 MessageId 字串 (,其中可能包含角括弧) ,並將值以引號括住 (例如 「 d9683b4c-127b-413a-ae2e-fa7dfb32c69d@contoso.com 」) 。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MessageSubject

MessageSubject 參數將根據郵件主旨的值篩選郵件追蹤記錄項目。 MessageSubject 參數的值將在不使用萬用字元或特殊字元的情況下自動支援部分相符。 例如,若您指定 MessageSubject 值 sea,結果包括在主旨中有 Seattle 的郵件。 郵件主旨預設會儲存在郵件追蹤記錄中。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-NetworkMessageId

NetworkMessageId 參數將根據 NetworkMessageId 欄位的值篩選郵件追蹤記錄項目。 此欄位包含唯一的郵件識別碼值,會持續存在於郵件所有因為複本發送或通訊群組展開等原因而產生的副本上。 範例值是 1341ac7b13fb42ab4d4408cf7f55890f。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019

-Recipients

Recipients 參數將根據郵件收件者的 SMTP 電子郵件地址來篩選郵件追蹤記錄項目。 單一郵件中的多個收件者登入於單一郵件追蹤記錄項目記錄。 使用 SMTP 電子郵件地址,則可以記錄未展開的通訊群組收件者。 您可以指定多個以逗號隔開的收件者電子郵件地址。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Reference

Reference 參數將根據 Reference 欄位的值篩選郵件追蹤記錄項目。 Reference 欄位會包含特定事件類型的其他資訊。 例如,DSN 郵件追蹤項目的 Reference 欄位值包含形成 DSN 的郵件之 InternalMessageId 值。 對於許多事件類型而言,Reference 的值為空白。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ResultSize

ResultSize 參數會指定傳回的結果筆數上限。 若要傳回符合查詢的所有要求,請使用 unlimited 作為此參數的值。 預設值為 1000。

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Sender

Sender 參數將根據寄件者的 SMTP 電子郵件地址的值來篩選郵件追蹤記錄項目。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Server

Server 參數指定您要執行此命令的 Exchange 伺服器。 您可以使用唯一識別伺服器的任何值。 例如:

  • Name
  • FQDN
  • 辨別名稱 (DN)
  • Exchange Legacy DN

Exchange Legacy DN

Type:ServerIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Source

Source 參數將根據 Source 欄位的值篩選郵件追蹤記錄項目。 這些值表示負責郵件追蹤事件的傳輸元件。 如需詳細資訊,請參閱 Source values in the message tracking log

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019

-Start

Start 參數會指定日期範圍的開始日期與時間。

在您要執行命令的電腦上,使用該電腦的 [地區選項] 設定中定義的簡短日期格式。 例如,如果電腦設定成使用簡短日期格式 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:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-TransportTrafficType

TransportTrafficType 參數將根據 TransportTrafficType 欄位的值篩選郵件追蹤記錄項目。 不過,此欄位對內部部署 Exchange 組織來說並不有趣。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019

輸入

Input types

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

輸出

Output types

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