Get-MessageTrace

Módulo:

ExchangePowerShell

Se aplica a:

Exchange Online, Exchange Online Protection

Este cmdlet solo está disponible en el servicio basado en la nube.

Utilice el cmdlet Get-MessageTrace para seguir los mensajes cuando pasan a través de la organización basada en la nube.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Syntax

Get-MessageTrace
   [-EndDate <DateTime>]
   [-FromIP <String>]
   [-MessageId <MultiValuedProperty>]
   [-MessageTraceId <Guid>]
   [-Page <Int32>]
   [-PageSize <Int32>]
   [-ProbeTag <String>]
   [-RecipientAddress <MultiValuedProperty>]
   [-SenderAddress <MultiValuedProperty>]
   [-StartDate <DateTime>]
   [-Status <MultiValuedProperty>]
   [-ToIP <String>]
   [<CommonParameters>]

Description

Puede usar este cmdlet para buscar datos de mensajes durante los últimos 10 días. Si ejecuta este cmdlet sin ningún parámetro, solo se devuelven los datos de las últimas 48 horas.

Si escribe una fecha de inicio que tiene más de 10 días, recibirá un error y el comando no devolverá ningún resultado.

Para buscar datos de mensajes con más de 10 días de antigüedad, use los cmdlets Start-HistoricalSearch y Get-HistoricalSearch.

De forma predeterminada, este cmdlet devuelve un máximo de 1000 resultados y agotará el tiempo de espera en consultas muy grandes. Si la consulta devuelve demasiados resultados, considere la posibilidad de dividirla con intervalos StartDate y EndDate más pequeños.

Las marcas de tiempo de la salida están en formato de hora UTC. Puede ser diferente del formato de hora que usó para los parámetros -StartDate y -EndDate.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

Get-MessageTrace -SenderAddress john@contoso.com -StartDate 06/13/2018 -EndDate 06/15/2018

En este ejemplo se recupera la información de seguimiento de mensajes para los mensajes enviados por john@contoso.com entre el 13 de junio de 2018 y el 15 de junio de 2018.

Parámetros

-EndDate

El parámetro EndDate especifica la fecha de finalización del intervalo de fechas.

Use el formato de fecha corta que se define en la opción Configuración regional en el equipo en el que se ejecuta el comando. Por ejemplo, si el equipo está configurado para usar el formato de fecha corta mm/dd/yyyy, escriba 09/01/2018 para especificar el 1 de septiembre de 2018. Puede escribir solo la fecha, o la fecha y la hora del día. Si escribe la fecha y la hora del día, encierre el valor entre comillas ("), por ejemplo, "01/09/2018 5:00 PM".

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-FromIP

El parámetro FromIP filtra los resultados por la dirección IP de origen. Para los mensajes entrantes, el valor de FromIP es la dirección IP pública del servidor de correo electrónico SMTP que envió el mensaje.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-MessageId

El parámetro MessageId filtra los resultados por el campo de encabezado de Message-ID del mensaje. Este valor también se conoce como el identificador del cliente. El formato de Message-ID depende del servidor de mensajería que envió el mensaje. El valor debe ser único para cada mensaje. No obstante, no todos los servidores de mensajería crean valores para Message-ID del mismo modo. Asegúrese de incluir la cadena de id. de mensaje completa (que puede incluir corchetes angulares) y incluya el valor entre comillas (por ejemplo, "d9683b4c-127b-413a-ae2e-fa7dfb32c69d@DM3NAM06BG401.Eop-nam06.prod.protection.outlook.com").

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-MessageTraceId

El parámetro MessageTraceId filtra los resultados por el valor del identificador de seguimiento del mensaje. Este valor GUID se genera para cada mensaje procesado por el sistema (por ejemplo, c20e0f7a-f06b-41df-fe33-08d9da155ac1).

El valor messageTraceId también está disponible en la salida de los siguientes cmdlets:

• Get-MailDetailATPReport
• Get-MailDetailDlpPolicyReport
• Get-MailDetailEncryptionReport
• Get-MailDetailTransportRuleReport
• Get-MessageTraceDetail

Type:	Guid
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Page

El parámetro Page especifica el número de páginas de resultados que desea ver. La entrada válida para este parámetro es un número entero entre 1 y 1000. El valor predeterminado es 1.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-PageSize

El parámetro PageSize especifica el número máximo de entradas por página. La entrada válida para este parámetro es un número entero entre 1 y 5000. El valor predeterminado es 1000.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-ProbeTag

Este parámetro está reservado para uso interno de Microsoft.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-RecipientAddress

El parámetro RecipientAddress filtra los resultados por la dirección de correo electrónico del destinatario. Puede especificar distintos valores separados por comas.

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-SenderAddress

El parámetro SenderAddress filtra los resultados por la dirección de correo electrónico del remitente. Puede especificar distintos valores separados por comas.

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-StartDate

El parámetro StartDate especifica la fecha de inicio del intervalo de fechas.

Use el formato de fecha corta que se define en la opción Configuración regional en el equipo en el que se ejecuta el comando. Por ejemplo, si el equipo está configurado para usar el formato de fecha corta mm/dd/yyyy, escriba 09/01/2018 para especificar el 1 de septiembre de 2018. Puede escribir solo la fecha, o la fecha y la hora del día. Si escribe la fecha y la hora del día, encierre el valor entre comillas ("), por ejemplo, "01/09/2018 5:00 PM".

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Status

El parámetro Status filtra los resultados por el estado de entrega del mensaje. El parámetro PasswordQuality especifica la clasificación de calidad mínima de la contraseña que se requiere para las contraseñas del dispositivo. La calidad de la contraseña es una escala numérica que indica la seguridad y complejidad de la contraseña. Un valor de calidad superior indica una contraseña más segura.

• None: el mensaje no tiene estado de entrega porque se rechazó o se redirigió a otro destinatario.
• GettingStatus: el mensaje está esperando la actualización del estado.
• Failed: se intentó entregar el mensaje y se produjo un error o el mensaje se filtró como correo no deseado o malware, o lo filtraron las reglas de transporte.
• Pending: la entrega del mensaje está en proceso o se retrasó y se está reintentando.
• Delivered: el mensaje se entregó a su destino.
• Expandido: no hubo entrega de mensajes porque el mensaje se dirigió a un grupo de distribución y se expandió la pertenencia a la distribución.
• En cuarentena: el mensaje se puso en cuarentena.
• FilteredAsSpam: el mensaje se ha marcado como correo no deseado.

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-ToIP

El parámetro ToIP filtra los resultados por la dirección IP de destino. Para los mensajes salientes, el valor de ToIP es la dirección IP pública en el registro MX resuelto para el dominio de destino. Para los mensajes entrantes a Exchange Online, el valor está en blanco.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

Entradas

Input types

Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.

Salidas

Output types

Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.