Get-MessageTrackingLog (RTM)

  • Artículo

 

Se aplica a: Exchange Server 2007

Última modificación del tema: 2007-06-11

Use el cmdlet Get-MessageTrackingLog para buscar información de mensajes que se almacena en el registro de seguimiento de mensaje.

Sintaxis

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>]

Descripción detallada

Existe un registro de seguimiento único en cada equipo que tiene instalada la función del servidor Transporte de concentradores, la función del servidor Buzón de correo o la función del servidor Transporte perimetral. El registro de seguimiento de mensaje es un archivo de valores separados por comas (CVS) que contiene información detallada sobre la historia de cada mensaje de correo electrónico conforme se traslada por un servidor individual.

Para ejecutar el cmdlet Get-MessageTrackingLog, la cuenta que utilice debe tener delegado lo siguiente:

  • Función de administrador de servidores de Exchange y grupo Administradores local para el servidor de destino

Para ejecutar el cmdlet Get-MessageTrackingLog en un equipo que tiene instalada la función del servidor Transporte perimetral, debe iniciar sesión mediante una cuenta que sea miembro del grupo Administradores local en dicho equipo.

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

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar el nombre de dominio completo (FQDN) del controlador de dominio que escribe este cambio de configuración en el servicio de directorio de Active Directory, incluya el parámetro DomainController.

End

Opcional

System.DateTime

Este parámetro devuelve las entradas de registro de seguimiento hasta, pero sin incluir, la fecha y hora End especificadas mediante el formato regional del equipo en el cual se ejecuta el cmdlet.

EventId

Opcional

System.String

Este parámetro devuelve las entradas de registro de seguimiento de mensaje con las siguientes categorías posibles de eventos: BadMail, Defer Deliver, DSN, Expand, Fail, PoisonMessage, Receive, Redirect, Resolve, Send, Submit y Transfer.

InternalMessageId

Opcional

System.String

Este parámetro devuelve entradas de registro de seguimiento de mensaje con un valor de InternalMessagID. InternalMessageID es un identificador del mensaje que se asigna por el servidor de Exchange 2007 que está actualmente procesando el mensaje.

Un valor específico del mensaje de InternalMessageID es distinto en el registro de seguimiento de mensaje de cada servidor de Exchange 2007 que se encuentre involucrado en la entrega del mensaje.

MessageId

Opcional

System.String

Este parámetro devuelve las entradas de registro de seguimiento de mensaje con campo de encabezado de Message-ID especificado. Si el campo de encabezado Message-ID: está vacío o no existe, se asignará un valor arbitrario. Este valor es constante durante la vigencia del mensaje.

MessageSubject

Opcional

System.String

Este parámetro devuelve las entradas de registro de seguimiento de mensaje con el valor especificado del campo encabezado del Subject: en el mensaje. De manera predeterminada, los asuntos de los mensajes se almacenan en los registros de seguimiento de mensajes. Para deshabilitar el registro de asuntos de los mensajes, utilice el siguiente comando:

Set-TransportServer <Identity> -MessageTrackingLogSubjectLoggingEnabled $false

Destinatarios

Opcional

System.String[]

Este parámetro devuelve las entradas de registro de seguimiento de todos los mensajes con la dirección de correo electrónico del Protocolo simple de transferencia de correo (SMTP) del destinatario especificado. Varios destinatarios individuales incluidos en un único mensaje se registran mediante una entrada de registro de seguimiento de mensaje. Los destinatarios de grupo de distribución que no se encuentren expandidos se registran mediante la dirección de correo electrónico del SMTP del grupo de distribución. Los distintos valores de destinatario se pueden especificar utilizando comas como delimitadores.

Reference

Opcional

System.String

Este parámetro devuelve las entradas de registro de seguimiento de mensaje con el valor especificado en el campo Reference.

El campo Reference contiene información adicional para tipos específicos de EventID:

  • Send   El campo Reference contiene el Internet-Message-Id de cualquier mensaje de notificación del estado de entrega (DSN).

  • Transfer   El campo Reference contiene el Internal-Message-Id del mensaje que está siendo bifurcado.

  • DSN   El campo Reference contiene el Internet-Message-Id del mensaje que causó la notificación del estado de entrega.

Para todos los tipos de EventID, el campo Reference está en blanco.

ResultSize

Opcional

Microsoft.Exchange.Data.Unlimited

Este parámetro determina el número máximo de entradas de registro de seguimiento de mensaje que se van a mostrar. De forma predeterminada, se muestra un máximo de 1.000 entradas. Para mostrar todas las entradas, use el valor Unlimited.

Sender

Opcional

System.String

Este parámetro devuelve las entradas de registro de seguimiento de mensaje con la dirección de correo electrónico del SMTP del remitente especificado.

Server

Opcional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Este parámetro especifica el servidor de Exchange 2007 que contiene los registros de seguimiento de mensajes que van a ser buscados. El parámetro Server puede tomar cualquiera de los siguientes valores del servidor de destino:

  • Name

  • Nombre de dominio completo (FQDN)

  • Nombre distintivo (DN)

  • DN de Exchange heredado

  • GUID

Start

Opcional

System.DateTime

Este parámetro devuelve las entradas de registro de seguimiento de mensaje que empiezan con la fecha y hora Start especificadas mediante el formato regional del equipo en el cual se ejecuta el cmdlet.

Tipos de entrada

Tipos de valores devueltos

Errores

Error Descripción

 

 

Excepciones

Excepciones Descripción

 

 

Ejemplo

El primer ejemplo muestra cómo usar el cmdlet Get-MessageTrackingLog para recuperar las entradas de registro de seguimiento de mensaje que fueron creadas entre el 03/13/06 a las 9:00 a.m. y el 03/15/06 a las 5:00 p.m. con un valor Sender de tbremer@contoso.com.

Nota

El formato de fecha que se usa en este ejemplo es el inglés (EE.UU.). Use el formato de fecha que se encuentra configurado en su equipo de Exchange Server 2007. La fecha que especificó se convierte automáticamente al formato de hora universal coordinada (UTC) utilizado de manera interna por Exchange 2007 para almacenar entradas en los registros de seguimiento de mensajes.

El segundo ejemplo muestra cómo canalizar la salida del cmdlet Get-MessageTrackingLog al cmdlet Format-List para ver información adicional que esté disponible en el registro de seguimiento de mensaje.

Para obtener más información acerca de la canalización, consulte Canalización.

Para obtener más información acerca de cómo trabajar con el resultado de un comando, consulte Trabajo con salidas de comandos.

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