Type de ressource exchangeMessageTrace

Espace de noms: microsoft.graph

Représente les informations de trace d’un e-mail lors de son passage dans le Exchange Online organization. Le suivi des messages permet aux administrateurs clients de suivre le cycle de vie d’un e-mail, de déterminer son status de remise (remise, en attente, échec ou mise en quarantaine) et de comprendre les actions qui lui sont appliquées.

Méthodes

Méthode	Type de retour	Description
Répertorier les traces des messages	collection exchangeMessageTrace	Obtenez la liste des objets exchangeMessageTrace .
Obtenir des détails par destinataire	collection exchangeMessageTraceDetail	Obtenez une liste d’objets exchangeMessageTraceDetail filtrés sur le destinataire.

Propriétés

Propriété	Type	Description
fromIP	String	Adresse IP source. Pour les messages entrants, cette valeur est l’adresse IP publique du serveur de messagerie SMTP qui a envoyé le message. Prend en charge $filter (eq).
id	String	Identificateur unique de la trace des messages. Prend en charge $filter (eq).
Messageid	String	Champ d’en-tête Message-ID du message. Le format du paramètre Message-ID est fonction du serveur de messagerie. Prend en charge $filter (eq).
receivedDateTime	DateTimeOffset	Date et heure de réception du message par Exchange Online. L’horodatage est au format UTC. Prend en charge $filter (ge, le).
recipientAddress	String	Adresse e-mail SMTP de l’utilisateur auquel le message a été adressé. Prend en charge $filter (eq).
senderAddress	String	Adresse e-mail SMTP de l’utilisateur dont le message provient. Prend en charge $filter (eq).
size	Int32	Taille du message en octets.
status	exchangeMessageTraceStatus	Status de remise du message. Les valeurs possibles sont : gettingStatus, pending, failed, delivered, expanded, quarantined, filteredAsSpam, , . unknownFutureValue Prend en charge $filter (eq).
sujet	String	Ligne d’objet du message. Prend en charge $filter (contains, startsWith, endsWith).
toIP	String	Adresse IP de destination. Pour les messages sortants, cette valeur est l’adresse IP publique dans l’enregistrement MX résolu pour le domaine de destination. Pour les messages entrants à Exchange Online, cette valeur est vide. Prend en charge $filter (eq).

Configuration requise

Avant de pouvoir utiliser les API Répertorier les traces de message ou Obtenir des détails par le destinataire , vous devez provisionner un principal de service dans votre locataire pour l’application Microsoft avec l’ID d’application (client) suivant : 8bd644d1-64a1-4d4b-ae52-2e0cbf64e373. L’approvisionnement du principal de service crée une représentation locale de l’application dans votre locataire et active l’authentification et l’autorisation pour ces API.

Pour provisionner le principal de service, vous pouvez effectuer les étapes suivantes :

1. Se connecter à Microsoft Graph PowerShell :

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

2. Exécutez la commande suivante pour provisionner le principal de service :

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

Relations

Aucun.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "@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"
}