Get-MessageTrackingLog
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: |
InternalMessageId |
Opcional |
System.String |
Este parâmetro retorna entradas do log de controle de mensagens com um valor O valor |
MessageId |
Opcional |
System.String |
Esse parâmetro retorna entradas do log de controle de mensagens com o campo de cabeçalho |
MessageSubject |
Opcional |
System.String |
Esse parâmetro retorna entradas do log de controle de mensagens com o valor especificado do campo de cabeçalho
|
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 O campo
Para todos os outros tipos de |
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 |
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:
|
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