Get-MessageTraceDetailV2
Description
Pode utilizar este cmdlet para procurar dados de mensagens nos últimos 90 dias. Só pode consultar dados no valor de 10 dias por consulta. Se introduzir um período de tempo com mais de 90 dias, receberá um erro e o comando não devolve resultados.
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
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-MessageTraceDetailV2 -MessageTraceId ae5c1219-4c90-41bf-fef5-08d837917e7c -RecipientAddress robert@contoso.com
Este exemplo obtém informações detalhadas de rastreio de mensagens para mensagens com o valor de ID de rastreio de mensagens ae5c1219-4c90-41bf-fef5-08d837917e7c que foram recebidos por robert@contoso.com.
Exemplo 2
Get-MessageTraceV2 -MessageTraceId 2bbad36aa4674c7ba82f4b307fff549f -SenderAddress john@contoso.com -StartDate 06/13/2025 -EndDate 06/15/2025 | Get-MessageTraceDetailV2
Este exemplo utiliza o cmdlet Get-MessageTraceV2 para obter informações de rastreio de mensagens para mensagens com o valor 2bbad36aa4674c7ba82f4b307fff549f enviado entre john@contoso.com 13 de junho de 2025 e 15 de junho de 2025 e encaminha os resultados para o cmdlet Get-MessageTraceDetailV2.
Parâmetros
-Action
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro Ação filtra o relatório pela ação executada nas mensagens. Para ver a lista completa de valores válidos para este parâmetro, execute o comando: Get-MailFilterListReport -SelectionTarget Actions. A ação que especificar tem de corresponder ao tipo de relatório. Por exemplo, só pode especificar ações de filtro de software maligno para relatórios de software maligno.
O parâmetro Action filtra o relatório de acordo com a ação executada pelas políticas de DLP, regras de transporte, filtragem de malware ou filtragem de spam. Para exibir a lista completa de valores válidos para esse parâmetro, execute o comando Get-MailFilterListReport -SelectionTarget Actions. A ação que você especificar deve corresponder ao tipo de relatório. Por exemplo, você só pode especificar ações de filtro de malware para relatórios de malware.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| 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: | False |
| Valor dos argumentos restantes: | False |
-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".
Se não utilizar os parâmetros StartDate e EndDate, apenas são devolvidos dados das últimas 48 horas.
Propriedades do parâmetro
| Tipo: | System.DateTime |
| 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 |
-Event
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro Event filtra o relatório por evento de mensagem. Veja a seguir exemplos de eventos comuns:
- RECEBER: a mensagem foi recebida pelo serviço.
- ENVIAR: a mensagem foi enviada pelo serviço.
- FALHA: a mensagem não foi entregue.
- ENTREGA: A mensagem foi entregue numa caixa de correio.
- EXPANDIR: a mensagem foi enviada para um grupo de distribuição que foi expandido.
- TRANSFERÊNCIA: os destinatários foram movidos para uma mensagem bifurcada devido à conversão de conteúdo, limites de destinatários de mensagens ou agentes.
- DIFERIR: a entrega da mensagem foi adiada e poderá ser novamente tentada mais tarde.
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: | 3 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| 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: | String |
| 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 |
-MessageTraceId
Aplicável: Exchange Online
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).
Propriedades do parâmetro
| Tipo: | Guid |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 5 |
| Obrigatório: | True |
| 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.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 6 |
| Obrigatório: | True |
| 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: | String |
| 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".
Se não utilizar os parâmetros StartDate e EndDate, apenas são devolvidos dados das últimas 48 horas.
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 |
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.