exchangeMessageTrace-Ressourcentyp

Namespace: microsoft.graph

Stellt die Ablaufverfolgungsinformationen für eine E-Mail-Nachricht während des Durchlaufens der Exchange Online organization dar. Die Nachrichtenablaufverfolgung ermöglicht es Mandantenadministratoren, den Lebenszyklus einer E-Mail nachzuverfolgen, ihre Zustellung status zu bestimmen – ob zugestellt, ausstehend, fehlgeschlagen oder unter Quarantäne gestellt – und die darauf angewendeten Aktionen zu verstehen.

Methoden

Methode Rückgabetyp Beschreibung
Nachrichtenablaufverfolgungen auflisten exchangeMessageTrace-Sammlung Rufen Sie eine Liste der exchangeMessageTrace-Objekte ab.
Abrufen von Details nach Empfänger exchangeMessageTraceDetail collection Rufen Sie eine Liste der exchangeMessageTraceDetail-Objekte ab, die nach dem Empfänger gefiltert werden.

Eigenschaften

Eigenschaft Typ Beschreibung
fromIP Zeichenfolge Die IP-Adresse als Quelle. Bei eingehenden Nachrichten ist dieser Wert die öffentliche IP-Adresse des SMTP-E-Mail-Servers, der die Nachricht gesendet hat.

Unterstützt $filter (eq).
id Zeichenfolge Der eindeutige Bezeichner für die Nachrichtenablaufverfolgung.

Unterstützt $filter (eq).
messageId Zeichenfolge Das Nachrichten-ID-Kopfzeilenfeld der Nachricht. Das Format der Message-ID hängt von dem Messagingserver ab, der die Nachricht gesendet hat.

Unterstützt $filter (eq).
receivedDateTime DateTimeOffset Datum und Uhrzeit, zu dem die Nachricht von Exchange Online empfangen wurde. Der Zeitstempel ist im UTC-Format.

Unterstützt $filter (ge, le).
recipientAddress Zeichenfolge Die SMTP-E-Mail-Adresse des Benutzers, an den die Nachricht adressiert war.

Unterstützt $filter (eq).
senderAddress Zeichenfolge Die SMTP-E-Mail-Adresse des Benutzers, von dem die Nachricht angeblich stammt.

Unterstützt $filter (eq).
size Int32 Die Größe der Nachricht in Bytes.
status exchangeMessageTraceStatus Der Status der Nachricht. Die möglichen Werte sind: gettingStatus, pending, failed, delivered, expandedquarantined, filteredAsSpam, unknownFutureValue. recalled Verwenden Sie den Prefer: include-unknown-enum-members Anforderungsheader, um den folgenden Wert in dieser entwicklungsfähigen Aufzählung zu erhalten: recalled.

Unterstützt $filter (eq).
subject Zeichenfolge Die Betreffzeile der Nachricht.

Unterstützt $filter (contains, startsWith, endsWith).
toIP Zeichenfolge Die Ziel-IP-Adresse. Bei ausgehenden Nachrichten ist dieser Wert die öffentliche IP-Adresse im aufgelösten MX-Eintrag für die Zieldomäne. Bei eingehenden Nachrichten an Exchange Online ist dieser Wert leer.

Unterstützt $filter (eq).

Voraussetzungen

Bevor Sie die APIs "Nachrichtenablaufverfolgungen auflisten " oder "Details nach Empfänger abrufen " verwenden können, müssen Sie in Ihrem Mandanten einen Dienstprinzipal für die Microsoft-Anwendung mit der folgenden Anwendungs-ID (Client-ID) bereitstellen: 8bd644d1-64a1-4d4b-ae52-2e0cbf64e373. Durch die Bereitstellung des Dienstprinzipals wird eine lokale Darstellung der Anwendung in Ihrem Mandanten erstellt und die Authentifizierung und Autorisierung für diese APIs ermöglicht.

Gehen Sie wie folgt vor, um den Dienstprinzipal bereitzustellen:

  1. Stellen Sie eine Verbindung mit Microsoft Graph PowerShell her: 
    Connect-MgGraph -Scopes "Application.ReadWrite.All"
  2. Führen Sie den folgenden Befehl aus, um den Dienstprinzipal bereitzustellen: 
    New-MgServicePrincipal -AppId 8bd644d1-64a1-4d4b-ae52-2e0cbf64e373

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@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"
}
  • Zuletzt aktualisiert um