Get-MessageTrackingReport

模組:
Exchange PowerShell

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

使用 Get-MessageTrackingReport Cmdlet 傳回特定郵件追蹤報告的資料。 此 Cmdlet 由傳遞報告功能使用。

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

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

語法

Default (預設值) 

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 的所有參數，但如果指派給您的權限中未包含某些參數，您可能無法存取這些參數。 若要尋找在組織中執行任何 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 Richardson 之郵件的郵件追蹤報告摘要。

範例 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

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

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

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DetailLevel

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

  • Basic：傳回簡單的遞送報表資訊，更適合使用者。
  • 詳細資訊：傳回完整的報告資訊，包括伺服器名稱和實體拓撲資訊。

參數屬性

類型:MessageTrackingDetailLevel
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DomainController

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

參數屬性

類型:Fqdn
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DoNotResolve

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

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

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Identity

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

Identity 參數會指定您要檢視的郵件追蹤報告識別碼。

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

警告： Identity 參數的值 $null 或不存在的值會傳回 所有 物件，就像您在執行 Get- 命令而不使用Identity 參數一樣。 請確認 Identity 參數的任何值清單均正確無誤，且不包含不存在的$null值。

參數屬性

類型:MessageTrackingReportId
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:1
必要:True
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-RecipientPathFilter

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

參數屬性

類型:SmtpAddress
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Recipients

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

參數屬性

類型:

String[]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ReportTemplate

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

  • RecipientPath：傳回訊息的一個收件者的詳細追蹤報告。 您可以使用 RecipientPathFilter 參數指定收件者。
  • 摘要：傳回郵件所有收件者的摘要。 您可以使用 Recipients 參數指定收件者。

參數屬性

類型:ReportTemplate
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ResultSize

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

參數屬性

類型:Unlimited
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Status

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

  • 已傳遞
  • 讀取
  • 擱置
  • 已傳輸
  • 失敗

參數屬性

類型:_DeliveryStatus
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-TraceLevel

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

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

您只需要使用此參數來疑難排解郵件追蹤問題。

參數屬性

類型:TraceLevel
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援常見參數： -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

Input types

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

輸出

Output types

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