Commands › Exchange Online

Get-MessageTrackingReport

Exchange Online ExchangeOnlineManagement Get-*

This cmdlet is functional only in on-premises Exchange. Use the Get-MessageTrackingReport cmdlet to return data for a specific message tracking report. This cmdlet is used by the delivery reports feature. In Exchange Online, delivery reports are replaced by message trace (the Get-MessageTraceV2 and Get-MessageTraceDetailV2 cmdlets).

Quick start script

# Get-MessageTrackingReport — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-ExchangeOnline -CertificateThumbprint $thumb -AppId $appId -Organization $org

# 2. Run and inspect
Get-MessageTrackingReport -Identity <MessageTrackingReportId> | Format-List

# 3. Export for evidence / drift tracking
Get-MessageTrackingReport | Export-Clixml .\MessageTrackingReport-$(Get-Date -Format yyyyMMdd).xml

Syntax

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

Parameters (11)

Parameter	Type	Required	What it controls
-Identity	MessageTrackingReportId	yes	The Identity parameter specifies the message tracking report ID that you want to view.
-BypassDelegateChecking	SwitchParameter		The BypassDelegateChecking switch allows Help desk staff and administrators to retrieve message tracking reports for any user. You don't need to specify a value with this switch.
-DetailLevel	MessageTrackingDetailLevel		The DetailLevel parameter specifies the amount of detail to return in the results. Valid values are:
-DomainController	Fqdn		The DomainController parameter specifies the domain controller that's used by this cmdlet to read data from or write data to Active Directory. You identify the domain controller by its fully qualified domain name...
-DoNotResolve	SwitchParameter		The DoNotResolve switch specifies whether to prevent the resolution of email addresses to display names. You don't need to specify a value with this switch.
-RecipientPathFilter	SmtpAddress		The RecipientPathFilter parameter specifies the email address of the recipient when you use the ReportTemplate parameter with the value RecipientPath.
-Recipients	String[]		The Recipients parameter specifies the email addresses of the recipients when you use the ReportTemplate parameter with the value Summary. You can specify multiple email addresses separated by commas.
-ReportTemplate	ReportTemplate		The ReportTemplate parameter specifies a predefined format for the output. Valid values are:
-ResultSize	Unlimited		The ResultSize parameter specifies the maximum number of results to return. If you want to return all requests that match the query, use unlimited for the value of this parameter. The default value is 1000.
-Status	_DeliveryStatus		The Status parameter filters the results by the specified delivery status codes. Valid values are:
-TraceLevel	TraceLevel		The TraceLevel parameter specifies the details to include in the results. Valid values are:

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.