Get-MessageTrackingReport
Esse cmdlet é funcional somente no Exchange local.
Use o cmdlet Get-MessageTrackingReport para retornar os dados de um relatório de controle de mensagens específico. Esse cmdlet é usado pelo recurso de relatórios de entrega.
Em Exchange Online, os relatórios de entrega foram substituídos pelo rastreamento de mensagens (os cmdlets Get-MessageTrace e Get-MessageTraceDetail).
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Syntax
Get-MessageTrackingReport
[-Identity] <MessageTrackingReportId>
[-BypassDelegateChecking]
[-DetailLevel <MessageTrackingDetailLevel>]
[-DomainController <Fqdn>]
[-DoNotResolve]
[-RecipientPathFilter <SmtpAddress>]
[-Recipients <String[]>]
[-ReportTemplate <ReportTemplate>]
[-ResultSize <Unlimited>]
[-Status <DeliveryStatus>]
[-TraceLevel <TraceLevel>]
[<CommonParameters>] Description
Esse cmdlet requer a ID do relatório de acompanhamento de mensagens que você deseja exibir. Portanto, primeiro você precisa usar o cmdlet Search-MessageTrackingReport para encontrar a ID do relatório de acompanhamento de mensagens para uma mensagem específica e, em seguida, passar os resultados para este cmdlet. Para mais informações, consulte Search-MessageTrackingReport.
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.
Exemplos
Exemplo 1
$Temp = Search-MessageTrackingReport -Identity "David Jones" -Recipients "wendy@contoso.com"
Get-MessageTrackingReport -Identity $Temp.MessageTrackingReportID -ReportTemplate SummaryEste exemplo obtém o relatório de controle de mensagens para mensagens enviadas de um usuário para outro. Este exemplo retorna o resumo do relatório de controle de mensagens para uma mensagem que David Jones enviou para Wendy Richardson.
Exemplo 2
Search-MessageTrackingReport -Identity "Cigdem Akin" -Sender "joe@contoso.com" -ByPassDelegateChecking -DoNotResolve | ForEach-Object { Get-MessageTrackingReport -Identity $_.MessageTrackingReportID -DetailLevel Verbose -BypassDelegateChecking -DoNotResolve -RecipientPathFilter "cigdem@fabrikam.com" -ReportTemplate RecipientPath }Este exemplo obtém o relatório de acompanhamento de mensagens para o seguinte cenário: O usuário Cigdem Akin estava esperando uma mensagem de email que joe@contoso.com nunca chegou. Ela entrou em contato com o suporte técnico, que precisa gerar a o relatório de acompanhamento de mensagens em nome de Cidgem e não precisa ver os nomes para exibição.
Este exemplo pesquisa os dados de rastreamento de mensagens para os relatórios de rastreamento de mensagens específicos e, em seguida, retorna informações detalhadas de solução de problemas para o caminho específico do destinatário.
Parâmetros
-BypassDelegateChecking
A opção BypassDelegateChecking permite que o pessoal de suporte técnico e os administradores recuperem relatórios de controle de mensagens para qualquer usuário. Não é preciso especificar um valor com essa opção.
Por padrão, cada usuário só pode ver os relatórios de acompanhamento de mensagens para mensagens enviadas ou recebidas de sua própria caixa de correio. Ao usar essa opção, você pode exibir os relatórios de acompanhamento de mensagens para trocas de mensagens entre outros usuários.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DetailLevel
O parâmetro DetailLevel especifica a quantidade de detalhes a serem retornados nos resultados. Os valores válidos são:
- Básico: informações de relatório de entrega simples são retornadas, o que é mais apropriado para os usuários.
- Verbose: as informações completas do relatório são retornadas, incluindo nomes de servidor e informações de topologia física.
| Type: | MessageTrackingDetailLevel |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DoNotResolve
A opção DoNotResolve especifica se deve impedir a resolução de endereços de email para exibir nomes. Não é preciso especificar um valor com essa opção.
Usar essa opção melhora o desempenho, mas a falta de nomes de exibição pode dificultar a interpretação dos resultados.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Identity
O parâmetro Identidade especifica a ID do relatório de acompanhamento de mensagens que você deseja exibir.
Você precisa executar o cmdlet Search-MessageTrackingReport para encontrar a ID do relatório de acompanhamento de mensagens para a mensagem específica que você está rastreando e, em seguida, passar o valor do campo MessageTrackingReportID para esse parâmetro.
| Type: | MessageTrackingReportId |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-RecipientPathFilter
O parâmetro RecipientPathFilter especifica o endereço de email do destinatário quando você usa o parâmetro ReportTemplate com o valor RecipientPath.
| Type: | SmtpAddress |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Recipients
O parâmetro Destinatários especifica os endereços de email dos destinatários quando você usa o parâmetro ReportTemplate com o resumo do valor. Você pode especificar vários endereços de email separados por vírgulas.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ReportTemplate
O parâmetro ReportTemplate especifica um formato predefinido para a saída. Os valores válidos são:
- RecipientPath: retorna um relatório de acompanhamento detalhado para um destinatário da mensagem. Especifique o destinatário usando o parâmetro RecipientPathFilter.
- Resumo: retorna um resumo para todos os destinatários da mensagem. Especifique os destinatários usando o parâmetro Destinatários.
| Type: | ReportTemplate |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ResultSize
O parâmetro ResultSize especifica o número máximo de resultados a serem retornados. Caso pretenda retornar todas as solicitações correspondentes à consulta, use unlimited como valor desse parâmetro. O valor padrão é 1000.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Status
O parâmetro Status filtra os resultados pelos códigos de status de entrega especificados. Os valores válidos são:
- Entregue:
- Ler
- Pending
- Transferido
- Malsucedido
| Type: | _DeliveryStatus |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-TraceLevel
O parâmetro TraceLevel especifica os detalhes a serem incluídos nos resultados. Os valores válidos são:
- Baixo: dados adicionais mínimos são retornados, incluindo servidores que foram acessados, tempo, contagem de resultados de pesquisa de rastreamento de mensagens e qualquer informação de erro.
- Médio: além dos dados retornados para a configuração Baixa, os resultados reais da pesquisa de rastreamento de mensagens também são retornados.
- Alto: os dados de diagnóstico completos são retornados.
Você só precisa usar esse parâmetro para solucionar problemas de rastreamento de mensagens.
| Type: | TraceLevel |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
Entradas
Input types
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.
Saídas
Output types
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.
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários