Get-MessageTraceV2
Esse cmdlet só está disponível no serviço baseado em nuvem.
Utilize o cmdlet Get-MessageTraceV2 para rastrear mensagens à medida que passam pela organização baseada na cloud.
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
Pode utilizar este cmdlet para procurar dados de mensagens nos últimos 90 dias. Se executar este cmdlet sem parâmetros, apenas são devolvidos dados das últimas 48 horas. Só pode devolver 10 dias de dados por consulta.
Por predefinição, este cmdlet devolve até 1000 resultados, com um máximo de 5000 resultados. Se os seus dados excederem o tamanho do resultado, consulte em várias rondas ou utilize intervalos StartDate e EndDate mais pequenos.
Os carimbos de data/hora na saída estão no formato de hora UTC. Pode ser diferente do formato de hora que utilizou para os parâmetros -StartDate e -EndDate.
Limite de limitação: um máximo de 100 pedidos de consulta são aceites numa janela de execução de 5 minutos. A limitação não é aplicada automaticamente se a taxa de pedido for inferior a 100 pedidos nos últimos 5 minutos
A paginação não é suportada neste cmdlet. Para consultar dados subsequentes, utilize os parâmetros StartingRecipientAddress e EndDate com os valores das propriedades Endereço do destinatário e Tempo Recebido , respetivamente, do resultado anterior na consulta seguinte.
Melhores Práticas:
- Utilize o parâmetro ResultSize para ajustar o tamanho dos resultados.
- Seja o mais preciso possível. Reduza o intervalo entre StartDate e EndDate e utilize parâmetros adicionais (por exemplo, SenderAddress) sempre que possível.
- Utilize MessageTraceId sempre que possível (necessário para mensagens enviadas para mais de 1000 destinatários).
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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 obtém informações de rastreio de mensagens para mensagens enviadas entre john@contoso.com 13 de junho de 2025 e 15 de junho de 2025.
Parâmetros
-EndDate
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
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 utilizar o formato de data abreviada MM/dd/aaaa, introduza 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 introduzir a data e 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, Suplemento de segurança incorporado para caixas de correio no local
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, Suplemento de segurança incorporado para caixas de correio no local
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 que inclui a cadeia de ID de Mensagem completa (que pode incluir parênteses 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, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro MessageTraceId filtra os resultados pelo valor do ID de rastreio de mensagens da mensagem. Este 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, Suplemento de segurança incorporado para caixas de correio no local
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, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro ResultSize especifica o número máximo de resultados a serem retornados. Um valor válido é de 1 a 5000. O valor padrão é 1000.
Nota: este 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, Suplemento de segurança incorporado para caixas de correio no local
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, Suplemento de segurança incorporado para caixas de correio no local
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 utilizar o formato de data abreviada MM/dd/aaaa, introduza 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 introduzir a data e 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, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro StartingRecipientAddress é utilizado com o parâmetro EndDate para consultar dados subsequentes para obter resultados parciais, evitando a duplicação. Consulte os dados subsequentes ao utilizar os valores Endereço do destinatário e Tempo Recebido do último registo dos resultados parciais e ao utilizá-los como valores para os parâmetros StartingRecipientAddress e EndDate, respetivamente, na consulta seguinte.
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, Suplemento de segurança incorporado para caixas de correio no local
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 mensagens 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á a aguardar status atualização.
- 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.
Pode separar múltiplos 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, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro Assunto filtra os resultados pelo assunto da mensagem. Se o valor contiver espaços, coloque-o entre aspas (").
Especifique a forma como o valor é avaliado no assunto da mensagem com 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, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro SubjectFilterType especifica a forma como o valor do parâmetro Subject é avaliado. Os valores válidos são:
- Contains
- EndsWith
- StartsWith
Recomendamos que utilize StartsWith ou EndsWith em vez de Contém 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, Suplemento de segurança incorporado para caixas de correio no local
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 suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.