Get-MessageTrackingLog

 

適用版本: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上次修改主題的時間: 2007-08-20

使用 Get-MessageTrackingLog 指令程式,可以搜尋儲存在郵件追蹤記錄中的郵件資訊。

語法

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>]

詳細描述

唯一郵件追蹤記錄會存在於每個已安裝 Hub Transport server role、Mailbox server role 或 Edge Transport server role 的電腦上。郵件追蹤記錄是逗號分隔值 (CSV) 檔案,內含每封電子郵件在遊歷個別伺服器時之歷程的詳細資訊。

若要執行 Get-MessageTrackingLog 指令程式,必須對您使用的帳戶委派下列項目:

  • Exchange 僅檢視管理角色

若要在已安裝 Edge Transport server role 的電腦上執行 Get-MessageTrackingLog 指令程式,則必須使用屬於該電腦之本機 Administrators 群組成員的帳戶進行登入。

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

參數

參數 必要 類型 描述

DomainController

選用

Microsoft.Exchange.Data.Fqdn

若要指定將此組態變更寫入至 Active Directory 目錄服務之網域控制站的網域全名 (FQDN),請加入 DomainController 參數。

End

選用

System.DateTime

此參數會使用執行指令程式之電腦的地區格式,傳回到達但不包含指定 End 日期及時間的郵件追蹤記錄項目。

EventId

選用

System.String

此參數傳回具有下列可能事件類別的郵件追蹤記錄項目:BadMailDefer DeliverDSNExpandFailPoisonMessageReceiveRedirectResolveSendSubmitTransfer

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

此參數會使用執行指令程式之電腦的地區格式,傳回以所指定 Start 日期及時間開始的郵件追蹤記錄項目。

輸入類型

傳回類型

錯誤

錯誤 描述

 

 

例外狀況

例外狀況 描述

 

 

範例

第一個範例顯示如何使用 Get-MessageTrackingLog 指令程式來擷取郵件追蹤記錄項目,而這些項目是在 2006 年 3 月 13 日早上 9:00 與 2006 年 3 月 15 日下午 5:00 之間建立的而且 Sender 值為 tbremer@contoso.com。

note附註:
在此範例中使用的日期格式是美式英文。請使用在 Exchange Server 2007 電腦上所設定的日期格式。所指定的日期會自動轉換成 Coordinated Universal Time (UTC) 格式,而 Exchange 2007 會內部使用此格式來儲存郵件追蹤記錄中的項目。

第二個範例顯示如何將 Get-MessageTrackingLog 指令程式的輸出以管線傳輸至 Format-List 指令程式,以檢視可在郵件追蹤記錄中取得的其他資訊。

如需管線的相關資訊,請參閱管線

如需如何處理命令輸出的相關資訊,請參閱使用命令列輸出

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

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