如何管理代理日志输出

项目
08/09/2014

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

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

本主题说明如何配置 EdgeTransport.exe.config 文件以管理反垃圾邮件代理日志文件。默认情况下，Microsoft Exchange Server 2007 在 %programfiles%\Microsoft\Exchange Server\TransportRoles\Logs\AgentLog 目录中记录所有反垃圾邮件代理活动。若要筛选反垃圾邮件代理日志，请使用 Get-AgentLog cmdlet。有关详细信息，请参阅Get-AgentLog。

代理日志文件的默认配置如下：

代理日志目录的最大大小：250 MB
一个代理日志文件的最大大小：10 MB
日志文件的最长期限：30 天

要点：
Exchange 2007 Service Pack 1 (SP1) 在 EdgeTransport.exe.config 应用程序配置文件中包含一些键，您可以使用它们来修改这些默认值。Exchange 2007 的正式发布 (RTM) 版本不会读取本主题中所述的键。

修改 EdgeTransport.exe.config 文件

所有对用于管理代理日志输出的配置选项的修改都必须在 EdgeTransport.exe.config 文件中进行，该文件位于 %programfiles%\Microsoft\Exchange Server\Bin 目录中。EdgeTransport.exe.config 文件是与 EdgeTransport.exe 文件关联的 XML 应用程序配置文件。EdgeTransport.exe 和 MSExchangeTransport.exe 是 Microsoft Exchange 传输服务所使用的可执行文件。此服务在每台集线器传输服务器和边缘传输服务器上运行。保存到 EdgeTransport.exe.config 文件中的更改将在重新启动 Microsoft Exchange 传输服务后得以应用。如果满足下列任何一个条件，则强制应用默认值：

缺少配置选项。
存在配置选项，其中包含默认值。

以下示例显示 EdgeTransport.exe.config 文件的典型结构：

<configuration> 
<runtime> 
<gcServer enabled="true" /> 
</runtime> 
<appSettings> 
<add key=" Configuration Option " value=" Value " />

…

</appSettings> 
</configuration>

可以在 <appSettings> 部分中添加新的配置选项或修改现有的配置选项。许多可用的配置选项与代理日志输出无关。本主题不对与代理日志输出无关的配置选项进行说明。

代理日志输出键

代理日志输出是由 EdgeTransport.exe.config 文件中的下列键进行管理的：

<add key="AgentLogEnabled" value="system.boolean" />
<add key="AgentLogMaxDirectorySize" value="system.int32" />
<add key="AgentLogMaxFileSize" value="system.int32" />
<add key="AgentLogMaxAge" value="system.timespan" />

默认情况下，EdgeTransport.exe.config 文件中只存在 AgentLogEnabled 键。您必须添加所有其他键。下表对每个键进行了详细的说明。

键	值类型	说明
`AgentLogEnabled`	System.Boolean	默认情况下，EdgeTransport.exe.config 中存在此键。其有效值为 `true` 或 `false`。默认值为 `true`。
`AgentLogMaxDirectorySize`	System.Int32	默认情况下，EdgeTransport.exe.config 中不存在此键。其值可用来指定 AgentLog 目录的最大大小（以字节为单位）。当超出该值时，将删除目录中最早的日志文件，然后再创建新的日志文件。如果未指定此值，则对于 Exchange 2007 RTM 和 Exchange 2007 SP1 来说，其默认值为 250 MB 或 262144000 字节（25010241024）。
`AgentLogMaxFileSize`	System.Int32	默认情况下，EdgeTransport.exe.config 中不存在此键。其值可用来指定目录中每个日志文件的最大大小（以字节为单位）。当日志文件达到指定大小时，将创建新的日志文件。如果未指定此值，则对于 Exchange 2007 RTM 和 Exchange 2007 SP1 来说，其默认值为 10 MB 或 10485760 字节（1010241024）。
`AgentLogMaxAge`	System.TimeSpan	默认情况下，EdgeTransport.exe.config 中不存在此键。其值可用来指定给定日志文件的最长期限。当日志文件超过此期限时，系统将删除该日志文件。此键的系统类型为 `TimeSpan.`。其值可以表示为采用 d.hh:mm:ss.ff 格式的字符串，其中 d 代表日期，hh 代表小时，mm 代表分钟，ss 代表秒，ff 代表秒的小数部分。如果未指定此值，则对于 Exchange 2007 RTM 和 Exchange 2007 SP1 来说，默认值为 30 天或 `30.00:00:00.00`。

开始之前

若要执行此步骤，必须为您使用的帐户委派下列角色：

计算机上的本地 Administrators 组的成员

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

步骤

在 EdgeTransport.exe.config 文件中添加并配置代理日志输出键

如果要在集线器传输服务器或边缘传输服务器上管理代理日志输出，请使用 ASCII 文本编辑器（如记事本）打开位于该服务器上的 EdgeTransport.exe.config。EdgeTransport.exe.config 文件位于 %programfiles%\Microsoft\Exchange Server\Bin 目录中。
定位 AgentLogEnabled 键。默认情况下，键将按照字母顺序在 <appsettings> 下列出。

将下列键复制并粘贴到 AgentLogEnabled 键下面：

<add key="AgentLogMaxDirectorySize" value="system.int32" />
<add key="AgentLogMaxFileSize" value="system.int32" />
<add key="AgentLogMaxAge" value="system.timespan" />

验证 AgentLogEnabled 键是否被设置为 true，然后为其他键添加值。
完成对 EdgeTransport.exe.config 文件的更新后，保存该文件并将其关闭。
您必须重新启动 Microsoft Exchange 传输服务，配置更改才会生效。

详细信息

有关详细信息，请参阅Get-AgentLog。