Search-MessageTrackingReport

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

使用 Search-MessageTrackingReport Cmdlet,根據提供的搜尋準則,尋找唯一的郵件追蹤報告。 然後,您可以將此郵件追蹤報告識別碼傳遞給 Get-MessageTrackingReport Cmdlet,以取得完整的郵件追蹤資訊。 如需詳細資訊,請參閱 Get-MessageTrackingReport。 郵件追蹤報告 Cmdlet 是由「傳遞報告」功能使用。

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

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

語法

SearchAsSender

Search-MessageTrackingReport
    [-Identity] <MailboxIdParameter>
    -Sender <SmtpAddress>
    [-BypassDelegateChecking]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-DoNotResolve]
    [-MessageEntryId <String>]
    [-MessageId <String>]
    [-ResultSize <Unlimited>]
    [-Subject <String>]
    [-TraceLevel <TraceLevel>]
    [-WhatIf]
    [<CommonParameters>]

SearchAsRecipient

Search-MessageTrackingReport
    [-Identity] <MailboxIdParameter>
    [-Recipients <SmtpAddress[]>]
    [-BypassDelegateChecking]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-DoNotResolve]
    [-MessageEntryId <String>]
    [-MessageId <String>]
    [-ResultSize <Unlimited>]
    [-Subject <String>]
    [-TraceLevel <TraceLevel>]
    [-WhatIf]
    [<CommonParameters>]

Description

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

範例

範例 1

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

此範例會搜尋訊息追蹤報告,尋找從某個使用者傳送給另一個使用者的訊息。 此範例會傳回 David Jones 傳送給 Wendy Richardson 之郵件的郵件追蹤報告。

範例 2

Search-MessageTrackingReport -Identity "Cigdem Akin" -Sender "joe@contoso.com" -BypassDelegateChecking -DoNotResolve

此範例會搜尋下列案例的郵件追蹤報告:使用者 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

-Confirm

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

Confirm 參數會指定要顯示或隱藏確認提示。 此參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續。

  • 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停,它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet,您可以使用以下確切語法來略過確認提示:-Confirm:$false。
  • 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 針對這些 Cmdlet,指定不帶值的 Confirm 參數會造成暫停,強制您在繼續之前先確認命令。

參數屬性

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

參數集

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

-DomainController

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

此參數僅適用於內部部署 Exchange。

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 參數會將搜尋範圍限定為指定的信箱。 您可以使用可唯一識別信箱的任何值。 例如:

  • 名稱
  • 別名
  • 辨別名稱 (DN)
  • 辨別名稱 (DN)
  • 網域\使用者名稱
  • 電子郵件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 使用者識別碼或使用者主要名稱 (UPN)

當您在不使用 [寄件者] 參數的情況下使用此參數時,指定的信箱就是搜尋中使用的郵件寄件者。 您可以使用 Recipients 參數來指定收件者。

當您將此參數與 [寄件者] 參數搭配使用時,指定的信箱就是搜尋中使用的郵件收件者。

參數屬性

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

參數集

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

-MessageEntryId

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

將保留此參數供 Microsoft 內部使用。

參數屬性

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

參數集

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

-MessageId

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

MessageId 參數會依郵件的 Message-ID 標頭欄位來篩選結果。 此值也稱為「用戶端識別碼」。 Message-ID 的格式取決於傳送郵件的訊息伺服器。 每封郵件都僅具有唯一值。 然而,並非所有訊息伺服器都使用相同的方法來建立 Message-ID 的值。 請務必包含完整的訊息識別碼字串 (,其中可能包含尖括弧) 並將值括在引號中 (例如 “d9683b4c-127b-413a-ae2e-fa7dfb32c69d@contoso.com”) 。

參數屬性

類型:String
預設值: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

收件者參數會依指定收件者的電子郵件地址篩選結果。 您可以指定以逗號隔開的多個電子郵件地址。

您無法將此參數與 Sender 參數搭配使用。

參數屬性

類型:

SmtpAddress[]

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

參數集

SearchAsRecipient
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

-Sender

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

Sender 參數會指定傳送至由 Identity 參數所指定信箱之郵件的郵件寄件者的電子郵件地址。

您必須將此參數與 Identity 參數搭配使用。

參數屬性

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

參數集

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

-Subject

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

[主旨] 參數會搜尋具有指定 [主旨] 欄位值的郵件。 如果值包含空格,請以半形雙引號括住值。

參數屬性

類型:String
預設值: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

-WhatIf

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

WhatIf 參數會顯示命令在不進行任何變更的情況下執行的動作。 您不需要使用此參數指定值。

參數屬性

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

參數集

(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

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