Freigeben über

Get-MessageTraceV2

Modul:
ExchangePowerShell
Gilt für::
Exchange Online

Dieses Cmdlet ist nur im cloudbasierten Dienst verfügbar.

Verwenden Sie das Cmdlet Get-MessageTraceV2, um Nachrichten nachzuverfolgen, während sie die cloudbasierte organization durchlaufen.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

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>]

Beschreibung

Sie können dieses Cmdlet verwenden, um Nachrichtendaten der letzten 90 Tage zu durchsuchen. Wenn Sie dieses Cmdlet ohne Parameter ausführen, werden nur Daten aus den letzten 48 Stunden zurückgegeben. Sie können nur Daten im Wert von 10 Tagen pro Abfrage zurückgeben.

Standardmäßig gibt dieses Cmdlet bis zu 1.000 Ergebnisse mit maximal 5.000 Ergebnissen zurück. Wenn Ihre Daten die Ergebnisgröße überschreiten, fragen Sie in mehreren Runden ab, oder verwenden Sie kleinere StartDate- und EndDate-Intervalle.

Die Zeitstempel in der Ausgabe sind im UTC-Zeitformat angegeben. Dies kann sich von dem Zeitformat unterscheiden, das Sie für die Parameter -StartDate und -EndDate verwendet haben.

Drosselungslimit: Maximal 100 Abfrageanforderungen werden innerhalb von 5 Minuten akzeptiert. Die Drosselung wird nicht automatisch angewendet, wenn die Anforderungsrate unter 100 Anforderungen in den letzten 5 Minuten liegt.

Die Paginierung wird in diesem Cmdlet nicht unterstützt. Um nachfolgende Daten abzufragen, verwenden Sie die Parameter StartingRecipientAddress und EndDate mit den Werten aus den Eigenschaften Recipient address bzw . Received Time des vorherigen Ergebnisses in der nächsten Abfrage.

Bewährte Methoden:

  • Verwenden Sie den Parameter ResultSize, um die Größe der Ergebnisse anzupassen.
  • Seien Sie so präzise wie möglich. Schließen Sie die Lücke zwischen StartDate und EndDate, und verwenden Sie nach Möglichkeit zusätzliche Parameter (z. B. SenderAddress).
  • Verwenden Sie nach Möglichkeit MessageTraceId (erforderlich für Nachrichten, die an mehr als 1.000 Empfänger gesendet werden).

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.

Beispiele

Beispiel 1

Get-MessageTraceV2 -SenderAddress john@contoso.com -StartDate 06/13/2025 -EndDate 06/15/2025

In diesem Beispiel werden Nachrichtenablaufverfolgungsinformationen für Nachrichten abgerufen, die zwischen dem 13. Juni 2025 und dem 15. Juni 2025 gesendet wurden john@contoso.com .

Parameter

-EndDate

Der EndDate-Parameter gibt das Enddatum des Datumsbereichs an.

Verwenden Sie das unter "Regionale Einstellungen" definierte kurze Datumsformat für den Computer, auf dem der Befehl ausgeführt wird. Wenn der Computer beispielsweise für die Verwendung des kurzen Datumsformats MM/TT/JJJJ konfiguriert ist, geben Sie 09/01/2025 ein, um den 1. September 2025 anzugeben. Sie können entweder nur das Datum oder das Datum und die Uhrzeit angeben. Wenn Sie Datum und Uhrzeit eingeben, schließen Sie den Wert in Anführungszeichen ("), z. B. "01.09.2025 17:00 Uhr" ein.

Typ:System.DateTime
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False
Gilt für::Exchange Online

-FromIP

Der Parameter FromIP filtert die Ergebnisse nach der Quell-IP-Adresse. Bei eingehenden Nachrichten entspricht der Wert FromIP der öffentlichen IP-Adresse des SMTP-E-Mail-Servers, von dem die Nachricht gesendet wurde.

Typ:String
Position:2
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False
Gilt für::Exchange Online

-MessageId

Der MessageId-Parameter filtert die Ergebnisse nach derMessage-ID-Kopfzeile der Nachricht. Dieser Wert wird auch Client-ID genannt. Das Format der Message-ID hängt von dem Messagingserver ab, der die Nachricht gesendet hat. Der Wert muss für jede Nachricht eindeutig sein. Allerdings erstellen nicht alle Messagingserver Werte für die Message-ID auf dieselbe Weise. Achten Sie darauf, die vollständige Nachrichten-ID-Zeichenfolge (die spitze Klammern enthalten kann) einzuschließen und den Wert in Anführungszeichen (z. B. "d9683b4c-127b-413a-ae2e-fa7dfb32c69d@DM3NAM06BG401.Eop-nam06.prod.protection.outlook.com") einzuschließen.

Typ:MultiValuedProperty
Position:3
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False
Gilt für::Exchange Online

-MessageTraceId

Der Parameter MessageTraceId filtert die Ergebnisse nach dem Wert der Ablaufverfolgungs-ID der Nachricht. Dieser GUID-Wert wird für jede Nachricht generiert, die vom System verarbeitet wird (z. B. c20e0f7a-f06b-41df-fe33-08d9da155ac1).

Der MessageTraceId-Wert ist auch in der Ausgabe der folgenden Cmdlets verfügbar:

  • Get-MailDetailATPReport
  • Get-MailDetailDlpPolicyReport
  • Get-MailDetailEncryptionReport
  • Get-MailDetailTransportRuleReport
  • Get-MessageTraceDetailV2
Typ:System.Guid
Position:4
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False
Gilt für::Exchange Online

-RecipientAddress

Der RecipientAddress-Parameter filtert die Ergebnisse nach der E-Mail-Adresse des Empfängers. Es können mehrere Werte durch Kommata getrennt angegeben werden.

Typ:MultiValuedProperty
Position:5
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False
Gilt für::Exchange Online

-ResultSize

Der ResultSize-Parameter gibt die maximale Anzahl von zurückzugebenden Ergebnissen an. Ein gültiger Wert liegt zwischen 1 und 5000. Der Standardwert ist 1000.

Hinweis: Dieser Parameter ersetzt den PageSize-Parameter, der im Cmdlet Get-MessageTrace verfügbar war.

Typ:Int32
Position:6
Standardwert:0
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False
Gilt für::Exchange Online

-SenderAddress

Der SenderAddress-Parameter filtert die Ergebnisse nach der E-Mail-Adresse des Absenders. Es können mehrere Werte durch Kommata getrennt angegeben werden.

Typ:MultiValuedProperty
Position:7
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False
Gilt für::Exchange Online

-StartDate

Der StartDate-Parameter gibt das Startdatum und die Uhrzeit des Datumsbereichs an.

Verwenden Sie das unter "Regionale Einstellungen" definierte kurze Datumsformat für den Computer, auf dem der Befehl ausgeführt wird. Wenn der Computer beispielsweise für die Verwendung des kurzen Datumsformats MM/TT/JJJJ konfiguriert ist, geben Sie 09/01/2025 ein, um den 1. September 2025 anzugeben. Sie können entweder nur das Datum oder das Datum und die Uhrzeit angeben. Wenn Sie Datum und Uhrzeit eingeben, schließen Sie den Wert in Anführungszeichen ("), z. B. "01.09.2025 17:00 Uhr" ein.

Typ:System.DateTime
Position:8
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False
Gilt für::Exchange Online

-StartingRecipientAddress

Der Parameter StartingRecipientAddress wird zusammen mit dem EndDate-Parameter verwendet, um nachfolgende Daten nach Teilergebnissen abzufragen, während Duplizierungen vermieden werden. Fragen Sie nachfolgende Daten ab, indem Sie die Werte Recipient address und Received Time des letzten Datensatzes der Teilergebnisse verwenden und sie als Werte für die Parameter StartingRecipientAddress bzw. EndDate in der nächsten Abfrage verwenden.

Typ:String
Position:9
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False
Gilt für::Exchange Online

-Status

Der Parameter Status filtert die Ergebnisse nach dem Übermittlungsstatus der Nachricht. Gültige Werte sind:

  • Delivered: Die Nachricht wurde zugestellt.
  • Erweitert: Es gab keine Nachrichtenübermittlung, da die Nachricht an eine Verteilergruppe adressiert wurde und die Mitgliedschaft in der Verteilung erweitert wurde.
  • Fehler: Die Nachrichtenübermittlung wurde versucht, und es ist ein Fehler aufgetreten.
  • FilteredAsSpam: Die Nachricht wurde als Spam gekennzeichnet.
  • GettingStatus: Die Meldung wartet auf status Update.
  • None: Die Nachricht besitzt keinen Übermittlungsstatus, da sie abgelehnt oder an einen anderen Empfänger umgeleitet wurde.
  • Pending: Die Nachrichtenzustellung erfolgt in Kürze oder wurde verzögert und wird wiederholt.
  • Unter Quarantäne: Die Nachricht wurde unter Quarantäne gesetzt.

Mehrere Werte können durch Kommata getrennt angegeben werden.

Typ:MultiValuedProperty
Position:10
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Exchange Online

-Subject

Der Subject-Parameter filtert die Ergebnisse nach dem Betreff der Nachricht. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").

Sie geben an, wie der Wert im Betreff der Nachricht ausgewertet wird, indem Sie den SubjectFilterType-Parameter verwenden.

Typ:String
Position:11
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False
Gilt für::Exchange Online

-SubjectFilterType

Der SubjectFilterType-Parameter gibt an, wie der Wert des Subject-Parameters ausgewertet wird. Gültige Werte sind:

  • Enthält
  • EndsWith
  • StartsWith

Es wird empfohlen, startsWith oder EndsWith anstelle von Contains zu verwenden, wenn möglich.

Typ:String
Position:12
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False
Gilt für::Exchange Online

-ToIP

Der Parameter ToIP filtert die Ergebnisse nach der Ziel-IP-Adresse. Bei ausgehenden Nachrichten entspricht der Wert von ToIP der öffentlichen IP-Adresse im aufgelösten MX-Datensatz für die Zieldomäne. Für bei Exchange Online eingehende Nachrichten ist der Wert leer.

Typ:String
Position:13
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False
Gilt für::Exchange Online