Get-MessageTrackingLog

  • Artikel

 

Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Letztes Änderungsdatum des Themas: 2007-08-20

Verwenden Sie das Cmdlet Get-MessageTrackingLog zum Suchen nach Nachrichteninformationen, die im Nachrichtenverfolgungsprotokoll gespeichert sind.

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

Detaillierte Beschreibung

Auf jedem Computer, auf dem die Serverfunktion Hub-Transport, Mailbox oder Edge-Transport installiert ist, 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-Nachricht enthält, die einen einzelnen Server durchläuft.

Damit Sie das Cmdlet Get-MessageTrackingLog ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:

  • Exchange-Administrator mit Leserechten (Rolle)

Um das Cmdlet Get-MessageTrackingLog auf einem Computer ausführen zu können, auf dem die Serverfunktion Edge-Transport installiert ist, müssen Sie sich mit einem Konto anmelden, das Mitglied der lokalen Gruppe Administratoren auf diesem Computer ist.

Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Microsoft Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.

Parameter

Parameter Erforderlich Typ Beschreibung

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Um den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers anzugeben, der diese Konfigurationsänderung in den Active Directory-Verzeichnisdienst schreibt, fügen Sie den Parameter DomainController hinzu.

End

Optional

System.DateTime

Dieser Parameter gibt Einträge des Nachrichtenverfolgungsprotokolls bis zum angegebenen Enddatum und der angegebenen Uhrzeit (jedoch nicht einschließlich) zurück. Dabei verwendet er das Format der Ländereinstellungen auf dem Computer, auf dem das Cmdlet ausgeführt wird.

EventId

Optional

System.String

Dieser Parameter gibt Einträge des Nachrichtenverfolgungsprotokolls mit den folgenden möglichen Ereigniskategorien zurück: BadMail, Defer Deliver, DSN, Expand, Fail, PoisonMessage, Receive, Redirect, Resolve, Send, Submit und Transfer.

InternalMessageId

Optional

System.String

Dieser Parameter gibt Einträge des Nachrichtenverfolgungsprotokolls mit einem Wert von InternalMessagID zurück. InternalMessageID ist ein Nachrichtenbezeichner, der vom Servercomputer mit Exchange 2007 zugewiesen wird, der die Nachricht zurzeit verarbeitet.

Der Wert InternalMessageID einer bestimmten Nachricht ist im Nachrichtenverfolgungsprotokoll jedes Servercomputers mit Exchange 2007 unterschiedlich, der an der Zustellung der Nachricht beteiligt ist.

MessageId

Optional

System.String

Dieser Parameter gibt Einträge des Nachrichtenverfolgungsprotokolls mit dem angegebenen Kopfzeilenfeld Message-ID zurück. Wenn das Kopfzeilenfeld Message-ID: leer oder nicht vorhanden ist, wird ein beliebiger Wert zugewiesen. Dieser Wert ist für die Lebensdauer der Nachricht konstant.

MessageSubject

Optional

System.String

Dieser Parameter gibt Einträge des Nachrichtenverfolgungsprotokolls mit dem angegebenen Wert des Kopfzeilenfelds Subject: in der Nachricht zurück. Standardmäßig werden Nachrichtenbetreffs in den Nachrichtenverfolgungsprotokollen gespeichert. Verwenden Sie den folgenden Befehl, um die Protokollierung von Nachrichtenbetreffs zu deaktivieren:

Set-TransportServer <Identity> -MessageTrackingLogSubjectLoggingEnabled $false

Recipients

Optional

System.String[]

Dieser Parameter gibt alle Einträge des Nachrichtenverfolgungsprotokolls mit den SMTP-E-Mail-Adressen (Simple Mail Transfer Protocol) des angegebenen Empfängers zurück. Mehrere einzelne Empfänger, die in einer Nachricht enthalten sind, werden mithilfe eines Eintrags des Nachrichtenverfolgungsprotokolls protokolliert. Nicht erweiterte Empfänger der Verteilergruppe werden mithilfe der SMTP-E-Mail-Adresse der Verteilergruppe protokolliert. Mehrere Empfängerwerte können mithilfe eines Kommas als Trennzeichen angegeben werden.

Reference

Optional

System.String

Dieser Parameter gibt Einträge des Nachrichtenverfolgungsprotokolls mit dem angegebenen Wert im Feld Reference zurück.

Das Feld Reference enthält zusätzliche Informationen für bestimmte Typen von EventID:

  • Send   Das Feld Reference enthält den Wert Internet-Message-Id aller Benachrichtigungen über den Übermittlungsstatus.

  • Transfer   Dieses Feld Reference enthält den Wert Internal-Message-Id der Nachricht, die verzweigt wird.

  • DSN   Das Feld Reference enthält den Wert Internet-Message-Id der Nachricht, die die Benachrichtigung zum Übermittlungsstatus verursacht hat.

Für alle anderen Typen von EventID ist das Feld Reference leer.

ResultSize

Optional

Microsoft.Exchange.Data.Unlimited

Dieser Parameter bestimmt die maximal anzuzeigende Anzahl von Einträgen des Nachrichtenverfolgungsprotokolls. Standardmäßig werden maximal 1.000 Einträge angezeigt. Um alle Einträge anzuzeigen, verwenden Sie den Wert Unlimited.

Sender

Optional

System.String

Dieser Parameter gibt Einträge des Nachrichtenverfolgungsprotokolls mit der SMTP-E-Mail-Adresse des angegebenen Absenders zurück.

Server

Optional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Dieser Parameter gibt den Servercomputer mit Exchange 2007 an, auf dem die zu durchsuchenden Nachrichtenverfolgungsprotokolle gespeichert sind. Der Parameter Server nimmt jeden der folgenden Werte für den Zielserver an:

  • Name

  • Vollqualifizierter Domänenname (FQDN)

  • Distinguished Name (DN)

  • Legacy-Exchange-DN

  • GUID

Start

Optional

System.DateTime

Dieser Parameter gibt Einträge des Nachrichtenverfolgungsprotokolls ab dem angegebenen Startdatum und der angegebenen Uhrzeit zurück. Dabei verwendet er das Format der Ländereinstellungen auf dem Computer, auf dem das Cmdlet ausgeführt wird.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

 

 

Ausnahmen

Ausnahmen Beschreibung

 

 

Beispiel

Das erste Beispiel zeigt, wie das Cmdlet Get-MessageTrackingLog zum Abrufen von Einträgen des Nachrichtenverfolgungsprotokolls verwendet wird, die zwischen dem 13.03.06 um 9:00 Uhr und dem 15.03.06 um 17:00 Uhr mit dem Sender-Wert tbremer@contoso.com erstellt wurden.

Hinweis

Das in diesem Beispiel verwendete Datumsformat ist Englisch (USA). Verwenden Sie das Datumsformat, das auf Ihrem Servercomputer mit Exchange Server 2007 konfiguriert ist. Das von Ihnen angegebene Datum wird automatisch in das UTC-Format (Coordinated Universal Time) umgewandelt, das intern von Exchange 2007 zum Speichern von Einträgen in den Nachrichtenverfolgungsprotokollen verwendet wird.

Das zweite Beispiel zeigt, wie die Ausgabe des Cmdlets Get-MessageTrackingLog mittels Pipelining an das Cmdlet Format-List umgeleitet wird, um zusätzliche Informationen anzuzeigen, die im Nachrichtenverfolgungsprotokoll verfügbar sind.

Weitere Informationen zum Pipelining finden Sie unter Pipelining.

Weitere Informationen zum Arbeiten mit der Ausgabe eines Befehls finden Sie unter Arbeiten mit Ausgaben von Befehlen.

Get-MessageTrackingLog -Start "03/13/2006 9:00AM" -End "03/15/2006 5:00PM" -Sender "tbremer@contoso.com"
Get-MessageTrackingLog -Start "03/13/2006 9:00AM" -End "03/15/2006 5:00PM" -Sender "tbremer@contoso.com" | Format-List