共用方式為


Get-MessageTrackingReport

此 Cmdlet 只能在內部部署 Exchange 中運作。

使用 Get-MessageTrackingReport Cmdlet 傳回特定訊息追蹤報表的數據。 傳遞報告功能會使用此 Cmdlet。

在 Exchange Online 中,傳遞報告會由訊息追蹤取代 (Get-MessageTraceV2 和 Get-MessageTraceDetailV2 Cmdlet) 。

如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法

語法

Get-MessageTrackingReport
   [-Identity] <MessageTrackingReportId>
   [-BypassDelegateChecking]
   [-DetailLevel <MessageTrackingDetailLevel>]
   [-DomainController <Fqdn>]
   [-DoNotResolve]
   [-RecipientPathFilter <SmtpAddress>]
   [-Recipients <String[]>]
   [-ReportTemplate <ReportTemplate>]
   [-ResultSize <Unlimited>]
   [-Status <DeliveryStatus>]
   [-TraceLevel <TraceLevel>]
   [<CommonParameters>]

Description

此 Cmdlet 需要您想要檢視之訊息追蹤報表的標識碼。 因此,您必須先使用 Search-MessageTrackingReport Cmdlet 來尋找特定訊息的訊息追蹤報告標識碼,然後將結果傳遞至此 Cmdlet。 如需詳細資訊,請 參閱 Search-MessageTrackingReport

您必須已獲指派權限,才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數,不過,如果某些參數並未包含在指派給您的權限中,您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet

範例

範例 1

$Temp = Search-MessageTrackingReport -Identity "David Jones" -Recipients "wendy@contoso.com"

foreach ($reportId in $Temp.MessageTrackingReportId) {
    Get-MessageTrackingReport -Identity $reportId -ReportTemplate Summary -Status Delivered
}

這個範例會取得從一位使用者傳送至另一位使用者之訊息的訊息追蹤報告。 本範例會傳回 David Jones 傳送給 Wendy 此郵件之訊息追蹤報告的摘要。

範例 2

Search-MessageTrackingReport -Identity "Cigdem Akin" -Sender "joe@contoso.com" -ByPassDelegateChecking -DoNotResolve | ForEach-Object { Get-MessageTrackingReport -Identity $_.MessageTrackingReportID -DetailLevel Verbose -BypassDelegateChecking -DoNotResolve -RecipientPathFilter "cigdem@fabrikam.com" -ReportTemplate RecipientPath }

此範例會取得下列案例的郵件追蹤報告:使用者 Cigdem Akin 預期電子郵件訊息 joe@contoso.com 從未送達。 她連絡技術支援中心,該服務台需要代表 Cigdem 產生訊息追蹤報告,而且不需要查看顯示名稱。

此範例會搜尋特定郵件追蹤報告的郵件追蹤數據,然後傳回特定收件者路徑的詳細疑難解答資訊。

參數

-BypassDelegateChecking

BypassDelegateChecking 參數可讓技術支援中心人員和系統管理員為任何使用者擷取訊息追蹤報告。 您不需要使用此參數指定值。

根據預設,每個使用者只能看到訊息追蹤報告,以取得他們從自己的信箱傳送或接收的郵件。 當您使用此參數時,您可以檢視訊息追蹤報告,以便在其他使用者之間交換訊息。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DetailLevel

DetailLevel 參數會指定要在結果中傳回的詳細數據量。 有效值為:

  • 基本:會傳回簡單傳遞報告資訊,這更適合使用者。
  • 詳細資訊:傳回完整報表資訊,包括伺服器名稱和實體拓撲資訊。
類型:MessageTrackingDetailLevel
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如,dc01.contoso.com。

類型:Fqdn
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DoNotResolve

DoNotResolve 參數會指定是否要防止電子郵件位址的解析顯示名稱。 您不需要使用此參數指定值。

使用此參數可改善效能,但缺少顯示名稱可能會讓結果更容易解譯。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Identity

Identity 參數會指定您想要檢視的訊息追蹤報表標識碼。

您必須執行 Search-MessageTrackingReport Cmdlet,以尋找所追蹤特定訊息的訊息追蹤報告標識碼,然後將 MessageTrackingReportID 欄位的值傳遞至此參數。

類型:MessageTrackingReportId
Position:1
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-RecipientPathFilter

當您使用 ReportTemplate 參數搭配 RecipientPath 值時,RecipientPathFilter 參數會指定收件者的電子郵件位址。

類型:SmtpAddress
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Recipients

當您使用 ReportTemplate 參數搭配值 Summary 時,Recipients 參數會指定收件者的電子郵件位址。 您可以指定以逗號隔開的多個電子郵件地址。

類型:String[]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ReportTemplate

ReportTemplate 參數會指定輸出的預先定義格式。 有效值為:

  • RecipientPath:傳回郵件一位收件者的詳細追蹤報告。 您可以使用 RecipientPathFilter 參數來指定收件者。
  • 摘要:傳回郵件所有收件者的摘要。 您可以使用 Recipients 參數來指定收件者。
類型:ReportTemplate
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ResultSize

ResultSize 參數會指定傳回的結果筆數上限。 若要傳回符合查詢的所有要求,請使用 unlimited 作為此參數的值。 預設值為 1000。

類型:Unlimited
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Status

Status 參數會依指定的傳遞狀態代碼來篩選結果。 有效值為:

  • 已傳遞
  • 讀取
  • 擱置
  • 轉移
  • 不成功
類型:_DeliveryStatus
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-TraceLevel

TraceLevel 參數會指定要包含在結果中的詳細數據。 有效值為:

  • 低:傳回最少的額外數據,包括已存取的伺服器、時間、追蹤搜尋結果的訊息計數,以及任何錯誤資訊。
  • 中:除了針對 [低] 設定傳回的數據之外,也會傳回實際的訊息追蹤搜尋結果。
  • 高:傳回完整診斷數據。

您只需要使用此參數來針對訊息追蹤問題進行疑難解答。

類型:TraceLevel
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

輸入

Input types

若要查看此指令程式可接受的輸入類型,請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的,表示指令程式不接受輸入資料。

輸出

Output types

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。