Export (0) Print
Expand All

Search-MessageTrackingReport

Applies to: Exchange Server 2010

Topic Last Modified: 2011-03-19

Use the Search-MessageTrackingReport cmdlet to find the unique message tracking report based on the search criteria provided. You can then pass this message tracking report ID to the Get-MessageTrackingReport cmdlet to get full message tracking information. For more information, see Get-MessageTrackingReport. To learn more about message tracking, see Understanding Message Tracking.


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


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

Parameter Required Type Description

Identity

Required

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

The Identity parameter specifies the name of the mailbox for whom the message tracking report is being searched. The message tracking report only contains the tracking events related to the specified mailbox.

You can use one of the following values:

  • GUID
  • Distinguished name (DN)
  • Domain\Account
  • User principal name (UPN)
  • LegacyExchangeDN
  • SmtpAddress
  • Alias

Sender

Required

System.Nullable

The Sender parameter specifies the e-mail address of the message sender.

By default, this command searches for messages sent by the user specified in the Identity parameter. If you want to search the message tracking report for a message sent to the user, you must specify the e-mail address of the sender of that message using this parameter.

BypassDelegateChecking

Optional

System.Management.Automation.SwitchParameter

The BypassDelegateChecking parameter allows Help desk staff and administrators to track messages for any user. End-users can only track messages that they send or receive.

Confirm

Optional

System.Management.Automation.SwitchParameter

The Confirm switch causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You don't have to specify a value with the Confirm switch.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to Active Directory.

DoNotResolve

Optional

System.Management.Automation.SwitchParameter

The DoNotResolve parameter prevents the resolution of e-mail addresses to display names. This improves performance, but the end result may not be as easy to interpret because it's missing the display names.

MessageEntryId

Optional

System.String

The MessageEntryId parameter is reserved for internal Microsoft use.

MessageId

Optional

System.String

The MessageId parameter specifies the Internet message ID of the message for which you want to get the tracking report.

Recipients

Optional

Microsoft.Exchange.Data.SmtpAddress[]

The Recipients parameter specifies the recipients for whom you want to get the tracking report.

ResultSize

Optional

Microsoft.Exchange.Data.Unlimited

The ResultSize parameter specifies the maximum number of results to return. If you want to return all messages that match the search criteria, use unlimited for the value of this parameter. The default value is 1000.

Subject

Optional

System.String

The Subject parameter specifies text to be used to track messages that have the specified text in their subject lines.

WhatIf

Optional

System.Management.Automation.SwitchParameter

The WhatIf switch instructs the command to simulate the actions that it would take on the object. By using the WhatIf switch, you can view what changes would occur without having to apply any of those changes. You don't have to specify a value with the WhatIf switch.

You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. To see what permissions you need, see the "Message tracking" entry in the Transport Permissions topic.

This example searches the message tracking report for messages sent from one user to another. This example returns the message tracking report for a message that David Jones sent to Wendy Richardson.

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

This example searches the message tracking report for the following scenario: The user Cigdem Akin was expecting an e-mail message from joe@contoso.com which never arrived. She contacted the Helpdesk, which needs to determine what happened. They need to generate the message tracking report on behalf of Cigdem, and they don't need to see the display names.

This example returns the message tracking reports that the Helpdesk can analyze to resolve the issue.

Search-MessageTrackingReport -Identity "Cigdem Akin" -Sender "joe@contoso.com" -BypassDelegateChecking -DoNotResolve
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft