Get-AgentLog

  • Artigo

 

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

Tópico modificado em: 2007-06-28

Use o cmdlet Get-AgentLog para analisar os arquivos de log que você especificar como parâmetros e coletar estatísticas brutas da filtragem aplicada por agentes anti-spam, durante um período de tempo especificado.

Sintaxe

Get-AgentLog [-EndDate <DateTime>] [-Location <LocalLongFullPath>] [-StartDate <DateTime>]

Descrição detalhada

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

  • Associação no grupo Administrador local

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(s) Tipo Descrição

EndDate

Opcional

System.DateTime

Esse parâmetro especifica a data e a hora que você deseja parar de coletar estatísticas. A hora padrão é a hora atual. Ao inserir uma data específica, use o formato de data abreviada definido nas configurações de Opções Regionais do computador local. Por exemplo, se o seu computador estiver configurado para usar o formato de data abreviada dd/mm/aaaa, digite 01/03/2006 para especificar 1º de março de 2006. Você pode digitar apenas a data, por exemplo, 10/05/2005 Ou você pode digitar a data e a hora do dia. Se você inserir a hora e a data, o argumento deverá ser inserido entre aspas duplas, por exemplo, "10/05/2005 5:00:00 PM".

Location

Opcional

Microsoft.Exchange.Data.LocalLongFullPath

O parâmetro Location especifica o diretório que contém os arquivos de log que podem ser usados para criar relatórios de uso. O caminho padrão é C:\Arquivos de Programas\Microsoft\Exchange Server\TransportRoles\Logs\AgentLog. Você deve inserir o caminho do arquivo entre aspas duplas, por exemplo, "C:\Program Files\Microsoft\Exchange Server\TransportRoles\Logs\AgentLog".

StartDate

Opcional

System.DateTime

O parâmetro StartDate especifica a data e a hora de início da coleta da estatística. A hora padrão é a hora atual. Ao inserir uma data específica, use o formato de data abreviada definido nas configurações de Opções Regionais do computador local. Por exemplo, se o computador estiver configurado para usar o formato de data abreviada dd/mm/aaaa, digite 01/03/2006, para especificar a data 1º de março de 2006. Você pode inserir apenas a data, por exemplo:10/05/2005, ou a data e a hora. Se você inserir a hora e a data, o argumento deverá ser inserido entre aspas duplas, por exemplo, "10/05/2005 5:00:00 PM".

Tipos de retorno

Objeto Descrição

Timestamp

Hora da entrada do log

ConnectorName

CN do conector que recebeu a mensagem

SessionId

O endereço IP da seção SMTP

IPAddress

O endereço IP do servidor conectado.

MessageId

A ID da mensagem do Microsoft Exchange Server 2007

P1FromAddress

O P1 (envelope da mensagem) De: campo de cabeçalho da mensagem

P2FromAddresses

O P2 (cabeçalho da mensagem) De: campo de cabeçalho da mensagem

Destinatários

Os destinatários da mensagem

Agente

Nome do agente que chama a ação

Evento

O evento em que a ação foi realizada

Ação

A ação realizada (Inteiro)

SmtpResponse

Resposta enviada ao chamador, se houver

Razão

Código da razão fornecido pelo agente

ReasonData

Descrição detalhada pelo agente

Exemplo

O exemplo de código a seguir retorna um relatório que possui estatísticas coletadas desde 5 de outubro de 2005 às 17:00 até a hora atual.

Get-AgentLog -StartDate "10/05/2005 5:00:00 PM"