Get-Message

  • Artikel

 

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

Letztes Änderungsdatum des Themas: 2007-08-29

Mit dem Cmdlet Get-Message können Sie die Details einer oder mehrerer Nachrichten in einer Warteschlange auf einem Computer anzeigen, auf dem die Serverfunktion Hub-Transport oder Edge-Transport installiert ist.

Syntax

Get-Message [-BookmarkIndex <Int32>] [-BookmarkObject <MessageInfo>] [-Filter <String>] [-IncludeBookmark <$true | $false>] [-IncludeRecipientInfo <SwitchParameter>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-Server <ServerIdParameter>] [-SortOrder <SortOrderEntry[]>]

Get-Message [-Identity <MessageIdentity>] [-BookmarkIndex <Int32>] [-BookmarkObject <MessageInfo>] [-IncludeBookmark <$true | $false>] [-IncludeRecipientInfo <SwitchParameter>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-SortOrder <SortOrderEntry[]>]

Get-Message [-BookmarkIndex <Int32>] [-BookmarkObject <MessageInfo>] [-IncludeBookmark <$true | $false>] [-IncludeRecipientInfo <SwitchParameter>] [-Queue <QueueIdentity>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-SortOrder <SortOrderEntry[]>]

Detaillierte Beschreibung

Das Cmdlet Get-Message dient zum Anzeigen der Details einer oder mehrerer Nachrichten in einer Warteschlange auf einem Hub-Transport- oder Edge-Transport-Server. Wenn Sie keine Parameter angeben, fragt der Befehl alle Nachrichten in beliebigen Warteschlangen auf dem lokalen Server ab und gibt eine einzelne Ergebnisseite zurück. Auf dieser Seite werden standardmäßig 1000 Objekte angezeigt. Sie können Nachrichten auf einem Remoteserver anzeigen, indem Sie den Servernamen im Parameter Identity oder Queue angeben oder den Parameter Server einer Filterabfrage hinzufügen. Die Parameter Identity, Queue und Filter schließen sich gegenseitig aus.

Damit Sie das Cmdlet Get-Message ausführen können, muss dem Konto die Rolle Exchange-Serveradministratoren zugewiesen worden sein.

Um das Cmdlet Get-Message 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

BookmarkIndex

Optional

System.Int32

Mit dem Parameter BookmarkIndex geben Sie die Position im Resultset an, an der die angezeigten Ergebnisse beginnen. Der Wert dieses Parameters ist ein auf 1 basierender Index im Gesamtresultset. BookmarkIndex darf nicht zusammen mit dem Parameter BookmarkObject verwendet werden.

BookmarkObject

Optional

Microsoft.Exchange.Data.QueueViewer.MessageInfo

Mit dem Parameter BookmarkObject geben Sie das Objekt im Resultset an, bei dem die angezeigten Ergebnisse beginnen. BookmarkObjectBookmarkIndex darf nicht zusammen mit dem Parameter BookmarkIndex verwendet werden.

Filter

Optional

System.String

Der Parameter Filter benötigt einen Ausdruck, mit dem die Eigenschaftswertkriterien für die anzuzeigenden Nachrichten angegeben werden. Der Ausdruck schließt einen Eigenschaftennamen, gefolgt von einem Vergleichsoperator und einem Wert, ein. Die folgenden Nachrichteneigenschaften stellen gültige Kriterien für den Parameter Filter dar:

  • DateReceived   Das Datum, an dem die Nachricht empfangen wurde.

  • ExpirationTime   Die Uhrzeit, zu der die Nachricht abläuft.

  • FromAddress   Die SMTP-Adresse (Simple Mail Transfer Protocol) des Absenders einer Nachricht. Dieser Wert wird von MAIL FROM: im Nachrichtenumschlag übernommen.

  • Identity   Eine ganze Zahl, die eine bestimmte Nachricht und eine optionale Server- und Warteschlangenidentität darstellt.

  • InternetMessageId   Der Wert des Kopfzeilenfelds Message-ID:. Diese Eigenschaft wird als GUID, gefolgt von der SMTP-Adresse des sendenden Servers, ausgedrückt. Siehe folgendes Beispiel: 67D7543D6103DC4FBEBA6BC7205DACABA61231@exchange.contoso.com.

  • LastError   Eine Textzeichenfolge mit dem letzten für eine Nachricht aufgezeichneten Fehler.

  • MessageSourceName   Eine Textzeichenfolge mit dem Namen der Komponente, die diese Nachricht an die Warteschlange gesendet hat.

  • Queue   Gibt die Identität der Warteschlange an, in der sich die Nachricht befindet. Geben Sie die Warteschlangenidentität in der Form Server\Ziel ein, wobei Ziel für eine Remotedomäne, einen Postfachserver oder den Namen einer beständigen Warteschlange steht.

  • RetryCount   Die Anzahl der Übermittlungsversuche einer Nachricht an ein Ziel.

  • SCL   Die SCL-Eigenschaft gibt die SCL-Bewertung (Spam Confidence Level) einer Nachricht an. Gültige SCL-Einträge sind die ganzen Zahlen von 0 bis 9. Ein leerer SCL-Eigenschaftenwert zeigt an, dass die Nachricht nicht vom Inhaltsfilter-Agent verarbeitet wurde.

  • Size   Die Größe der Nachricht.

  • SourceIP   Die IP-Adresse des externen Servers, der die Nachricht an die Exchange-Organisation gesendet hat.

  • Status   Der aktuelle Nachrichtenstatus. Die Optionen für den Nachrichtenstatus sind Aktiv, Angehalten, PendingSuspend und PendingRemove.

  • Subject   Eine Textzeichenfolge, die den Betreff einer E-Mail-Nachricht darstellt. Der Wert wird aus dem Kopfzeilenfeld Subject: übernommen.

Mithilfe des Vergleichsoperators - and können mehrere Filterkriterien angegeben werden. Eigenschaftenwerte, die nicht als einzelne ganze Zahl ausgedrückt sind, müssen in Anführungszeichen eingeschlossen werden.

Identity

Optional

Microsoft.Exchange.Data.QueueViewer.MessageIdentity

Verwenden Sie den Identity-Parameter, um die ganze Zahl MessageIdentity anzugeben. Dies ist ganze Zahl, die eine bestimmte Nachricht und eine optionale Server- und Warteschlangenidentität darstellt. Für diesen Parameter gilt die folgende Syntax:

  • Server\QueueIdentity\MessageIdentity

  • QueueIdentity\MessageIdentity

  • Server\*\MessageIdentity

  • MessageIdentity

IncludeBookmark

Optional

System.Boolean

Mit dem Parameter IncludeBookmark geben Sie, ob das Markierungsobjekt hinzugefügt werden soll, wenn die Abfrageergebnisse angezeigt werden. Der Parameter IncludeBookmark ist gültig, wenn er zusammen mit den Parametern BookmarkObject oder BookmarkIndex verwendet wird. Wenn Sie für den Parameter IncludeBookmark keinen Wert angeben, wird der Standardwert $true verwendet.

IncludeRecipientInfo

Optional

System.Management.Automation.SwitchParameter

Verwenden Sie den Parameter IncludeRecipientInfo, um die Nachrichtenempfänger im Feld Empfänger anzuzeigen. Wenn der Parameter IncludeRecipientInfo nicht verwendet wird, ist das Feld Empfänger leer.

Wenn Sie die Ergebnisse eines Get-Message -IncludeRecipientInfo-Befehls in einer Variablen speichern, können Sie zusätzliche Eigenschaften für die Nachrichtenempfänger anzeigen. In der folgenden Liste werden die verfügbaren Empfängereigenschaften beschrieben:

  • Address   Die E-Mail-Adresse des Empfängers

  • Type   Der Empfängertyp kann "Extern", "Postfach" oder "DL" sein. DL wird verwendet, wenn das Ziel ein Server für die Aufgliederung von Verteilerlisten ist.

  • FinalDestination   Der DN (Distinguished Name) des Objekts, das für das Routing der Nachricht verwendet wird. Das Objekt kann ein Connector, ein Postfachserver oder ein Server für die Aufgliederung von Verteilerlisten sein.

  • Status   Der Empfängerstatus kann "Abgeschlossen", "Bereit" oder "Wiederholen" lauten.

  • LastError   Die SMTP-Antwort nach dem letzten Zustellungsversuch oder eine lokalisierte Fehlermeldung, wenn die Nachricht in der Nicht erreichbar-Warteschlange gespeichert ist.

Um die Empfängerinformationen einer Nachricht in der Remoteübermittlungswarteschlange "Contoso.com", die einen MessageIdentity-Wert von 1234 besitzt, z. B. in einer Variablen namens $x zu speichern, verwenden Sie den folgenden Befehl:

$x=Get-Message -Identity "Contoso.com\1234" -IncludeRecipientInfo

Um die erweiterten Empfängereigenschaften anzuzeigen, die nun in der Variablen $x gespeichert sind, verwenden Sie den folgenden Befehl:

$x.Recipients

Queue

Optional

Microsoft.Exchange.Data.QueueViewer.QueueIdentity

Mit dem Parameter Queue geben Sie die Identität der Warteschlange mit den anzuzeigenden Nachrichten an. Geben Sie die Warteschlangenidentität in der Form Server\Ziel ein, wobei Ziel für eine Remotedomäne, einen Postfachserver oder den Namen einer beständigen Warteschlange steht.

ResultSize

Optional

Microsoft.Exchange.Data.Unlimited

Mit dem Parameter ResultSize geben Sie die Gesamtzahl der im Resultset anzuzeigenden Elemente an. Der standardmäßige Parameterwert von ResultSize ist 1000. ResultSize unterstützt unbegrenzt viele Ergebnisse, doch Microsoft Exchange beschränkt das Resultset auf 250.000.

ReturnPageInfo

Optional

System.Boolean

Der ReturnPageInfo-Parameter ist ein ausgeblendeter Parameter. Er dient zum Zurückgeben von Informationen zur Gesamtzahl der Ergebnisse und des Indexes des ersten Objekts auf der aktuellen Seite. Der Standardwert ist $false.

SearchForward

Optional

System.Boolean

Mit dem Parameter SearchForward geben Sie an, ob das Resultset vorwärts oder rückwärts durchsucht werden soll. Der Standardwert ist $true. Dieser Wert bewirkt, dass die Ergebnisseite entweder ab dem Beginn des Resultsets oder ab einer Markierung, falls angegeben, vorwärts berechnet wird.

Server

Optional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Mit dem Parameter Server geben Sie den Namen des Servers an, mit dem über das RPC-Protokoll (Remote Procedure Call) eine Verbindung hergestellt werden soll und auf dem sich die Warteschlangen mit den Nachrichten befinden, die Sie anzeigen möchten. Geben Sie den Parameter Server als Hostnamen oder vollqualifizierten Domänennamen (FQDN, Fully Qualified Domain Name) ein. Wird dieser Parameter nicht verwendet, wird der lokale Server abgefragt.

SortOrder

Optional

Microsoft.Exchange.Configuration.Tasks.SortOrderEntry[]

Mit dem Parameter SortOrder geben Sie ein Array von Nachrichteneigenschaften an, mit dem die Sortierreihenfolge des Resultsets bestimmt wird. Trennen Sie die Eigenschaften durch Kommas. Fügen Sie das Symbol + am Anfang des Eigenschaftennamens an, um die Ergebnisse in aufsteigender Reihenfolge anzuzeigen. Fügen Sie das Symbol - am Anfang des Eigenschaftennamens an, um die Ergebnisse in absteigender Reihenfolge anzuzeigen. Wenn Sie keine Sortierreihenfolge angeben, wird das Resultset gemäß der ganzen Zahl MessageIdentity angezeigt.

Beispiel

Das folgende Codebeispiel veranschaulicht das Abfragen von Nachrichten mithilfe des Befehls Get-Message. Das erste Beispiel zeigt, wie alle Nachrichten angezeigt werden, die sich auf dem lokalen Server in einer Warteschlange befinden und von beliebigen Absendern aus der angegebenen Domäne empfangen wurden. Der Befehl kann über eine Pipe an den Befehl Format-List übergeben werden, damit die Ergebnisse als detaillierte Liste formatiert werden.

Das zweite Beispiel zeigt, wie alle Nachrichten angezeigt werden, die sich auf dem lokalen Server in einer Warteschlange befinden, von beliebigen Absendern aus der angegebenen Domäne empfangen wurden und einen SCL-Wert größer als 3 haben.

Das dritte Beispiel zeigt, wie eine Verbindung mit einem Remoteserver hergestellt wird und anschließend alle Nachrichten in einer Warteschlange auf dem Remoteserver in der angegebenen Sortierreihenfolge angezeigt werden. Die Ergebnisse werden zuerst in aufsteigender Reihenfolge nach der Absenderadresse und danach in absteigender Reihenfolge nach der Größe angezeigt.

Weitere Informationen zum Pipelining finden Sie unter Pipelining.

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

Weitere Informationen zum Verwenden der Exchange-Verwaltungsshell für Aufgaben der Warteschlangenanzeige Sie unter Verwenden der Exchange-Verwaltungsshell zum Verwalten von Warteschlangen.

Get-Message -Filter {FromAddress -like "*@contoso.com"} | format-list
Get-Message -Filter {FromAddress -like "*@contoso.com" -and SCL -gt 3}
Get-Message -Server exchange.contoso.com -SortOrder: +FromAddress,-Size