Get-MessageTrackingLog

参考

模块:: ExchangePowerShell

适用于:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

此 cmdlet 仅适用于本地 Exchange。

使用 Get-MessageTrackingLog cmdlet 可以搜索在邮件跟踪日志中存储的邮件传递信息。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

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

边缘传输服务器上不支持 DomainController 参数。边缘传输服务器使用活动目录轻型目录服务 (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 服务器分配。

在邮件传递中涉及的每个 Exchange 服务器的邮件跟踪日志中，特定邮件的 internal-message-id 值各不相同。

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 字段的值筛选邮件跟踪日志条目。本字段包含唯一邮件 ID 值，因拆分或通讯组扩展而创建，且在各邮件副本中均保持有效。示例值为 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 参数指定了要返回的结果的最大数量。若要返回所有与查询相匹配的请求，则请将此参数的值设为无限制。默认值为 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

服务器参数指定要运行此命令的Exchange服务器。可以使用唯一标识该服务器的任何值。例如：

名称
FQDN
可分辨名称 (DN)
Exchange 旧版 DN

Exchange 旧版 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 参数指定日期范围的开始日期和时间。

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

若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。

通过