Get-MessageTrackingLog
此 cmdlet 仅适用于本地 Exchange。
使用 Get-MessageTrackingLog cmdlet 可以搜索在邮件跟踪日志中存储的邮件传递信息。
有关以下语法部分的参数设置的详细信息，请参阅 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>]
说明
对于邮箱服务器上的传输服务、邮箱服务器上的邮箱传输服务以及在边缘传输服务器上存在一个唯一的邮件跟踪日志。 邮件跟踪日志是逗号分隔值 (CSV) 文件，其中包含有关每个电子邮件所经过的 Exchange 服务器的详细历史信息。
Get-MessageTrackingLog cmdlet 的结果中显示的字段名称类似于邮件跟踪日志中使用的实际字段名称。 差别在于：
- 字段名称中没有短划线。 例如 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 的所有参数，但如果某些参数未包含在分配给你的权限中，则可能无法访问这些参数。 若要查找在贵组织中运行任何 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。
边缘传输服务器上不支持 DomainController 参数。 边缘传输服务器使用活动目录轻型目录服务 (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 服务器分配。
在邮件传递中涉及的每个 Exchange 服务器的邮件跟踪日志中，特定邮件的 internal-message-id 值各不相同。
参数属性
| 类型: | 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 字段的值筛选邮件跟踪日志条目。 此字段包含唯一的消息 ID 值，该值在可能由于分叉或通讯组扩展而创建的消息副本之间保留。 示例值为 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 参数指定了要返回的结果的最大数量。 若要返回所有与查询相匹配的请求，则请将此参数的值设为无限制。 默认值为 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
服务器参数指定要运行此命令的Exchange服务器。 可以使用唯一标识该服务器的任何值。 例如：
- 名称
- FQDN
- 可分辨名称 (DN)
- Exchange 旧版 DN
Exchange 旧版 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
若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。