Get-MessageTrackingLog
內部部署 Exchange 才有提供此 Cmdlet。
使用 Get-MessageTrackingLog 指令程式來搜尋儲存在郵件追蹤記錄中的郵件傳遞資訊。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
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 的所有參數，但如果指派給您的權限中未包含某些參數，您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Get-MessageTrackingLog -Server Mailbox01 -Start "03/13/2024 09:00:00" -End "03/15/2024 17:00:00" -Sender "john@contoso.com"
本範例會在名為 Mailbox01 的信箱伺服器上搜尋郵件追蹤記錄，以尋找寄件者 john@contoso.com從 2024 年 3 月 13 日 09：00 到 2024 年 3 月 15 日 17：00 期間傳送之所有郵件的相關資訊。
範例 2
Get-MessageTrackingLog -Server Mailbox01 -Start "03/13/2024 09:00:00" -Recipients @("john@contoso.com","alice@contoso.com")
本範例會在名為 Mailbox01 的信箱伺服器上搜尋郵件追蹤記錄，以尋找從 2024 年 3 月 13 日 09：00 到今天期間傳送收件者 john@contoso.com 和/或 alice@contoso.com的所有郵件的相關資訊。
參數
-DomainController
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如，dc01.contoso.com。
Edge Transport Server 不支援 DomainController 參數。 Edge Transport Server 會使用 Active Directory 輕量型目錄服務 (AD LDS) 的本機執行個體來讀寫資料。
參數屬性
| 類型: | Fqdn |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-End
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
End 參數會指定日期範圍的結束日期與時間。 傳回郵件傳遞資訊的時間到 (但不包括) 指定的日期與時間為止。
在您要執行命令的電腦上，使用該電腦的 [地區選項] 設定中定義的簡短日期格式。 例如，如果電腦設定為使用簡短的日期格式 MM/dd/yyyy，請輸入 09/01/2018 以指定 2018 年 9 月 1 日。 您可以只輸入日期，或者也可以輸入日期和時間。 如果輸入日期和時間，請使用引號 (") 括住值，例如 "09/01/2018 5:00 PM"。
參數屬性
| 類型: | DateTime |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-EventId
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
EventId 參數將根據 EventId 欄位的值篩選郵件追蹤記錄項目。 EventId 值會將每個訊息事件分類。 範例值包括 DSN、Defer、Deliver、Send、或 Receive。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-InternalMessageId
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
InternalMessageId 參數將根據 InternalMessageId 欄位的值篩選郵件追蹤記錄項目。 InternalMessageId 值是目前處理郵件之 Exchange 伺服器所指派的郵件識別碼。
特定郵件的 internal-message-id 值在每個與郵件傳遞相關的 Exchange 伺服器之郵件追蹤記錄中皆不同。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MessageId
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
MessageId 參數將根據 MessageId 欄位的值篩選郵件追蹤記錄項目。 MessageId 的值將呼應郵件中 Message-Id: 標題欄位的值。 如果 Message-ID 標頭欄位空白或不存在，則會指派任意值。 請務必包含完整的 MessageId 字串 (，其中可能包含角括弧) 並將值括在引號中 (例如 “d9683b4c-127b-413a-ae2e-fa7dfb32c69d@contoso.com”) 。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MessageSubject
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
MessageSubject 參數將根據郵件主旨的值篩選郵件追蹤記錄項目。 MessageSubject 參數的值將在不使用萬用字元或特殊字元的情況下自動支援部分相符。 例如，若您指定 MessageSubject 值 sea，結果包括在主旨中有 Seattle 的郵件。 郵件主旨預設會儲存在郵件追蹤記錄中。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-NetworkMessageId
適用項目：Exchange Server 2016、Exchange Server 2019、Exchange Server SE
NetworkMessageId 參數將根據 NetworkMessageId 欄位的值篩選郵件追蹤記錄項目。 此欄位包含唯一的訊息識別碼值，該值會跨可能因分叉或通訊群組擴充而建立的訊息複本保留。 範例值是 1341ac7b13fb42ab4d4408cf7f55890f。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Recipients
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Recipients 參數將根據郵件收件者的 SMTP 電子郵件地址來篩選郵件追蹤記錄項目。 單一郵件中的多個收件者登入於單一郵件追蹤記錄項目記錄。 使用 SMTP 電子郵件地址，則可以記錄未展開的通訊群組收件者。 您可以使用電子郵件地址陣列指定多個收件者。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Reference
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Reference 參數將根據 Reference 欄位的值篩選郵件追蹤記錄項目。 Reference 欄位會包含特定事件類型的其他資訊。 例如，DSN 郵件追蹤項目的 Reference 欄位值包含形成 DSN 的郵件之 InternalMessageId 值。 對於許多事件類型而言，Reference 的值為空白。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ResultSize
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
ResultSize 參數會指定傳回的結果筆數上限。 若要傳回符合查詢的所有要求，請使用 unlimited 作為此參數的值。 預設值為 1000。
參數屬性
| 類型: | Unlimited |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Sender
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Sender 參數將根據寄件者的 SMTP 電子郵件地址的值來篩選郵件追蹤記錄項目。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Server
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Server 參數指定您要執行此命令的 Exchange 伺服器。 您可以使用唯一識別伺服器的任何值。 例如：
- Name
- FQDN
- 辨別名稱 (DN)
- Exchange Legacy DN
Exchange Legacy DN
參數屬性
| 類型: | ServerIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Source
適用項目：Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Source 參數將根據 Source 欄位的值篩選郵件追蹤記錄項目。 這些值表示負責郵件追蹤事件的傳輸元件。 如需詳細資訊，請參閱 Source values in the message tracking log。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Start
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Start 參數會指定日期範圍的開始日期與時間。
在您要執行命令的電腦上，使用該電腦的 [地區選項] 設定中定義的簡短日期格式。 例如，如果電腦設定為使用簡短的日期格式 MM/dd/yyyy，請輸入 09/01/2018 以指定 2018 年 9 月 1 日。 您可以只輸入日期，或者也可以輸入日期和時間。 如果輸入日期和時間，請使用引號 (") 括住值，例如 "09/01/2018 5:00 PM"。
參數屬性
| 類型: | DateTime |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-TransportTrafficType
適用項目：Exchange Server 2016、Exchange Server 2019、Exchange Server SE
TransportTrafficType 參數將根據 TransportTrafficType 欄位的值篩選郵件追蹤記錄項目。 不過，內部部署 Exchange 組織對此欄位不感興趣。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數： -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸入
Input types
若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。