Get-Message

Modul:: Exchange PowerShell

Dieses Cmdlet ist nur lokal in Exchange verfügbar.

Verwenden Sie das Cmdlet Get-Message, um die Details einer oder mehrerer Nachrichten in Warteschlangen auf Postfachservern oder Edge-Transport-Servern anzuzeigen.

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

Syntax

Filter

Get-Message
    [-Filter <String>]
    [-BookmarkIndex <Int32>]
    [-BookmarkObject <ExtensibleMessageInfo>]
    [-IncludeBookmark <Boolean>]
    [-IncludeComponentLatencyInfo]
    [-IncludeRecipientInfo]
    [-ResultSize <Unlimited>]
    [-ReturnPageInfo <Boolean>]
    [-SearchForward <Boolean>]
    [-Server <ServerIdParameter>]
    [-SortOrder <QueueViewerSortOrderEntry[]>]
    [<CommonParameters>]

Identity

Get-Message
    [[-Identity] <MessageIdentity>]
    [-BookmarkIndex <Int32>]
    [-BookmarkObject <ExtensibleMessageInfo>]
    [-IncludeBookmark <Boolean>]
    [-IncludeComponentLatencyInfo]
    [-IncludeRecipientInfo]
    [-ResultSize <Unlimited>]
    [-ReturnPageInfo <Boolean>]
    [-SearchForward <Boolean>]
    [-SortOrder <QueueViewerSortOrderEntry[]>]
    [<CommonParameters>]

Queue

Get-Message
    [-Queue <QueueIdentity>]
    [-BookmarkIndex <Int32>]
    [-BookmarkObject <ExtensibleMessageInfo>]
    [-IncludeBookmark <Boolean>]
    [-IncludeComponentLatencyInfo]
    [-IncludeRecipientInfo]
    [-ResultSize <Unlimited>]
    [-ReturnPageInfo <Boolean>]
    [-SearchForward <Boolean>]
    [-SortOrder <QueueViewerSortOrderEntry[]>]
    [<CommonParameters>]

Beschreibung

Nachrichten können angezeigt werden, indem Sie den Servernamen als Teil des Parameters Identity oder des Parameters Queue aufnehmen, oder indem Sie den Parameter Server mit einer Filterabfrage aufnehmen. Die Parameter Identity, Queue und Filter schließen sich gegenseitig aus.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Obwohl in diesem Artikel alle Parameter für das Cmdlet aufgeführt sind, haben Sie möglicherweise keinen 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-Message -Filter "FromAddress -like '*@contoso.com'" | Format-List

In diesem Beispiel werden detaillierte Informationen zu sämtlichen Nachrichten angezeigt, die sich in der Warteschlange auf dem lokalen Server befinden und von einem Absender in der Domäne "contoso.com" stammen.

Beispiel 2

Get-Message -Filter "FromAddress -like '*@contoso.com' -and SCL -gt 3"

In diesem Beispiel werden alle Nachrichten aufgelistet, die auf dem lokalen Server in die Warteschlange eingereiht werden, die von jedem Absender in der contoso.com Domäne empfangen werden und die einen SCL-Wert größer als 3 aufweisen.

Beispiel 3

Get-Message -Server Server01.contoso.com -SortOrder: +FromAddress,-Size

In diesem Beispiel werden sämtliche Nachrichten angezeigt, die sich in der Warteschlange auf dem Server "Server01" befinden. Die Ergebnisse werden zuerst in aufsteigender Reihenfolge nach der Absenderadresse und danach in absteigender Reihenfolge nach der Größe angezeigt.

Parameter

-BookmarkIndex

Der BookmarkIndex-Parameter gibt die Position im Resultset an, an der die angezeigten Ergebnisse beginnen. Der Wert dieses Parameters ist ein auf 1 basierender Index im Gesamtresultset. Der BookmarkObject-Parameter kann nicht mit dem BookmarkIndex-Parameter verwendet werden.

Parametereigenschaften

Typ:	Int32
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-BookmarkObject

Der BookmarkObject-Parameter gibt das Objekt im Resultset an, bei dem die angezeigten Ergebnisse beginnen. Der BookmarkObject-Parameter kann nicht mit dem BookmarkIndex-Parameter verwendet werden.

Parametereigenschaften

Typ:	ExtensibleMessageInfo
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Filter

Der Parameter Filter gibt eine oder mehrere Nachrichten mithilfe der OPATH-Filtersyntax an. Der OPATH-Filter enthält einen Nachrichteneigenschaftsnamen gefolgt von einem Vergleichsoperator und -wert (z. B "FromAddress -like '*@contoso.com'". ). Ausführliche Informationen zu filterbaren Nachrichteneigenschaften und Vergleichsoperatoren finden Sie unter Eigenschaften von Nachrichten in Warteschlangen und Suchen von Warteschlangen und Nachrichten in Warteschlangen in der Exchange-Verwaltungsshell.

Sie können mehrere Kriterien angeben, indem Sie den Vergleichsoperator und verwenden. Eigenschaftenwerte, die nicht als ganze Zahl ausgedrückt werden, müssen in Anführungszeichen (") eingeschlossen werden.

Parametereigenschaften

Typ:	String
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

Filter

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Identity

Der Parameter Identity gibt die Nachricht an. Gültige Eingaben für diesen Parameter verwenden die Syntax Server\Queue\MessageInteger oder Queue\MessageInteger oder MessageInteger, z. B. Mailbox01\contoso.com\5 oder 10. Ausführliche Informationen zur Nachrichtenidentität finden Sie unter Nachrichtenidentität.

Achtung: Der Wert $null oder ein nicht vorhandener Wert für den Identity-Parameter gibt alle Objekte zurück, als ob Sie den Get-Befehl ohne den Identity-Parameter ausgeführt haben. Vergewissern Sie sich, dass listen von Werten für den Identity-Parameter korrekt sind und keine nicht vorhandenen $null-Werte enthalten.

Parametereigenschaften

Typ:	MessageIdentity
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

Identity

Position:	1
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-IncludeBookmark

Der IncludeBookmark-Parameter gibt an, ob das Lesezeichenobjekt aufgenommen werden soll, wenn die Abfrageergebnisse angezeigt werden. Der IncludeBookmark-Parameter ist gültig, wenn er zusammen mit dem BookmarkObject- oder BookmarkIndex-Parameter verwendet wird. Wenn Sie für den IncludeBookmark-Parameter keinen Wert angeben, wird der Standardwert $true verwendet.

Parametereigenschaften

Typ:	Boolean
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-IncludeComponentLatencyInfo

Die Option IncludeComponentLatencyInfo gibt an, ob die Informationen zur Komponentenwartezeit in den Nachrichteneigenschaften enthalten sein sollen. Sie müssen keinen Wert für diese Option angeben.

Wenn Sie diesen Switch einschließen, enthalten die zurückgegebenen Nachrichtenobjekte Latenzmessungen für jede Transportkomponente, die zur Lokalen Serverlatenz für jede Nachricht in der Warteschlange beigetragen hat.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-IncludeRecipientInfo

Der Switch IncludeRecipientInfo gibt an, ob die Nachrichtenempfänger im Feld Empfänger angezeigt werden sollen. Sie müssen keinen Wert für diese Option angeben.

Wenn Sie den Switch IncludeRecipientInfo nicht aufnehmen, bleibt 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:

Absender: Die E-Mail-Adresse des Empfängers.
Typ: Der Empfängertyp, der extern, Postfach oder Verteilergruppe sein kann. "Verteilergruppe" wird verwendet, wenn das Ziel ein Server für die Aufgliederung der Verteilerlisten ist.
FinalDestination: Der DN (Distinguished Name) des Objekts, das für das Routing der Nachricht verwendet wird.
Status: Der Empfänger status kann abgeschlossen, Bereit oder Wiederholen sein.
LastError: Die SMTP-Antwort nach dem letzten Zustellungsversuch oder eine lokalisierte Fehlermeldung, wenn die Nachricht in der Nicht-erreichbar-Warteschlange gespeichert ist.

Um beispielsweise die Empfängerinformationen einer Nachricht in der contoso.com Remoteübermittlungswarteschlange mit dem MessageIdentity-Wert 1234 in einer Variablen namens $x zu speichern, verwenden Sie den folgenden Befehl: $x=Get-Message -Identity "contoso.com\\1234" -IncludeRecipientInfo.

Verwenden Sie den folgenden Befehl, um die erweiterten Empfängereigenschaften anzuzeigen, die jetzt in der variablen $x gespeichert sind: $x.Recipients.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Queue

Der Parameter Queue gibt die Identität der Warteschlange mit den anzuzeigenden Nachrichten an. Gültige Eingaben für diesen Parameter verwenden die Syntax <Server>\<Queue> oder <Queue>, z. B. Mailbox01\contoso.com oder Nicht erreichbar. Ausführliche Informationen zur Warteschlangenidentität finden Sie im Abschnitt "Warteschlangenidentität" unter Suchen von Warteschlangen und Nachrichten in Warteschlangen in der Exchange-Verwaltungsshell.

Bei Verwendung des Parameters Queue können die Parameter Identity, Filter oder Server nicht verwendet werden.

Parametereigenschaften

Typ:	QueueIdentity
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

Queue

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	True
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

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

Parametereigenschaften

Typ:	Unlimited
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-ReturnPageInfo

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.

Parametereigenschaften

Typ:	Boolean
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-SearchForward

Der SearchForward-Parameter gibt an, ob im Resultset vorwärts oder rückwärts gesucht werden soll. Der Standardwert lautet $true. Dieser Wert bewirkt, dass die Ergebnisseite entweder ab dem Beginn des Resultsets oder ab einer Markierung, falls angegeben, vorwärts berechnet wird.

Parametereigenschaften

Typ:	Boolean
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-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

Der Server-Parameter kann zusammen mit dem Filter-Parameter in demselben Befehl verwendet werden. Die Identity- und Server-Parameter können daher nicht in demselben Befehl verwendet werden.

Parametereigenschaften

Typ:	ServerIdParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

Filter

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	True
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-SortOrder

Der SortOrder-Parameter gibt ein Array mit Nachrichteneigenschaften an, die verwendet werden, um die Sortierreihenfolge des Resultsets zu steuern. Trennen Sie die Eigenschaften durch Kommas. Stellen Sie dem Eigenschaftsnamen ein Pluszeichen (+) voran, um die Ergebnisse in aufsteigender Reihenfolge anzuzeigen. Stellen Sie dem Eigenschaftsnamen ein Minuszeichen (-) voran, um die Ergebnisse in absteigender Reihenfolge anzuzeigen.

Wenn Sie keine Sortierreihenfolge angeben, wird das Resultset gemäß der ganzen Zahl MessageIdentity angezeigt.

Parametereigenschaften

Typ:	QueueViewerSortOrderEntry[]
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.

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 und die von diesem Cmdlet akzeptiert werden, finden Sie unter Eingabe- und Ausgabetypen von Cmdlets. Wenn das Feld mit dem Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.

Feedback

War diese Seite hilfreich?

Freigeben über

Get-Message

Syntax

Filter

Identity

Queue

Beschreibung

Beispiele

Beispiel 1

Beispiel 2

Beispiel 3

Parameter

-BookmarkIndex

Parametereigenschaften

Parametersätze

-BookmarkObject

Parametereigenschaften

Parametersätze

-Filter

Parametereigenschaften

Parametersätze

-Identity

Parametereigenschaften

Parametersätze

-IncludeBookmark

Parametereigenschaften

Parametersätze

-IncludeComponentLatencyInfo

Parametereigenschaften

Parametersätze

-IncludeRecipientInfo

Parametereigenschaften

Parametersätze

-Queue

Parametereigenschaften

Parametersätze

-ResultSize

Parametereigenschaften

Parametersätze

-ReturnPageInfo

Parametereigenschaften

Parametersätze

-SearchForward

Parametereigenschaften

Parametersätze

-Server

Parametereigenschaften

Parametersätze

-SortOrder

Parametereigenschaften

Parametersätze

CommonParameters

Eingaben

Input types

Ausgaben

Output types

Feedback