tipo de recurso exchangeMessageTrace

Espacio de nombres: microsoft.graph

Representa la información de seguimiento de un mensaje de correo electrónico a medida que pasa por la organización Exchange Online. El seguimiento de mensajes permite a los administradores de inquilinos realizar un seguimiento del ciclo de vida de un correo electrónico, determinar su estado de entrega (ya sea entregado, pendiente, erróneo o en cuarentena) y comprender las acciones que se le aplican.

Métodos

Método	Tipo devuelto	Description
Enumeración de seguimientos de mensajes	colección exchangeMessageTrace	Obtenga una lista de objetos exchangeMessageTrace .
Obtener detalles por destinatario	colección exchangeMessageTraceDetail	Obtenga una lista de objetos exchangeMessageTraceDetail filtrados en el destinatario.

Propiedades

Propiedad	Tipo	Description
fromIP	Cadena	Dirección IP de origen. Para los mensajes entrantes, este valor es la dirección IP pública del servidor de correo electrónico SMTP que envió el mensaje. Admite $filter (eq).
id	Cadena	Identificador único del seguimiento del mensaje. Admite $filter (eq).
messageId	Cadena	Campo de encabezado Message-ID del mensaje. El formato de Message-ID depende del servidor de mensajería que envió el mensaje. Admite $filter (eq).
receivedDateTime	DateTimeOffset	Fecha y hora en que Exchange Online recibió el mensaje. La marca de tiempo está en formato UTC. Admite $filter (ge, le).
recipientAddress	Cadena	Dirección de correo electrónico SMTP del usuario al que se ha dirigido el mensaje. Admite $filter (eq).
senderAddress	Cadena	La dirección de correo electrónico SMTP del usuario desde la que supuestamente se produjo el mensaje. Admite $filter (eq).
size	Int32	Tamaño del mensaje en bytes.
status	exchangeMessageTraceStatus	Estado de entrega del mensaje. Los valores posibles son: gettingStatus, pending, , deliveredfailed, expanded, quarantined, , filteredAsSpam. unknownFutureValue Admite $filter (eq).
subject	Cadena	La línea de asunto del mensaje. Admite $filter (contains, startsWith y endsWith).
toIP	Cadena	Dirección IP de destino. En el caso de los mensajes salientes, este valor es la dirección IP pública del registro MX resuelto para el dominio de destino. Para que los mensajes entrantes Exchange Online, este valor está en blanco. Admite $filter (eq).

Requisitos previos

Para poder usar los seguimientos de mensajes de lista o Obtener detalles por api de destinatario, debe aprovisionar una entidad de servicio en el inquilino para la aplicación Microsoft con el siguiente identificador de aplicación (cliente): 8bd644d1-64a1-4d4b-ae52-2e0cbf64e373. El aprovisionamiento de la entidad de servicio crea una representación local de la aplicación en el inquilino y habilita la autenticación y autorización para estas API.

Para aprovisionar la entidad de servicio, puede seguir estos pasos:

1. Conéctese a PowerShell de Microsoft Graph:

   Connect-MgGraph -Scopes "Application.ReadWrite.All"
   

2. Ejecute el siguiente comando para aprovisionar la entidad de servicio:

   New-MgServicePrincipal -AppId 8bd644d1-64a1-4d4b-ae52-2e0cbf64e373
   
   

Relaciones

Ninguna.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "@odata.type": "#microsoft.graph.exchangeMessageTrace",
  "fromIP": "String",
  "id": "String (identifier)",
  "messageId": "String",
  "receivedDateTime": "String (timestamp)",
  "recipientAddress": "String",
  "senderAddress": "String",
  "size": "Int32",
  "status": "String",
  "subject": "String",
  "toIP": "String"
}