Get-MessageTraceV2
Esse cmdlet só está disponível no serviço baseado em nuvem.
Use o cmdlet Get-MessageTraceV2 para rastrear mensagens à medida que elas passam pela organização baseada em nuvem.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
Get-MessageTraceV2
[[-EndDate] <System.DateTime>]
[[-FromIP] <String>]
[[-MessageId] <MultiValuedProperty>]
[[-MessageTraceId] <System.Guid>]
[[-RecipientAddress] <MultiValuedProperty>]
[[-ResultSize] <Int32>]
[[-SenderAddress] <MultiValuedProperty>]
[[-StartDate] <System.DateTime>]
[[-StartingRecipientAddress] <String>]
[[-Status] <MultiValuedProperty>]
[[-SubjectFilterType] <String>]
[[-Subject] <String>]
[[-ToIP] <String>]
[<CommonParameters>]
Description
Você pode usar esse cmdlet para pesquisar dados de mensagens dos últimos 90 dias. Se você executar esse cmdlet sem parâmetros, somente os dados das últimas 48 horas serão retornados. Você só pode retornar dados de 10 dias por consulta.
Por padrão, esse cmdlet retorna até 1000 resultados, com um máximo de 5000 resultados. Se os dados excederem o tamanho do resultado, consulte em várias rodadas ou use intervalos menores de DataInício e DataTérmino.
Os carimbos de data/hora na saída estão no formato de hora UTC. Esse formato de hora pode ser diferente do formato de hora usado para os parâmetros -StartDate e -EndDate.
Limite de limitação: no máximo 100 solicitações de consulta são aceitas em uma janela de execução de 5 minutos. A limitação não será aplicada automaticamente se a taxa de solicitação for inferior a 100 solicitações nos últimos 5 minutos
Não há suporte para a paginação neste cmdlet. Para consultar dados subsequentes, use os parâmetros StartingRecipientAddress e EndDate com os valores das propriedades Endereço do destinatário e Hora de recebimento , respectivamente, do resultado anterior na próxima consulta.
Melhores práticas:
- Use o parâmetro ResultSize para ajustar o tamanho dos resultados.
- Seja o mais preciso possível. Reduza a lacuna entre StartDate e EndDate e use parâmetros adicionais (por exemplo, SenderAddress) sempre que possível.
- Use MessageTraceId sempre que possível (necessário para mensagens enviadas a mais de 1.000 destinatários).
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo 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.
Exemplos
Exemplo 1
Get-MessageTraceV2 -SenderAddress john@contoso.com -StartDate 06/13/2025 -EndDate 06/15/2025
Este exemplo recupera informações de rastreamento de mensagens enviadas entre john@contoso.com 13 de junho de 2025 e 15 de junho de 2025.
Parâmetros
-EndDate
Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais
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/aaaa, insira 01/09/2025 para especificar 1º de setembro de 2025. 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/2025 17:00".
Propriedades do parâmetro
| Tipo: | System.DateTime |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-FromIP
Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais
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.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 2 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-MessageId
Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais
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 caracteres completa da ID da mensagem (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").
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 3 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-MessageTraceId
Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais
O parâmetro MessageTraceId filtra os resultados pelo valor da ID de rastreamento de mensagem da mensagem. Esse valor GUID é gerado para cada mensagem processada pelo sistema (por exemplo, c20e0f7a-f06b-41df-fe33-08d9da155ac1).
O valor MessageTraceId também está disponível na saída dos seguintes cmdlets:
- Get-MailDetailATPReport
- Get-MailDetailDlpPolicyReport
- Get-MailDetailEncryptionReport
- Get-MailDetailTransportRuleReport
- Get-MessageTraceDetailV2
Propriedades do parâmetro
| Tipo: | System.Guid |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 4 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-RecipientAddress
Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais
O parâmetro RecipientAddress filtra os resultados pelo endereço de email do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 5 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-ResultSize
Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais
O parâmetro ResultSize especifica o número máximo de resultados a serem retornados. Um valor válido vai de 1 a 5000. O valor padrão é 1000.
Observação: esse parâmetro substitui o parâmetro PageSize que estava disponível no cmdlet Get-MessageTrace.
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | 0 |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 6 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-SenderAddress
Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais
O parâmetro SenderAddress filtra os resultados pelo endereço de email do remetente. Vários valores, separados por vírgulas, podem ser especificados.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 7 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-StartDate
Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais
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/aaaa, insira 01/09/2025 para especificar 1º de setembro de 2025. 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/2025 17:00".
Propriedades do parâmetro
| Tipo: | System.DateTime |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 8 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-StartingRecipientAddress
Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais
O parâmetro StartingRecipientAddress é usado com o parâmetro EndDate para consultar dados subsequentes para obter resultados parciais, evitando a duplicação. Consulte os dados subsequentes pegando os valores Endereço do destinatário e Hora de recebimento do último registro dos resultados parciais e usando-os como os valores para os parâmetros StartingRecipientAddress e EndDate, respectivamente, na próxima consulta.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 9 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Status
Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais
O parâmetro Status filtra os resultados pelo status de entrega da mensagem. Os valores válidos são:
- Delivered: A mensagem foi entregue no seu destino.
- Expandido: Não houve entrega de mensagem porque a mensagem foi endereçada a um grupo de distribuição e a associação da distribuição foi expandida.
- Falha: A entrega da mensagem foi tentada e falhou.
- FilteredAsSpam: A mensagem foi marcada como spam.
- GettingStatus: a mensagem está aguardando atualização de status.
- Pending: A entrega da mensagem está a caminho ou foi adiada, e será feita uma nova tentativa.
- Em quarentena: a mensagem foi colocada em quarentena.
Você pode separar vários valores separados por vírgulas.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 10 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Subject
Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais
O parâmetro Subject filtra os resultados por assunto da mensagem. Se o valor contiver espaços, coloque-o entre aspas (").
Você especifica como o valor é avaliado no assunto da mensagem usando o parâmetro SubjectFilterType.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 11 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-SubjectFilterType
Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais
O parâmetro SubjectFilterType especifica como o valor do parâmetro Subject é avaliado. Os valores válidos são:
- Contains
- Termina com
- Começa com
É recomendável usar StartsWith ou EndsWith em vez de Contains sempre que possível.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 12 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-ToIP
Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais
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.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 13 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.