Partilhar via

Get-MessageTrackingReport

Módulo:
Exchange PowerShell

Este cmdlet está funcional apenas no Exchange no 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.

No Exchange Online, os relatórios de entrega são substituídos pelo rastreio de mensagens (os cmdlets Get-MessageTraceV2 e Get-MessageTraceDetailV2).

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Sintaxe

Default (Default) 

Get-MessageTrackingReport
    [-Identity] <MessageTrackingReportId>
    [-BypassDelegateChecking]
    [-DetailLevel <MessageTrackingDetailLevel>]
    [-DomainController <Fqdn>]
    [-DoNotResolve]
    [-RecipientPathFilter <SmtpAddress>]
    [-Recipients <String[]>]
    [-ReportTemplate <ReportTemplate>]
    [-ResultSize <Unlimited>]
    [-Status <DeliveryStatus>]
    [-TraceLevel <TraceLevel>]
    [<CommonParameters>]

Description

Este cmdlet requer o ID do relatório de controlo de mensagens que pretende ver. Por conseguinte, primeiro tem de utilizar o cmdlet Search-MessageTrackingReport para localizar o ID do relatório de controlo de mensagens para uma mensagem específica e, em seguida, transmitir os resultados para este cmdlet. Para mais informações, consulte Search-MessageTrackingReport.

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

$Temp = Search-MessageTrackingReport -Identity "David Jones" -Recipients "wendy@contoso.com"

foreach ($reportId in $Temp.MessageTrackingReportId) {
    Get-MessageTrackingReport -Identity $reportId -ReportTemplate Summary -Status Delivered
}

Este 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 controlo de mensagens para o seguinte cenário: O utilizador Cigdem Akin esperava uma mensagem de e-mail 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 procura nos dados de controlo de mensagens os relatórios de controlo de mensagens específicos e, em seguida, devolve informações detalhadas de resolução de problemas para o caminho específico do destinatário.

Parâmetros

-BypassDelegateChecking

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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 predefinição, cada utilizador só pode ver os relatórios de controlo de mensagens das mensagens que envia ou recebe da sua própria caixa de correio. Quando utiliza este comutador, pode ver os relatórios de controlo de mensagens para trocas de mensagens entre outros utilizadores.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DetailLevel

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro DetailLevel especifica a quantidade de detalhes a devolver nos resultados. Os valores válidos são:

  • Básico: são devolvidas informações simples do relatório de entrega, o que é mais adequado para os utilizadores.
  • Verboso: são devolvidas informações completas do relatório, incluindo nomes de servidor e informações de topologia física.

Propriedades do parâmetro

Tipo:MessageTrackingDetailLevel
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DomainController

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Propriedades do parâmetro

Tipo:Fqdn
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DoNotResolve

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O comutador DoNotResolve especifica se pretende impedir a resolução de endereços de e-mail para apresentar nomes. Não é preciso especificar um valor com essa opção.

A utilização deste comutador melhora o desempenho, mas a falta de nomes a apresentar pode dificultar a interpretação dos resultados.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Identity

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O parâmetro Identidade especifica o ID do relatório de controlo de mensagens que pretende ver.

Tem de executar o cmdlet Search-MessageTrackingReport para localizar o ID do relatório de controlo de mensagens para a mensagem específica que está a controlar e, em seguida, transmitir o valor do campo MessageTrackingReportID para este parâmetro.

Atenção: o valor $null ou um valor inexistente para o parâmetro Identidade devolve todos os objetos como se tivesse executado o comando Get- sem o parâmetro Identity. Verifique se as listas de valores do parâmetro Identity estão corretas e não contêm valores de $null inexistentes.

Propriedades do parâmetro

Tipo:MessageTrackingReportId
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-RecipientPathFilter

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O parâmetro RecipientPathFilter especifica o endereço de e-mail do destinatário quando utiliza o parâmetro ReportTemplate com o valor RecipientPath.

Propriedades do parâmetro

Tipo:SmtpAddress
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Recipients

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O parâmetro Destinatários especifica os endereços de e-mail dos destinatários quando utiliza o parâmetro ReportTemplate com o valor Resumo. Você pode especificar vários endereços de email separados por vírgulas.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ReportTemplate

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O parâmetro ReportTemplate especifica um formato predefinido para a saída. Os valores válidos são:

  • RecipientPath: devolve um relatório de controlo detalhado para um destinatário da mensagem. Especifique o destinatário com o parâmetro RecipientPathFilter.
  • Resumo: Devolve um resumo para todos os destinatários da mensagem. Especifique os destinatários com o parâmetro Destinatários.

Propriedades do parâmetro

Tipo:ReportTemplate
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ResultSize

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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.

Propriedades do parâmetro

Tipo:Unlimited
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Status

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O parâmetro Estado filtra os resultados pelos códigos de status de entrega especificados. Os valores válidos são:

  • Entregue:
  • Leitura
  • Pending
  • Transferido
  • Sem êxito

Propriedades do parâmetro

Tipo:_DeliveryStatus
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-TraceLevel

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro TraceLevel especifica os detalhes a incluir nos resultados. Os valores válidos são:

  • Baixo: são devolvidos dados adicionais mínimos, incluindo servidores que foram acedidos, temporização, contagens de resultados de pesquisa de controlo de mensagens e quaisquer informações de erro.
  • Médio: para além dos dados devolvidos para a definição Baixo, os resultados reais da pesquisa de controlo de mensagens também são devolvidos.
  • Alta: são devolvidos dados de diagnóstico completos.

Só precisa de utilizar este parâmetro para resolver problemas de controlo de mensagens.

Propriedades do parâmetro

Tipo:TraceLevel
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
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.

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.