Get-MessageTrace

Esse cmdlet só está disponível no serviço baseado em nuvem.

Use o cmdlet Get-MessageTrace para rastrear as mensagens à medida que elas passam pela organização baseada em nuvem. Observação : Recomendamos que você use o módulo do PowerShell v2 do Exchange Online para se conectar ao PowerShell do Exchange Online. Para obter instruções, confira Conectar-se ao PowerShell do Exchange Online (https://docs.microsoft.com/powershell/exchange/connect-to-exchange-online-powershell).

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax (https://docs.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).

Syntax

Get-MessageTrace
   [-EndDate <DateTime>]
   [-Expression <Expression>]
   [-FromIP <String>]
   [-MessageId <MultiValuedProperty>]
   [-MessageTraceId <Guid>]
   [-Page <Int32>]
   [-PageSize <Int32>]
   [-ProbeTag <String>]
   [-RecipientAddress <MultiValuedProperty>]
   [-SenderAddress <MultiValuedProperty>]
   [-StartDate <DateTime>]
   [-Status <MultiValuedProperty>]
   [-ToIP <String>]
   [<CommonParameters>]

Description

Você pode usar esse cmdlet para pesquisar dados de mensagem pelos últimos 10 dias. Se você executar esse cmdlet sem nenhum parâmetro, somente os dados das últimas 48 horas serão retornados.

Se você inserir uma data de início com mais de 10 dias, receberá um erro e o comando não retornará nenhum resultado.

Para pesquisar dados de mensagens com mais de 10 dias, use os cmdlets Start-HistoricalSearch e Get-HistoricalSearch.

Este cmdlet retorna um máximo de 1 milhão resultados e será o tempo limite em consultas muito grandes. Se sua consulta retornar muitos resultados, considere dividi-lo usando intervalos menores de StartDate e EndDate.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Examples

Exemplo 1

Get-MessageTrace -SenderAddress john@contoso.com -StartDate 06/13/2018 -EndDate 06/15/2018

Este exemplo recupera as informações de rastreamento de mensagens enviadas por john@contoso.com entre 13 de junho de 2018 e 15 de junho de 2018.

Parameters

-EndDate

O parâmetro EndDate especifica a data de término do intervalo de datas.

Use o formato de data curto definido nas configurações de opções regionais no computador no qual você está executando o comando. Por exemplo, se o computador estiver configurado para usar o formato de data abreviada mm/dd/yyyy, insira 01/09/2018 para especificar 1º de setembro de 2018. Pode inserir apenas a data ou pode inserir a data e a hora do dia. Se você inserir a data e a hora do dia, coloque o valor entre aspas ("), por exemplo, "01/09/2018 17:00".

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-Expressão

Esse parâmetro está reservado para uso interno da Microsoft.

Type:Expression
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-FromIP

O parâmetro FromIP filtra os resultados pelo endereço IP de origem. Para as mensagens recebidas, o valor de FromIP é o endereço IP público do servidor de email SMTP que enviou a mensagem. Para mensagens de saída do Exchange Online, o valor está em branco.

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-MessageId

O parâmetro MessageId filtra os resultados pelo Message-ID campo do cabeçalho da mensagem. Este valor é conhecido também como ID do cliente. O formato da Message-ID depende do Messaging Server que envia a mensagem. O valor deve ser exclusivo para cada mensagem. No entanto, nem todos os Messaging Servers criam valores para o Message-ID da mesma maneira. Certifique-se de incluir a cadeia de ID de mensagem completa (que pode incluir colchetes angulares) e coloque o valor entre aspas (por exemplo, " d9683b4c-127b-413a-ae2e-fa7dfb32c69d@DM3NAM06BG401.Eop-nam06.prod.protection.outlook.com ").

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-MessageTraceId

O parâmetro MessageTraceId pode ser usado com o endereço do destinatário para identificar exclusivamente um rastreamento de mensagens e obter mais detalhes. Uma ID de rastreamento de mensagens é gerada para cada mensagem processada pelo sistema.

Type:Guid
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-Page

O parâmetro Page especifica o número de página dos resultados que você pretende exibir. A entrada válida para este parâmetro é um número inteiro entre 1 e 1000. O valor padrão é 1.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-PageSize

O parâmetro PageSize especifica o número máximo de entradas por página. A entrada válida para esse parâmetro é um número inteiro entre 1 e 5000. O valor padrão é 1000.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-ProbeTag

Esse parâmetro está reservado para uso interno da Microsoft.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-RecipientAddress

O parâmetro RecipientAddress filtra os resultados pelo endereço de email do destinatário. SPO: exSharePointOnline2ndMen

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-SenderAddress

O parâmetro SenderAddress filtra os resultados pelo endereço de email do remetente. SPO: exSharePointOnline2ndMen

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-StartDate

O parâmetro StartDate especifica a data de início do intervalo de datas.

Use o formato de data curto definido nas configurações de opções regionais no computador no qual você está executando o comando. Por exemplo, se o computador estiver configurado para usar o formato de data abreviada mm/dd/yyyy, insira 01/09/2018 para especificar 1º de setembro de 2018. Pode inserir apenas a data ou pode inserir a data e a hora do dia. Se você inserir a data e a hora do dia, coloque o valor entre aspas ("), por exemplo, "01/09/2018 17:00".

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-Status

O parâmetro Status filtra os resultados pelo status de entrega da mensagem. O parâmetro PasswordQuality especifica a classificação mínima de qualidade da senha exigida para as senhas dos dispositivo. Qualidade de senha é uma escala numérica que indica a segurança e a complexidade da senha. Um valor de qualidade mais alto indica uma senha mais segura.

  • None: A mensagem não tem status de entrega porque foi rejeitada ou redirecionada para um destinatário diferente.

  • GettingStatus: a mensagem está aguardando atualização de status.

  • Failed: Houve falha na tentativa de entrega da mensagem, ou a mensagem foi filtrada como spam ou malware, ou por regras de transporte.

  • Pending: A entrega da mensagem está a caminho ou foi adiada, e será feita uma nova tentativa.

  • Delivered: A mensagem foi entregue no seu destino.

  • Expandido: não houve entrega de mensagens porque a mensagem foi endereçada a um grupo de distribuição e a associação da distribuição foi expandida.

  • Em quarentena: a mensagem foi colocada em quarentena.

  • FilteredAsSpam: a mensagem foi marcada como spam.

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-ToIP

O parâmetro ToIP filtra os resultados pelo endereço IP de destino. Para mensagens enviadas, o valor de ToIP é o endereço IP público no registro MX resolvido para o domínio de destino. Para mensagens de entrada para o Exchange Online, o valor está em branco.

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

Inputs

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Outputs

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.