Get-MessageTrackingLog

 

适用于： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上一次修改主题： 2007-08-20

使用 Get-MessageTrackingLog 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>]

详细说明

唯一邮件跟踪日志存在于安装了集线器传输服务器角色、邮箱服务器角色或边缘传输服务器角色的每个计算机上。邮件跟踪日志是逗号分隔值 (CSV) 文件，其中包含有关每个电子邮件所经过的各个服务器的详细历史信息。

若要运行 Get-MessageTrackingLog cmdlet，必须为您使用的帐户委派以下角色：

• Exchange 仅查看管理员角色

若要在安装了边缘传输服务器角色的计算机上运行 Get-MessageTrackingLog cmdlet，必须使用作为该计算机上的本地 Administrators 组成员的帐户进行登录。

有关权限、角色委派以及管理 Microsoft Exchange Server 2007 所需权限的详细信息，请参阅权限注意事项。

参数

参数	必需	类型	说明
DomainController	可选	Microsoft.Exchange.Data.Fqdn	若要指定将此配置更改写入 Active Directory 目录服务域控制器的完全限定的域名 (FQDN)，需包括 DomainController 参数。
End	可选	System.DateTime	通过使用运行此 cmdlet 的计算机的区域格式，此参数将返回截至（但不包括）指定 End 日期和时间的邮件跟踪日志条目。
EventId	可选	System.String	此参数返回属于下列可能事件类别的邮件跟踪日志条目：BadMail、Defer Deliver、DSN、Expand、Fail、PoisonMessage、Receive、Redirect、Resolve、Send、Submit 和 Transfer。
InternalMessageId	可选	System.String	此参数返回具有值 InternalMessagID 的邮件跟踪日志条目。InternalMessageID 是由当前正在处理邮件的 Exchange 2007 服务器所分配的邮件标识符。 在涉及邮件传递的每个 Exchange 2007 服务器的邮件跟踪日志中，特定邮件的 InternalMessageID 值是各不相同的。
MessageId	可选	System.String	此参数返回具有指定 Message-ID 头字段的邮件跟踪日志条目。如果 Message-ID: 头字段为空或不存在，则分配一个任意值。此值在邮件生存期内保持不变。
MessageSubject	可选	System.String	此参数返回邮件的 Subject: 头字段中具有指定值的邮件跟踪日志条目。默认情况下，邮件主题存储在邮件跟踪日志中。若要禁用邮件主题的日志记录，请使用以下命令： Set-TransportServer <Identity> -MessageTrackingLogSubjectLoggingEnabled $false
Recipients	可选	System.String[]	此参数将返回具有指定收件人的简单邮件传输协议 (SMTP) 电子邮件地址的所有邮件跟踪日志条目。单个邮件中包括的多个单独收件人可通过使用单个邮件跟踪日志条目记录。未展开的通讯组收件人则通过使用通讯组的 SMTP 电子邮件地址记录。通过使用逗号作为分隔符，可以指定多个收件人值。
Reference	可选	System.String	此参数返回在 Reference 字段中具有指定值的邮件跟踪日志条目。 Reference 字段包含特定的 EventID 类型的其他信息： Send   Reference 字段包含任何发送状态通知 (DSN) 邮件的 Internet-Message-Id。 Transfer   Reference 字段包含正在被分支的邮件的 Internal-Message-Id。 DSN   Reference 字段包含导致 DSN 的邮件的 Internet-Message-Id。 对于所有其他类型的 EventID，Reference 字段为空白。
ResultSize	可选	Microsoft.Exchange.Data.Unlimited	此参数确定要显示的邮件跟踪日志条目的最大个数。默认情况下，最多显示 1,000 个条目。若要显示所有条目，请使用值 Unlimited。
Sender	可选	System.String	此参数返回具有指定发件人的 SMTP 电子邮件地址的邮件跟踪日志条目。
Server	可选	Microsoft.Exchange.Configuration.Tasks.ServerIdParameter	此参数指定包含要搜索的邮件跟踪日志的 Exchange 2007 服务器。Server 参数可以接受目标服务器的下列任何值： 名称 完全限定的域名 (FQDN) 可分辨名称 (DN) 旧版 Exchange DN GUID
Start	可选	System.DateTime	通过使用运行此 cmdlet 的计算机的区域格式，此参数返回从指定 Start 日期和时间开始的邮件跟踪日志条目。

输入类型

返回类型

错误

错误	说明

异常

异常	说明

示例

第一个示例显示如何使用 Get-MessageTrackingLog cmdlet 来检索在 03/13/06 的 9:00 AM 和 03/15/06 的 5:00 PM 之间创建的、具有 Sender 值 tbremer@contoso.com 的邮件跟踪日志条目。

注意：
在此示例中使用的日期格式是英语 (US)。可以使用在 Exchange Server 2007 计算机上配置的日期格式。所指定的日期将自动转换为 Exchange 2007 内部使用的协调世界时 (UTC) 格式，以便在邮件跟踪日志中存储条目。

第二个示例显示如何将 Get-MessageTrackingLog cmdlet 的输出通过管道传递给 Format-List cmdlet，以便查看在邮件跟踪日志中可用的其他信息。

有关管道传输的详细信息，请参阅管道传输。

有关如何处理命令输出的详细信息，请参阅使用命令输出。

Get-MessageTrackingLog -Start "03/13/2006 9:00AM" -End "03/15/2006 5:00PM" -Sender "tbremer@contoso.com"
Get-MessageTrackingLog -Start "03/13/2006 9:00AM" -End "03/15/2006 5:00PM" -Sender "tbremer@contoso.com" | Format-List