Get-MessageTraceV2
Este cmdlet solo está disponible en el servicio basado en la nube.
Use el cmdlet Get-MessageTraceV2 para realizar un seguimiento de los mensajes a medida que pasan por 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.
Sintaxis
Get-MessageTraceV2
[[-EndDate] <System.DateTime>]
[[-FromIP] <String>]
[[-MessageId] <MultiValuedProperty>]
[[-MessageTraceId] <System.Guid>]
[[-RecipientAddress] <MultiValuedProperty>]
[[-ResultSize] <Int32>]
[[-SenderAddress] <MultiValuedProperty>]
[[-StartDate] <System.DateTime>]
[[-StartingRecipientAddress] <String>]
[[-Status] <MultiValuedProperty>]
[[-SubjectFilterType] <String>]
[[-Subject] <String>]
[[-ToIP] <String>]
[<CommonParameters>] Description
Puede usar este cmdlet para buscar datos de mensajes durante los últimos 90 días. Si ejecuta este cmdlet sin ningún parámetro, solo se devuelven los datos de las últimas 48 horas. Solo puede devolver 10 días de datos por consulta.
De forma predeterminada, este cmdlet devuelve hasta 1000 resultados, con un máximo de 5000 resultados. Si los datos superan el tamaño del resultado, realice una consulta en varias rondas o use 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.
Límite de limitación: se aceptará un máximo de 100 solicitudes de consulta en un plazo de 5 minutos en ejecución. La limitación no se aplica automáticamente si la tasa de solicitudes es inferior a 100 solicitudes en los últimos 5 minutos.
La paginación no se admite en este cmdlet. Para consultar datos posteriores, use los parámetros StartingRecipientAddress y EndDate con los valores de las propiedades Recipient address y Received Time respectivamente del resultado anterior en la consulta siguiente.
Procedimientos recomendados:
- Use el parámetro ResultSize para ajustar el tamaño de los resultados.
- Sea lo más preciso posible. Reduzca la brecha entre StartDate y EndDate y use parámetros adicionales (por ejemplo, SenderAddress) siempre que sea posible.
- Use MessageTraceId siempre que sea posible (necesario para los mensajes enviados a más de 1000 destinatarios).
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-MessageTraceV2 -SenderAddress john@contoso.com -StartDate 06/13/2025 -EndDate 06/15/2025En 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 2025 y el 15 de junio de 2025.
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/aaaa, escriba 09/01/2025 para especificar el 1 de septiembre de 2025. Puede escribir solo la fecha, o la fecha y la hora del día. Si escribe la fecha y hora del día, incluya el valor entre comillas ("), por ejemplo, "09/01/2025 5:00 p.m.".
| Tipo: | System.DateTime |
| Posición: | 1 |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
| Se aplica a: | Exchange Online |
-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.
| Tipo: | String |
| Posición: | 2 |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
| Se aplica a: | Exchange Online |
-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").
| Tipo: | MultiValuedProperty |
| Posición: | 3 |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
| Se aplica a: | Exchange Online |
-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-MessageTraceDetailV2
| Tipo: | System.Guid |
| Posición: | 4 |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
| Se aplica a: | Exchange Online |
-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.
| Tipo: | MultiValuedProperty |
| Posición: | 5 |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
| Se aplica a: | Exchange Online |
-ResultSize
El parámetro ResultSize especifica el número máximo de resultados que se van a devolver. Un valor válido es de 1 a 5000. El valor predeterminado es 1000.
Nota: Este parámetro reemplaza al parámetro PageSize que estaba disponible en el cmdlet Get-MessageTrace.
| Tipo: | Int32 |
| Posición: | 6 |
| Valor predeterminado: | 0 |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
| Se aplica a: | Exchange Online |
-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.
| Tipo: | MultiValuedProperty |
| Posición: | 7 |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
| Se aplica a: | Exchange Online |
-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/aaaa, escriba 09/01/2025 para especificar el 1 de septiembre de 2025. Puede escribir solo la fecha, o la fecha y la hora del día. Si escribe la fecha y hora del día, incluya el valor entre comillas ("), por ejemplo, "09/01/2025 5:00 p.m.".
| Tipo: | System.DateTime |
| Posición: | 8 |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
| Se aplica a: | Exchange Online |
-StartingRecipientAddress
El parámetro StartingRecipientAddress se usa con el parámetro EndDate para consultar los datos posteriores en busca de resultados parciales y evitar la duplicación. Consulte los datos posteriores tomando los valores Recipient address y Received Time del último registro de los resultados parciales y usándolos como valores para los parámetros StartingRecipientAddress y EndDate respectivamente en la consulta siguiente.
| Tipo: | String |
| Posición: | 9 |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
| Se aplica a: | Exchange Online |
-Status
El parámetro Status filtra los resultados por el estado de entrega del mensaje. Los valores admitidos son:
- 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.
- Error: se intentó la entrega de mensajes y se produjo un error.
- FilteredAsSpam: el mensaje se ha marcado como correo no deseado.
- GettingStatus: el mensaje está esperando la actualización del estado.
- None: el mensaje no tiene estado de entrega porque se rechazó o se redirigió a otro destinatario.
- Pending: la entrega del mensaje está en proceso o se retrasó y se está reintentando.
- En cuarentena: el mensaje se puso en cuarentena.
Puede separar varios valores separados por comas.
| Tipo: | MultiValuedProperty |
| Posición: | 10 |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
| Se aplica a: | Exchange Online |
-Subject
El parámetro Subject filtra los resultados por el asunto del mensaje. Si el valor contiene espacios, escriba el valor entre comillas (").
Especifique cómo se evalúa el valor en el asunto del mensaje mediante el parámetro SubjectFilterType.
| Tipo: | String |
| Posición: | 11 |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
| Se aplica a: | Exchange Online |
-SubjectFilterType
El parámetro SubjectFilterType especifica cómo se evalúa el valor del parámetro Subject. Los valores admitidos son:
- Contains
- EndsWith
- StartsWith
Se recomienda usar StartsWith o EndsWith en lugar de Contains siempre que sea posible.
| Tipo: | String |
| Posición: | 12 |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
| Se aplica a: | Exchange Online |
-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.
| Tipo: | String |
| Posición: | 13 |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
| Se aplica a: | Exchange Online |