Get-MessageTrackingLog
適用於: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1 主題上次修改時間: 2007-08-20
使用 Get-MessageTrackingLog cmdlet 可以搜索在郵件跟蹤日誌中存儲的郵件信息。
語法
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>]
參數
參數 |
必 需 |
類型 |
說明 |
DomainController |
可選 |
Microsoft.Exchange.Data.Fqdn |
若要指定將此配置更改寫入 Active Directory 目錄服務域控制器的完全限定的域名 (FQDN),需包括 DomainController 參數。 |
End |
可選 |
System.DateTime |
通過使用運行此 cmdlet 的計算機的區域格式,此參數將返回截至(但不包括)指定 End 日期和時間的郵件跟蹤日誌條目。 |
EventId |
可選 |
System.String |
此參數返回屬於下列可能事件類別的郵件跟蹤日誌條目:BadMail、Defer Deliver、DSN、Expand、Fail、PoisonMessage、Receive、Redirect、Resolve、Send、Submit 和 Transfer。 |
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 類型的其他信息:
對於所有其他類型的 EventID,Reference 字段爲空白。 |
ResultSize |
可選 |
Microsoft.Exchange.Data.Unlimited |
此參數確定要顯示的郵件跟蹤日誌條目的最大個數。默認情況下,最多顯示 1,000 個條目。若要顯示所有條目,請使用值 Unlimited。 |
Sender |
可選 |
System.String |
此參數返回具有指定發件人的 SMTP 電子郵件地址的郵件跟蹤日誌條目。 |
Server |
可選 |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
此參數指定包含要搜索的郵件跟蹤日誌的 Exchange 2007 服務器。Server 參數可以接受目標服務器的下列任何值:
|
Start |
可選 |
System.DateTime |
通過使用運行此 cmdlet 的計算機的區域格式,此參數返回從指定 Start 日期和時間開始的郵件跟蹤日誌條目。 |
詳細說明
唯一郵件跟蹤日誌存在於安裝了集線器傳輸服務器角色、郵箱服務器角色或邊緣傳輸服務器角色的每個計算機上。郵件跟蹤日誌是逗號分隔值 (CSV) 文件,其中包含有關每個電子郵件所經過的各個服務器的詳細歷史信息。
若要運行 Get-MessageTrackingLog cmdlet,必須爲您使用的帳戶委派以下角色:
- Exchange 僅查看管理員角色
若要在安裝了邊緣傳輸服務器角色的計算機上運行 Get-MessageTrackingLog cmdlet,必須使用作爲該計算機上的本地 Administrators 組成員的帳戶進行登錄。
有關權限、角色委派以及管理 Microsoft Exchange Server 2007 所需權限的詳細信息,請參閱權限注意事項。
輸入類型
返回類型
錯誤
錯誤 |
說明 |
|
|
異常
異常 |
說明 |
|
|
示例
第一個示例顯示如何使用 Get-MessageTrackingLog cmdlet 來檢索在 03/13/06 的 9:00 AM 和 03/15/06 的 5:00 PM 之間創建的、具有 Sender 值 [email protected] 的郵件跟蹤日誌條目。
注意: |
在此示例中使用的日期格式是英語 (US)。可以使用在 Exchange Server 2007 計算機上配置的日期格式。所指定的日期將自動轉換爲 Exchange 2007 內部使用的協調世界時 (UTC) 格式,以便在郵件跟蹤日誌中存儲條目。 |
第二個示例顯示如何將 Get-MessageTrackingLog cmdlet 的輸出通過管道傳遞給 Format-List cmdlet,以便查看在郵件跟蹤日誌中可用的其他信息。
有關管道傳輸的詳細信息,請參閱管道傳輸。
有關如何處理命令輸出的詳細信息,請參閱使用命令輸出。
Get-MessageTrackingLog -Start "03/13/2006 9:00AM" -End "03/15/2006 5:00PM" -Sender "[email protected]"
Get-MessageTrackingLog -Start "03/13/2006 9:00AM" -End "03/15/2006 5:00PM" -Sender "[email protected]" | Format-List