Compartilhar via

Get-MessageTrackingLog

  • Artigo

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2007-08-20

Use o cmdlet Get-MessageTrackingLog para pesquisar informações de mensagens que estão armazenadas no log de controle de mensagens.

Sintaxe

Get-MessageTrackingLog [-DomainController <Fqdn>] [-End <DateTime>] [-EventId <String>] [-InternalMessageId <String>] [-MessageId <String>] [-MessageSubject <String>] [-Recipients <String[]>] [-Reference <String>] [-ResultSize <Unlimited>] [-Sender <String>] [-Server <ServerIdParameter>] [-Start <DateTime>]

Descrição detalhada

Um log de controle de mensagens exclusivo existe em cada computador com a funções de servidor Transporte de Hub, Caixa de Correio ou Transporte de Borda instalada. O log de controle de mensagens é um arquivo CSV (valor separado por vírgula) que contém informações detalhadas sobre o histórico de cada mensagem de email conforme ele percorre um servidor individual.

Para executar o cmdlet Get-MessageTrackingLog, você deve usar uma conta à qual esteja delegado o seguinte:

  • Função Administrador Somente para Exibição do Exchange

Para executar o cmdlet Get-MessageTrackingLog em um computador em que a função de servidor Transporte de Borda esteja instalada, você deve fazer logon usando uma conta que seja membro do grupo Administradores local no mesmo computador.

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Microsoft Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro Necessário Tipo Descrição

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que grava essa alteração de configuração no serviço de diretório do Active Directory, inclua o parâmetro DomainController.

End

Opcional

System.DateTime

O parâmetro End retorna entradas do log de controle de mensagens até, mas não incluindo, a data e a hora de término especificadas usando o formato regional do computador em que o cmdlet é executado.

EventId

Opcional

System.String

Este parâmetro retorna entradas do log de controle de mensagens com as seguintes categorias de evento possíveis: BadMail, Defer Deliver, DSN, Expand, Fail, PoisonMessage, Receive, Redirect, Resolve, Send, Submit e Transfer.

InternalMessageId

Opcional

System.String

Este parâmetro retorna entradas do log de controle de mensagens com um valor InternalMessagID. InternalMessageID é um identificador de mensagem atribuído pelo servidor Exchange 2007 que está processando a mensagem no momento.

O valor InternalMessageID de uma mensagem específica é diferente no log de controle de mensagens de todos os servidores Exchange 2007 envolvidos na entrega da mensagem.

MessageId

Opcional

System.String

Esse parâmetro retorna entradas do log de controle de mensagens com o campo de cabeçalho Message-ID especificado. Se o campo de cabeçalho Message-ID: estiver em branco ou não existir, será atribuído um valor arbitrário. Esse valor é constante durante o tempo de vida da mensagem.

MessageSubject

Opcional

System.String

Esse parâmetro retorna entradas do log de controle de mensagens com o valor especificado do campo de cabeçalho Subject: na mensagem. Por padrão, os assuntos da mensagem são armazenados nos logs de controle de mensagens. Para desabilitar o log de assuntos das mensagens, use o seguinte comando:

Set-TransportServer <Identity> -MessageTrackingLogSubjectLoggingEnabled $false

Recipients

Opcional

System.String[]

Esse parâmetro retorna qualquer entrada do log de controle de mensagens com os endereços de email SMTP do destinatário especificado. Vários destinatários individuais que são incluídos em uma única mensagem são registrados usando uma única entrada do log de controle de mensagens. Os destinatários do grupo de distribuição não expandido são registrados usando o endereço de email SMTP do grupo de distribuição. Valores de vários destinatários podem ser especificados usando vírgulas como delimitadores.

Reference

Opcional

System.String

Este parâmetro retorna entradas do log de controle de mensagens com o valor especificado no campo Reference.

O campo Reference contém informações adicionais para tipos específicos de EventID:

  • Send   O campo Reference contém o Internet-Message-Id de quaisquer mensagens de notificação de status de entrega.

  • Transfer   O campo Reference contém o Internal-Message-Id da mensagem que está sendo bifurcada.

  • DSN   O campo Reference contém o Internet-Message-Id da mensagem que provocou a notificação de status de entrega.

Para todos os outros tipos de EventID, o campo Reference está em branco.

ResultSize

Opcional

Microsoft.Exchange.Data.Unlimited

Este parâmetro determina o número máximo de entradas do log de controle de mensagens a serem exibidas. Por padrão, são exibidas no máximo 1.000 entradas. Para exibir todas as entradas, use o valor Unlimited.

Sender

Opcional

System.String

Este parâmetro retorna entradas do log de controle de mensagens com o endereço de email SMTP do remetente especificado.

Server

Opcional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Este parâmetro especifica o servidor Exchange 2007 que contém os logs de controle de mensagens a serem pesquisados. O parâmetro Server pode adotar qualquer um dos seguintes valores para o servidor de destino:

  • Nome

  • Nome de domínio totalmente qualificado (FQDN)

  • DN (nome distinto)

  • DN Herdado do Exchange

  • GUID

Start

Opcional

System.DateTime

O parâmetro Start retorna entradas do log de controle de mensagens que começam com a data e a hora de início especificadas usando o formato regional do computador em que o cmdlet é executado.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

 

Exceções

Exceções Descrição

 

 

Exemplo

O primeiro exemplo mostra como usar o cmdlet Get-MessageTrackingLog para recuperar entradas do log de controle de mensagens que foram criadas entre 13/03/06 às 9h e 15/03/06 às 17h, com um valor de Sender tbremer@contoso.com.

Dica

O formato de data utilizados nesse exemplo está em inglês (EUA). Use o formato de data configurado em seu computador do Exchange Server 2007. A data que você especificar é convertida automaticamente no formato UTC (Tempo Universal Coordenado) usado internamente pelo Exchange 2007 para armazenar entradas nos logs de controle de mensagens.

O segundo exemplo mostra como canalizar a saída do cmdlet Get-MessageTrackingLog para o cmdlet Format-List para exibir informações adicionais que estão disponíveis no log de controle de mensagens.

Para obter mais informações sobre pipeline, consulte Pipelining.

Para obter mais informações sobre como trabalhar com a saída de um comando, consulte Trabalhando com saída do comando.

Get-MessageTrackingLog -Start "03/13/2006 9:00AM" -End "03/15/2006 5:00PM" -Sender "tbremer@contoso.com"
Get-MessageTrackingLog -Start "03/13/2006 9:00AM" -End "03/15/2006 5:00PM" -Sender "tbremer@contoso.com" | Format-List