Compartilhar via


Search-MessageTrackingReport

Esse cmdlet é funcional somente no Exchange local.

Use o cmdlet Search-MessageTrackingReport para localizar o relatório de controle de mensagens exclusivo com base nos critérios de pesquisa fornecidos. Em seguida, o ID desse relatório de controle de mensagens pode ser passado para o cmdlet Get-MessageTrackingReport para obter informações de controle de mensagens completas. Para mais informações, consulte Get-MessageTrackingReport. As cmdlets de relatório de acompanhamento de mensagens são usados pela 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

Search-MessageTrackingReport
      [-Identity] <MailboxIdParameter>
      -Sender <SmtpAddress>
      [-BypassDelegateChecking]
      [-Confirm]
      [-DomainController <Fqdn>]
      [-DoNotResolve]
      [-MessageEntryId <String>]
      [-MessageId <String>]
      [-ResultSize <Unlimited>]
      [-Subject <String>]
      [-TraceLevel <TraceLevel>]
      [-WhatIf]
      [<CommonParameters>]
Search-MessageTrackingReport
      [-Identity] <MailboxIdParameter>
      [-Recipients <SmtpAddress[]>]
      [-BypassDelegateChecking]
      [-Confirm]
      [-DomainController <Fqdn>]
      [-DoNotResolve]
      [-MessageEntryId <String>]
      [-MessageId <String>]
      [-ResultSize <Unlimited>]
      [-Subject <String>]
      [-TraceLevel <TraceLevel>]
      [-WhatIf]
      [<CommonParameters>]

Description

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

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

Este exemplo pesquisa o relatório de controle de mensagens em busca de mensagens enviadas de um usuário para outro. Este exemplo retorna o 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

Este exemplo pesquisa o relatório de acompanhamento de mensagens para o seguinte cenário: O usuário Cigdem Akin estava esperando uma mensagem de email da 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 retorna os relatórios de acompanhamento de mensagens que o suporte técnico pode analisar para resolver o problema.

Parâmetros

-BypassDelegateChecking

A opção BypassDelegateChecking permite que o pessoal de suporte técnico e os administradores acompanhem as mensagens de qualquer usuário. Não é preciso especificar um valor com essa opção.

Por padrão, os usuários só podem rastrear mensagens que enviam ou recebem de sua própria caixa de correio.

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

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, cmdlets New-* e Set-*) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.
Type:SwitchParameter
Aliases:cf
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

-DomainController

Este parâmetro está disponível somente no Exchange local.

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 Identity escopos a pesquisa para a caixa de correio especificada. É possível usar qualquer valor que identifique a caixa de correio exclusivamente. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • Domain\username
  • Endereço de email
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuário ou nome UPN

Quando você usa esse parâmetro sem o parâmetro Sender, a caixa de correio especificada é o remetente de mensagens usado na pesquisa. Você pode especificar os destinatários usando o parâmetro Destinatários.

Quando você usa esse parâmetro com o parâmetro Sender, a caixa de correio especificada é o destinatário da mensagem que é usado na pesquisa.

Type:MailboxIdParameter
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

-MessageEntryId

Esse parâmetro está reservado para uso interno da Microsoft.

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

-MessageId

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 incluir a cadeia de caracteres ID de mensagem completa (que pode incluir colchetes de ângulo) e incluir o valor entre aspas (por exemplo, "d9683b4c-127b-413a-ae2e-fa7dfb32c69d@contoso.com").

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

-Recipients

O parâmetro Destinatários filtra os resultados pelos endereços de email dos destinatários especificados. Você pode especificar vários endereços de email separados por vírgulas.

Você não pode usar esse parâmetro com o parâmetro Sender.

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

-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

-Sender

O parâmetro Remetente especifica o endereço de email do remetente de mensagens para mensagens enviadas para a caixa de correio especificada pelo parâmetro Identity.

Você precisa usar esse parâmetro com o parâmetro Identity.

Type:SmtpAddress
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Subject

O parâmetro Subject pesquisa mensagens com o valor de campo Assunto especificado. Se o valor contiver espaços, inclua o valor entre aspas.

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

-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, contagens de resultados de pesquisa de rastreamento de mensagens e qualquer informação de erro.
  • Médio: além de todos os 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

-WhatIf

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Aliases:wi
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

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.