Get-MessageTrackingLog
Dieses Cmdlet ist nur lokal in Exchange verfügbar.
Verwenden Sie das Cmdlet Get-MessageTrackingLog, um nach Nachrichtenzustellungsinformationen zu suchen, die im Nachrichtenverfolgungsprotokoll gespeichert sind.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Get-MessageTrackingLog
[-DomainController <Fqdn>]
[-End <DateTime>]
[-EventId <String>]
[-InternalMessageId <String>]
[-MessageId <String>]
[-MessageSubject <String>]
[-Recipients <String[]>]
[-Reference <String>]
[-ResultSize <Unlimited>]
[-Sender <String>]
[-Server <ServerIdParameter>]
[-Start <DateTime>]
[-NetworkMessageId <String>]
[-Source <String>]
[-TransportTrafficType <String>]
[<CommonParameters>] Beschreibung
Für den Transportdienst auf einem Postfachserver sowie für den Postfachtransportdienst auf einem Postfachserver und auf einem Edge-Transport-Server ist ein eindeutiges Nachrichtenverfolgungsprotokoll vorhanden. Das Nachrichtenverfolgungsprotokoll ist eine CSV-Datei (Comma-Separated Value, durch Kommas getrennte Werte), die ausführliche Informationen zum Verlauf jeder E-Mail enthält, die einen Exchange-Server durchläuft.
Die in den Ergebnissen des Cmdlets Get-MessageTrackingLog angezeigten Feldnamen ähneln den tatsächlichen Feldnamen, die in den Nachrichtenverfolgungsprotokollen verwendet werden. Es gibt folgende Unterschiede:
- Die Striche werden aus den Feldnamen entfernt. Beispiel: internal-message-id wird angezeigt als InternalMessageId.
- Das Feld date-time wird angezeigt als Timestamp.
- Das Feld recipient-address wird als Recipients angezeigt.
- Das Feld sender-address wird als Sender angezeigt.
Weitere Informationen zu den Protokolldateien für die Nachrichtennachverfolgung finden Sie unter Nachrichtennachverfolgung.
Sie können die Ergebnisse in eine Datei schreiben, indem Sie die Ausgabe an die ConvertTo-Html oder ConvertTo-Csv umleiten und > <filename> zum Befehl hinzufügen. Beispiel: Get-MessageTrackingLog -Start "03/13/2020 09:00:00" -End "03/13/2020 09:10:00" | ConvertTo-Html > "C:\My Documents\message track.html".
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-MessageTrackingLog -Server Mailbox01 -Start "03/13/2018 09:00:00" -End "03/15/2018 17:00:00" -Sender "john@contoso.com"In diesem Beispiel werden die Nachrichtenverfolgungsprotokolle auf dem Postfachserver Mailbox01 nach Informationen zu allen Nachrichten durchsucht, die vom 13. März 2018, 09:00 Uhr bis zum 15. März 2018, 17:00 Uhr vom Absender john@contoso.comgesendet wurden.
Parameter
-DomainController
Der Parameter "DomainController" gibt den Domänencontroller an, der von diesem Cmdlet verwendet wird, um aus Active Directory Daten zu lesen oder hineinzuschreiben. Der Domänencontroller kann anhand seines vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) ermittelt werden. Beispiel: dc01.contoso.com.
Der DomainController-Parameter wird auf Edge-Transport-Servern nicht unterstützt. Edge-Transport-Server verwenden die lokale Instanz von Active Directory Lightweight Directory Services (AD LDS), um Daten zu lesen und zu schreiben.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-End
Der Parameter End gibt das Enddatum und die Uhrzeit des Datumsbereichs an. Informationen zur Nachrichtenzustellung werden bis zu dem angegebenen Datum und der angegebenen Uhrzeit, jedoch ausschließlich dieser Zeitangaben, zurückgegeben.
Verwenden Sie das unter "Regionale Einstellungen" definierte kurze Datumsformat für den Computer, auf dem der Befehl ausgeführt wird. Wenn auf dem Computer z. B. das kurze Datumsformat TT.MM.JJJJ konfiguriert ist, geben Sie "01.09.2018" ein, um als Datum den 1. September 2018 anzugeben. Sie können entweder nur das Datum oder das Datum und die Uhrzeit angeben. Wenn Sie das Datum und die Uhrzeit eingeben, setzen Sie das den Wert in Anführungszeichen ("), z. B. "09.01.2018 17:00".
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-EventId
Der Parameter EventId filtert die Einträge des Nachrichtenverfolgungsprotokolls anhand des Werts im Feld EventId. Der EventId-Wert klassifiziert jedes Nachrichtenereignis. Beispielwerte sind DSN, Defer, Deliver, Send oder Receive.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-InternalMessageId
Der Parameter InternalMessageId filtert die Einträge des Nachrichtenverfolgungsprotokolls anhand des Werts im Feld InternalMessageId. Beim Wert InternalMessageId handelt es sich um eine Nachrichten-ID, die von dem Exchange-Server zugewiesen wird, der die Nachricht aktuell verarbeitet.
Der Wert der internal-message-id für eine bestimmte Nachricht unterscheidet sich im Nachrichtenverfolgungsprotokoll der einzelnen Exchange-Server, die an der Zustellung der Nachricht beteiligt sind.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MessageId
Der Parameter MessageId filtert die Einträge des Nachrichtenverfolgungsprotokolls anhand des Werts im Feld MessageId. Der Wert von MessageId entspricht dem Wert des Kopfzeilenfelds Message-Id: in der Nachricht. Wenn das Kopfzeilenfeld Message-ID leer oder nicht vorhanden ist, wird ein beliebiger Wert zugewiesen. Achten Sie darauf, die vollständige MessageId-Zeichenfolge (die spitze Klammern enthalten kann) einzuschließen und den Wert in Anführungszeichen (z. B. "d9683b4c-127b-413a-ae2e-fa7dfb32c69d@contoso.com") einzuschließen.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MessageSubject
Der Parameter MessageSubject filtert die Einträge des Nachrichtenverfolgungsprotokolls anhand des Werts im Nachrichtenbetreff. Der Wert des Parameters MessageSubject unterstützt automatisch Teilübereinstimmungen, ohne dass Platzhalter oder Sonderzeichen verwendet werden. Wenn Sie beispielsweise den MessageSubject-Wert sea angeben, werden Nachrichten mit Seattle im Betreff in die Ergebnisliste aufgenommen. Standardmäßig werden Nachrichtenbetreffs in den Nachrichtenverfolgungsprotokollen gespeichert.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-NetworkMessageId
Der Parameter NetworkMessageId filtert die Protokolleinträge für die Nachrichtennachverfolgung nach dem Wert des Felds NetworkMessageId. Dieses Feld enthält einen eindeutigen Nachrichten-ID-Wert, der über Kopien der Nachricht hinweg beibehalten wird, die aufgrund der Verzweigung oder Verteilergruppenerweiterung erstellt werden können. Ein Beispielwert ist „1341ac7b13fb42ab4d4408cf7f55890f“.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Recipients
Der Parameter Recipients filtert die Einträge des Nachrichtenverfolgungsprotokolls anhand der SMTP-E-Mail-Adresse der Nachrichtenempfänger. Mehrere Empfänger, die in einer Nachricht enthalten sind, werden in einem einzigen Eintrag des Nachrichtenverfolgungsprotokolls aufgeführt. Nicht erweiterte Empfänger der Verteilergruppe werden anhand der SMTP-E-Mail-Adresse der Gruppe protokolliert. Die E-Mail-Adressen mehrerer Empfänger können durch Kommas getrennt angegeben werden.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Reference
Der Parameter Reference filtert die Einträge des Nachrichtenverfolgungsprotokolls anhand des Werts im Feld Reference. Das Reference-Feld enthält zusätzliche Informationen für bestimmte Ereignistypen. Beispielsweise enthält der Wert des Felds Reference für einen DSN-Nachrichtenverfolgungseintrag den Wert InternalMessageId der Nachricht, welche die Benachrichtigung über den Zustellungsstatus verursacht hat. Für viele Arten von Ereignissen ist der Wert von Reference leer.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ResultSize
Der ResultSize-Parameter gibt die maximale Anzahl von zurückzugebenden Ergebnissen an. Wenn Sie alle Anforderungen zurückgeben möchten, die der Abfrage entsprechen, verwenden Sie unlimited als Wert für diesen Parameter. Der Standardwert ist 1000.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Sender
Der Parameter Sender filtert die Einträge des Nachrichtenverfolgungsprotokolls anhand der SMTP-E-Mail-Adresse des Absenders.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Server
Der Parameter "Server" gibt den Exchange-Server an, auf dem dieser Befehl ausgeführt werden soll. Der Parameter MailboxServer gibt den zu testenden exExchange2k16- oder exExchange2k13-Postfachserver an. Beispiel:
- Name
- FQDN
- Distinguished Name (DN)
- Exchange-Legacy-DN
Exchange-Legacy-DN
| Type: | ServerIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Source
Der Parameter Source filtert die Einträge des Nachrichtenverfolgungsprotokolls anhand des Werts im Feld Source. Diese Werte geben die Transportkomponente an, die für das Nachrichtenverfolgungsereignis zuständig ist. Weitere Informationen finden Sie unter Source values in the message tracking log.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Start
Der Parameter Start 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 auf dem Computer z. B. das kurze Datumsformat TT.MM.JJJJ konfiguriert ist, geben Sie "01.09.2018" ein, um als Datum den 1. September 2018 anzugeben. Sie können entweder nur das Datum oder das Datum und die Uhrzeit angeben. Wenn Sie das Datum und die Uhrzeit eingeben, setzen Sie das den Wert in Anführungszeichen ("), z. B. "09.01.2018 17:00".
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-TransportTrafficType
Der Parameter TransportTrafficType filtert die Einträge des Nachrichtenverfolgungsprotokolls anhand des Werts im Feld TransportTrafficType. Dieses Feld ist jedoch für lokale Exchange-Organisationen nicht interessant.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
Eingaben
Input types
Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.
Ausgaben
Output types
Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden, die dieses Cmdlet akzeptiert, finden Sie unter Cmdlet Input and Output Types. Wenn das Feld Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.