Get-AgentLog

  • 项目

 

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

上一次修改主题： 2007-06-28

使用 Get-AgentLog cmdlet，可以分析您指定为参数的日志文件，并在您指定的时间段内，通过反垃圾邮件代理应用的筛选来收集原始统计信息。

语法

Get-AgentLog [-EndDate <DateTime>] [-Location <LocalLongFullPath>] [-StartDate <DateTime>]

详细说明

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

  • 本地 Administrator 组中的成员身份

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

参数

参数 必需 类型 说明

EndDate

可选

System.DateTime

此参数指定要停止收集统计信息的日期和时间。默认时间为当前时间。输入特定的日期时，请使用在本地计算机上配置的“区域选项”设置中定义的短日期格式。例如，如果将计算机配置为使用短日期格式 mm/dd/yyyy，则指定 2006 年 3 月 1 日时请输入 03/01/2006。您可以仅输入日期，例如 10/05/2005，也可以输入日期以及当天的时间。如果输入日期以及当天的时间，则必须为该参数加上双引号，例如 "10/05/2005 5:00:00 PM"。

Location

可选

Microsoft.Exchange.Data.LocalLongFullPath

Location 参数指定包含可以用于构建使用报告的日志文件的目录。默认路径是 C:\Program Files\Microsoft\Exchange Server\TransportRoles\Logs\AgentLog。必须在输入的文件路径两旁加上双引号，例如："C:\Program Files\Microsoft\Exchange Server\TransportRoles\Logs\AgentLog"。

StartDate

可选

System.DateTime

StartDate 参数指定收集统计信息的开始日期和时间。默认时间为当前时间。输入特定的日期时，请使用在本地计算机上配置的“区域选项”设置中定义的短日期格式。例如，如果将计算机配置为使用短日期格式 mm/dd/yyyy，则指定 2006 年 3 月 1 日时请输入 03/01/2006。您可以仅输入日期，例如 10/05/2005，也可以输入日期以及当天的时间。如果输入日期以及当天的时间，则必须为该参数加上双引号，例如 "10/05/2005 5:00:00 PM"。

返回类型

对象 说明

Timestamp

日志条目的时间

ConnectorName

接收邮件的连接器的公用名

SessionId

SMTP 会话的 IP 地址

IPAddress

连接服务器的 IP 地址

MessageId

Microsoft Exchange Server 2007 邮件 ID

P1FromAddress

P1（邮件信封）From：邮件头字段

P2FromAddresses

P2（邮件头）From：邮件头字段

Recipients

邮件收件人

Agent

调用操作的代理的名称

Event

操作所针对的事件

Action

执行的操作（整数）

SmtpResponse

发送给主叫方的响应（如果有）

Reason

代理所提供的原因代码

ReasonData

代理所提供的详细说明

示例

以下代码示例返回一个报告，包含从 2005 年 10 月 5 日下午 5:00 至今所收集的统计信息。

Get-AgentLog -StartDate "10/05/2005 5:00:00 PM"