Get-MessageTrackingReport

  • 參考
模組:
ExchangePowerShell
適用於:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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

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

在Exchange Online中，傳遞報告已由訊息追蹤取代 (Get-MessageTrace和Get-MessageTraceDetail Cmdlet) 。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

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"

Get-MessageTrackingReport -Identity $Temp.MessageTrackingReportID -ReportTemplate Summary

這個範例會取得從一位使用者傳送至另一位使用者之訊息的訊息追蹤報告。 本範例會傳回 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 參數可讓技術支援中心人員和系統管理員為任何使用者擷取訊息追蹤報告。 您不需要使用此參數指定值。

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DetailLevel

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

  • 基本：會傳回簡單傳遞報告資訊，這更適合使用者。
  • 詳細資訊：傳回完整報表資訊，包括伺服器名稱和實體拓撲資訊。
Type:MessageTrackingDetailLevel
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

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

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DoNotResolve

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Identity

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

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

Type:MessageTrackingReportId
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-RecipientPathFilter

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

Type:SmtpAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Recipients

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ReportTemplate

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

  • RecipientPath：傳回郵件一位收件者的詳細追蹤報告。 您可以使用 RecipientPathFilter 參數來指定收件者。
  • 摘要：傳回郵件所有收件者的摘要。 您可以使用 Recipients 參數來指定收件者。
Type:ReportTemplate
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ResultSize

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

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Status

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

  • 已傳遞
  • 讀取
  • 擱置
  • 轉移
  • 失敗
Type:_DeliveryStatus
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-TraceLevel

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

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

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

Type:TraceLevel
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

輸入

Input types

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

輸出

Output types

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