如何管理代理程式記錄輸出

  • 發行項

 

適用版本： 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 指令程式。如需相關資訊，請參閱 Get-AgentLog。

代理程式記錄檔的預設組態如下：

  • 代理程式記錄目錄的大小上限：250 MB
  • 單一代理程式記錄檔的大小上限：10 MB
  • 記錄檔的保留天數上限：30 天
important重要事項：
Exchange 2007 Service Pack 1 (SP1) 包括 EdgeTransport.exe.config 應用程式組態檔中的機碼，讓您可修改這些預設值。 Exchange 2007 的量產發行 (RTM) 版本不會讀取本主題記載的機碼。

修改 EdgeTransport.exe.config 檔

您必須在位於 %programfiles%\Microsoft\Exchange Server\Bin 目錄的 EdgeTransport.exe.config 檔中，對管理代理程式記錄輸出的組態選項進行所有修改。EdgeTransport.exe.config 檔案是與 EdgeTransport.exe 檔案關聯的 XML 應用程式組態檔。EdgeTransport.exe 及 MSExchangeTransport.exe 是 Microsoft Exchange Transport 服務所使用的可執行檔。每一個 Hub Transport Server 和 Edge Transport Server 上都會執行此服務。重新啟動 Microsoft Exchange Transport 服務之後，就會套用儲存至 EdgeTransport.exe.config 檔案的變更。如果發生下列任一狀況，將強制使用預設值：

  • 組態選項遺失。
  • 組態選項存在，並含有預設值。

下列範例顯示 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" />

依預設，只有 AgentLogEnabled 機碼會呈現在 EdgeTransport.exe.config 檔中。您必須新增所有其他機碼。下表將更詳細地說明每一個機碼。

機碼 值類型 描述

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 個位元組 (250*1024*1024)。

AgentLogMaxFileSize

System.Int32

依預設，此機碼不存在於 EdgeTransport.exe.config。此機碼的值指定目錄中每一個記錄檔的大小上限 (以位元組為單位)。當記錄檔達到指定的大小時，將建立新的記錄檔。

如果未指定此機碼，則在 Exchange 2007 RTM 及 Exchange 2007 SP1 中，預設值為 10 MB 或 10485760 個位元組 (10*1024*1024)。

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 檔中新增及設定代理程式記錄輸出機碼

  1. 在您要管理代理程式記錄輸出的 Hub Transport Server 或 Edge Transport Server 上，以 ASCII 文字編輯器 (例如 [記事本]) 開啟 EdgeTransport.exe.config。EdgeTransport.exe.config 檔位於 %programfiles%\Microsoft\Exchange Server\Bin 目錄中。

  2. 尋找 AgentLogEnabled 機碼。依預設，機碼會依字母順序列示在 <appsettings> 下方。

  3. 複製下列機碼並貼至 AgentLogEnabled 機碼下方：

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

  4. 驗證 AgentLogEnabled 機碼是否設定為 true，並新增其他機碼的值。

  5. 當更新完 EdgeTransport.exe.config 檔時，請儲存檔案並關閉它。

  6. 您必須重新啟動 Microsoft Exchange Transport 服務，組態變更才會生效。

相關資訊

如需相關資訊，請參閱 Get-AgentLog。

若要確保您目前閱讀的是最新資訊，並尋找其他的 Exchange Server 2007 說明文件，請造訪 Exchange Server 技術資源中心.