Get-AgentLog (RTM)

 

適用版本： Exchange Server 2007

上次修改主題的時間： 2007-06-06

使用 Get-AgentLog 指令程式來剖析您指定為參數的記錄檔，並從反垃圾郵件代理程式套用的篩選中，在您指定的期間收集原始統計資料。

語法

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

詳細描述

若要執行 Get-AgentLog 指令程式，必須對您使用的帳戶委派下列各項：

• 本機 Administrators 群組的成員資格

如需管理 Microsoft Exchange Server 2007 所需之權限、委派角色及權利的相關資訊，請參閱權限考量。

參數

參數	必要	類型	描述
EndDate	選用	System.DateTime	此參數指定您要停止收集統計資料的日期和時間。預設時間是目前時間。輸入特定日期時，請使用本機電腦上設定之 [地區選項] 設定中所定義的簡短日期格式。例如，若電腦設成使用簡短日期格式 mm/dd/yyyy，請輸入 03/01/2006 以指定 2006 年 3 月 1 日。您可以只輸入日期，例如 10/05/2005。或者，您可以輸入日期和時間。如果輸入時間及日期，則必須用雙引號括住該引數，例如 "10/05/2005 5:00:00 PM"。
位置	選用	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，請輸入 03/01/2006 以指定 2006 年 3 月 1 日。您可以只輸入日期，例如 10/05/2005，或者，您可以輸入日期和時間。如果輸入時間及日期，則必須用雙引號括住該引數，例如 "10/05/2005 5:00:00 PM"。

傳回類型

物件	描述
Timestamp	記錄項目的時間
ConnectorName	接收郵件之連接器的 CN
SessionId	SMTP 工作階段 IP 位址
IPAddress	連接伺服器的 IP 位址。
MessageId	Microsoft Exchange Server 2007 郵件識別碼
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"

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