Get-MessageTrackingReport

Módulo:: Exchange PowerShell

Esse cmdlet funciona 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.

No Exchange Online, os relatórios de entrega são substituídos pelo rastreamento 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 a ID do relatório de rastreamento de mensagens que você deseja exibir. Portanto, primeiro você precisa usar o cmdlet Search-MessageTrackingReport para localizar a ID do relatório de acompanhamento de mensagens para uma mensagem específica e, em seguida, passar os resultados para esse 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, 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"

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 rastreamento de mensagens para o seguinte cenário: O usuário Cigdem Akin estava esperando uma mensagem de email do joe@contoso.com qual 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 retorna informações detalhadas de solução de problemas para o caminho de destinatário específico.

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 controle de mensagens enviadas ou recebidas de sua própria caixa de correio. Ao usar essa opção, você pode exibir os relatórios de rastreamento de mensagens para trocas de mensagens entre outros usuários.

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

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

Básico: Informações simples do relatório de entrega são retornadas, o que é mais apropriado para os usuários.
Detalhado: informações completas do relatório são retornadas, 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

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

A opção DoNotResolve especifica se a resolução de endereços de e-mail deve ser impedida para exibir nomes. Não é preciso especificar um valor com essa opção.

O uso dessa opção melhora o desempenho, mas a falta de nomes de exibição pode tornar os resultados mais difíceis de interpretar.

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

O parâmetro Identity especifica a ID do relatório de rastreamento de mensagens que você deseja exibir.

Você precisa executar o cmdlet do Search-MessageTrackingReport para localizar a ID do relatório de acompanhamento de mensagens para a mensagem específica que está acompanhando e, em seguida, passar o valor do campo MessageTrackingReportID para esse parâmetro.

Cuidado: O valor $null ou um valor inexistente para o parâmetro Identity retorna todos os objetos como se você tivesse executado o comando Get- sem o parâmetro Identity. Verifique se todas as listas de valores para o parâmetro Identity são precisas 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

O parâmetro RecipientPathFilter especifica o endereço de email do destinatário quando você usa 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

O parâmetro Recipients especifica os endereços de email dos destinatários quando você usa o parâmetro ReportTemplate com o valor Summary. 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

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. Você especifica o destinatário usando o parâmetro RecipientPathFilter.
Resumo: Retorna um resumo para todos os destinatários da mensagem. Você especifica os destinatários usando o parâmetro Recipients.

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

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

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

Entregue:
Leitura
Pending
Transferido
Sem sucesso

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

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

Baixa: dados adicionais mínimos são retornados, incluindo servidores que foram acessados, tempo, contagens 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.
Alta: dados de diagnóstico completos são retornados.

Você só precisa usar esse parâmetro para solucionar problemas de rastreamento 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 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.

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

Esta página foi útil?