Get-AgentLog
Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Última modificación del tema: 2007-06-28
Utilice el cmdlet Get-AgentLog para analizar archivos de registro que se especifican como parámetros y recopilar estadísticas sin procesar del filtro que aplican los agentes contra correo electrónico no deseado durante el período de tiempo que se especifique.
Sintaxis
Get-AgentLog [-EndDate <DateTime>] [-Location <LocalLongFullPath>] [-StartDate <DateTime>]
Descripción detallada
Para ejecutar el cmdlet Get-AgentLog, se debe usar una cuenta en la que se delegue lo siguiente:
- Pertenencia al grupo de administradores locales
Para obtener más información sobre los permisos, la delegación de funciones y los derechos necesarios para administrar Microsoft Exchange Server 2007, consulte Consideraciones sobre permisos.
Parámetros
| Parámetro | Necesario | Tipo | Descripción |
|---|---|---|---|
EndDate |
Opcional |
System.DateTime |
Este parámetro especifica la fecha y la hora en que desea dejar de recopilar estadísticas. El valor predeterminado es la fecha actual. Cuando escriba una fecha específica, utilice el formato de fecha abreviado definido en las opciones de Configuración regional del equipo local. Por ejemplo, si el equipo está configurado para usar un formato de fecha abreviado mm/dd/aaaa, escriba 03/01/2006 para especificar el 1 de marzo de 2006. Puede escribir sólo la fecha como, por ejemplo, |
Location |
Opcional |
Microsoft.Exchange.Data.LocalLongFullPath |
El parámetro Location especifica el directorio que contiene los archivos de registro que puede usar para generar informes de uso. La ruta de acceso predeterminada es C:\Archivos de programa\Microsoft\Exchange Server\TransportRoles\Logs\AgentLog. Debe escribir la ruta de acceso del archivo entre comillas, como por ejemplo, |
StartDate |
Opcional |
System.DateTime |
El parámetro StartDate especifica la fecha y la hora en que comienza la recopilación de estadísticas. El valor predeterminado es la fecha actual. Cuando escriba una fecha específica, utilice el formato de fecha abreviado definido en las opciones de Configuración regional configuradas en el equipo local. Por ejemplo, si el equipo está configurado para usar el formato de fecha abreviado mm/dd/aaaa, escriba 03/01/2006 para especificar 1 de marzo de 2006. Puede escribir sólo la fecha como, por ejemplo, |
Tipos de valores devueltos
| Objeto | Descripción |
|---|---|
Marca de tiempo |
Fecha y hora de la entrada del registro |
ConnectorName |
Nombre común del conector que recibió el mensaje |
SessionId |
La dirección IP de la sesión SMTP |
IPAddress |
La dirección IP del servidor que realiza la conexión |
MessageId |
El Id. del mensaje de Microsoft Exchange Server 2007 |
P1FromAddress |
El campo From de P1 (sobre del mensaje) del encabezado del mensaje |
P2FromAddresses |
El campo From de P2 (encabezado del mensaje) del encabezado del mensaje |
Destinatarios |
Los destinatarios del mensaje |
Agente |
Nombre del agente que invoca la acción |
Evento |
El evento en el que se realizó la acción |
Acción |
La acción realizada (valor entero) |
SmtpResponse |
La respuesta que se envía al que llama, si la hubiera |
Motivo |
Código de motivo que suministra el agente |
ReasonData |
Descripción detallada por parte del agente |
Ejemplo
El siguiente ejemplo de código devuelve un informe que contiene estadísticas recopiladas desde las 5:00 p.m. del 5 de octubre de 2005 hasta la hora actual.
Get-AgentLog -StartDate "10/05/2005 5:00:00 PM"