Get-MessageTraceInfo

SYNOPSIS

Retrieves message trace information based on specified criteria.

SYNTAX

Get-MessageTraceInfo [[-SenderAddress] <string[]>] [[-RecipientAddress] <string[]>]
 [[-StartDate] <datetime>] [[-EndDate] <datetime>] [[-ByConnectorName] <string>]
 [[-ByTransportRuleName] <string>] [-UsingConnector]

DESCRIPTION

This function retrieves message trace information from Exchange Online based on the specified criteria. It supports filtering by sender address, recipient address, start date, end date, connector name, transport rule name, and using connector flag.

EXAMPLES

EXAMPLE 1

Get-MessageTraceInfo -SenderAddress "john.doe@example.com" -RecipientAddress "jane.doe@example.com" -StartDate (Get-Date).AddDays(-7) -EndDate (Get-Date) -ByConnectorName "OutboundConnector" -UsingConnector

Retrieves message trace information for messages sent by “john.doe@example.com” to “jane.doe@example.com” within the last 7 days, using the “OutboundConnector” connector.

EXAMPLE 2

Get-MessageTraceInfo -RecipientAddress "jane.doe@example.com" -StartDate (Get-Date).AddDays(-30) -EndDate (Get-Date) -ByTransportRuleName "Confidential" -UsingConnector

Retrieves message trace information for messages received by “jane.doe@example.com” within the last 30 days, filtered by the “Confidential” transport rule, using a connector.

PARAMETERS

-ByConnectorName

Specifies the connector name to filter the message trace. This parameter accepts a string.

Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 4
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ByTransportRuleName

Specifies the transport rule name to filter the message trace. This parameter accepts a string.

Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 5
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-EndDate

Specifies the end date to filter the message trace. This parameter accepts a DateTime object.

Type: System.DateTime
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 3
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-RecipientAddress

Specifies the recipient address to filter the message trace. This parameter accepts a string or an array of strings. Wildcards (*) can be used to match multiple recipient addresses.

Type: System.String[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 1
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-SenderAddress

Specifies the sender address to filter the message trace. This parameter accepts a string or an array of strings. Wildcards (*) can be used to match multiple sender addresses.

Type: System.String[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-StartDate

Specifies the start date to filter the message trace. This parameter accepts a DateTime object.

Type: System.DateTime
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 2
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-UsingConnector

Specifies whether to filter the message trace using a connector. This parameter is a switch parameter.

Type: System.Management.Automation.SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

NOTES

This function requires the Exchange Online PowerShell module to be installed and connected to an Exchange Online organization. For some event, it will fail to get messagetracedetail

https://ps365.clidsys.com/docs/commands/Get-MessageTraceInfo

Getting started

Azure

Entra

Exchange

Intune

M365 Apps

Misc

MS Commerce

Share Point

Unified Logs

Get-MessageTraceInfo

SYNOPSIS

SYNTAX

DESCRIPTION

EXAMPLES

EXAMPLE 1

EXAMPLE 2

PARAMETERS

-ByConnectorName

-ByTransportRuleName

-EndDate

-RecipientAddress

-SenderAddress

-StartDate

-UsingConnector

CommonParameters

INPUTS

OUTPUTS

NOTES

​SYNOPSIS

​SYNTAX

​DESCRIPTION

​EXAMPLES

​EXAMPLE 1

​EXAMPLE 2

​PARAMETERS

​-ByConnectorName

​-ByTransportRuleName

​-EndDate

​-RecipientAddress

​-SenderAddress

​-StartDate

​-UsingConnector

​CommonParameters

​INPUTS

​OUTPUTS

​NOTES

​RELATED LINKS

SYNOPSIS

SYNTAX

DESCRIPTION

EXAMPLES

EXAMPLE 1

EXAMPLE 2

PARAMETERS

-ByConnectorName

-ByTransportRuleName

-EndDate

-RecipientAddress

-SenderAddress

-StartDate

-UsingConnector

CommonParameters

INPUTS

OUTPUTS

NOTES

RELATED LINKS