Share via


Suchen von Warteschlangen und Nachrichten in Warteschlangen in der Exchange-Verwaltungsshell

Wie in früheren Versionen von Exchange können Sie die Exchange-Verwaltungsshell in Exchange Server verwenden, um Informationen zu Warteschlangen und Nachrichten anzuzeigen und diese Informationen zu Verwenden, um Maßnahmen für Warteschlangen und Nachrichten zu ergreifen. In der Regel enthält ein aktiver Exchange eine große Anzahl von Warteschlangen und nachrichten, die übermittelt werden sollen. Daher ist es wichtig zu verstehen, wie die Warteschlangen oder Nachrichten identifiziert werden, die Sie verwalten möchten.

Beachten Sie, dass Sie auch die Warteschlangenanzeige in der Exchange-Toolbox für die Verwaltung von Warteschlangen und Nachrichten in Warteschlangen verwenden können. Die Warteschlangen- und Nachrichtenanzeige-Cmdlets in der Exchange-Verwaltungsshell unterstützen jedoch mehr filterbare Eigenschaften und Filteroptionen als Queue Viewer. Weitere Informationen zur Verwendung der Warteschlangenanzeige finden Sie unter Warteschlangenanzeige.

Denken Sie auch daran, dass Warteschlangen auf Postfachservern und Edge-Transport-Servern (dem Transportdienst) vorhanden sind. Weitere Informationen zu Warteschlangen und Nachrichten in Warteschlangen finden Sie unter Warteschlangen und Nachrichten in Warteschlangen.

Parameter zur Warteschlangenfilterung

In der folgenden Tabelle sind die Filterparameter zusammengefasst, die in den Cmdlets für die Warteschlangenverwaltung verfügbar sind.

Cmdlet Filterparameter Kommentare
Get-Queue Exclude
Filter
Identity
Include
Server
Sie können die Parameter Include und Exclude mit den anderen Filterparametern im gleichen Befehl verwenden.
Sie können die Parameter Identity und Filter nicht im gleichen Befehl verwenden.
Der Parameter Server gibt den Server an, auf dem Sie den Befehl ausführen möchten. Sie können die Parameter Server und Identity nicht im gleichen Befehl verwenden, aber Sie können den Server-Parameter mit den anderen Filterparametern im gleichen Befehl verwenden.
Resume-Queue
Retry-Queue
Suspend-Queue
Identity
Filter
Server
Sie können den Identity-Parameter nicht mit den anderen Filterparametern im gleichen Befehl verwenden.
Der Parameter Server gibt den Server an, auf dem Sie den Befehl ausführen möchten. Sie können die Parameter Server und Filter im gleichen Befehl verwenden.
Get-QueueDigest Dag
Filter
Forest
Server
Site
Sie müssen einen der Dag-, Standort-, Server- oder Gesamtstrukturparameter verwenden, aber sie können nicht zusammen im selben Befehl verwendet werden.
Sie können den Filter-Parameter mit jedem der anderen Filterparameter verwenden.

Warteschlangenidentität

Der Parameter Identity verwendet die grundlegende Syntax <Serverwarteschlange>\ <>. In der Regel identifiziert dieser Wert die Warteschlange eindeutig, sodass Sie keine anderen Filterparameter mit dem Identity-Parameter verwenden können. Die Ausnahme ist das Cmdlet Get-Queue , in dem Sie die Include - und Exclude-Parameter mit dem Identity-Parameter verwenden können.

In der folgenden Tabelle wird die Syntax des Identity-Parameters für die Warteschlangenverwaltung erläutert.

Wert des Identity-Parameters Beschreibung
<Server>\<PersistentQueueName> oder <PersistentQueueName> Eine persistente Warteschlange auf dem angegebenen oder lokalen Server.
<PersistentQueueName> ist Submission, Unreachableoder Poison.
Weitere Informationen zu persistenten Warteschlangen finden Sie unter Typen von Warteschlangen.
<Server>\<NextHopDomain> oder <NextHopDomain> Eine Zustellungswarteschlange auf dem angegebenen oder lokalen Server.
<NextHopDomain> ist der Name der Warteschlange aus dem Wert der NextHopDomain-Eigenschaft der Warteschlange. Beispielsweise der Adressraum eines Sendeconnectors, der Name eines Active Directory-Standorts oder der Name einer DAG. Weitere Informationen finden Sie unter NextHopSolutionKey.
<Server>\<QueueInteger> oder <QueueInteger> Eine Zustellungswarteschlange auf dem angegebenen oder lokalen Server.
<QueueInteger> ist der eindeutige ganzzahlige Wert, der einer Zustellungswarteschlange oder einer Schattenwarteschlange in der Warteschlangendatenbank zugewiesen ist. Sie müssen jedoch das Cmdlet Get-Queue ausführen, um diesen Wert in den Eigenschaften Identity oder QueueIdentity zu finden.
<Server>\Shadow\<QueueInteger> oder Shadow\<QueueInteger> Eine Schattenwarteschlange auf dem angegebenen oder lokalen Server. Weitere Informationen zu Schattenwarteschlangen und Schattenredundanz finden Sie unter Schattenredundanz in Exchange Server.
<Server>\* oder * Alle Warteschlangen auf dem angegebenen oder lokalen Server.
Hinweis: Identity ist ein Positionsparameter, was bedeutet, dass Sie den Wert ohne Angabe des -Identity Qualifizierers angeben können. Die folgenden Befehle führen beispielsweise zu demselben Ergebnis:
Get-Queue -Identity *
Get-Queue *
Get-Queue

Filterparameter für Warteschlangen-Cmdlets

Sie können den Filter-Parameter für alle Warteschlangenverwaltungs-Cmdlets verwenden, um eine oder mehrere Warteschlangen basierend auf den Eigenschaften der Warteschlangen zu identifizieren. Der Filter-Parameter erstellt einen OPath-Filter mit Vergleichsoperatoren, um den Befehl auf Warteschlangen zu beschränken, die die Filterkriterien erfüllen. Sie können den logischen Operator -and verwenden, um mehrere Bedingungen für die Übereinstimmung anzugeben. Hier ist ein generisches Beispiel für die Syntax:

Get-Queue -Filter "<Property1> -<ComparisonOperator> '<Value1>' -and <Property2> -<ComparisonOperator> '<Value2>'..."

Eine vollständige Liste der Warteschlangeneigenschaften, die Sie mit dem Parameter Filter verwenden können, finden Sie unter Warteschlangeneigenschaften.

Eine Liste der Vergleichsoperatoren, die Sie mit dem Filter-Parameter verwenden können, finden Sie im Abschnitt Vergleichsoperatoren, die beim Filtern von Warteschlangen oder Nachrichten in diesem Thema verwendet werden sollen.

Beispiele für Prozeduren, die den Filter-Parameter zum Anzeigen und Verwalten von Warteschlangen verwenden, finden Sie unter Verfahren für Warteschlangen.

Include- und Exclude-Parameter für Get-Queue

Sie können die Parameter Include und Exclude für das Cmdlet Get-Queue allein, mit jedem othe oder mit den anderen Filterparametern verwenden, um Ihre Ergebnisse zu optimieren. Sie haben beispielsweise folgende Möglichkeiten:

  • Schließen Sie leere Warteschlangen aus.

  • Schließen Sie Warteschlangen für externe Ziele aus.

  • Schließen Sie Warteschlangen ein, die einen bestimmten Wert von DeliveryType haben.

Die Parameter Include und Exclude verwenden zum Filtern von Warteschlangen die folgenden Warteschlangeneigenschaften:

Wert Beschreibung Beispiel
DeliveryType Schließt Warteschlangen basierend auf der DeliveryType-Eigenschaft ein oder aus, die definiert, wie die Nachricht an den nächsten Hop übertragen wird. Die gültigen Werte werden unter NextHopSolutionKey beschrieben.
Es können mehrere Werte durch Kommata getrennt angegeben werden.
Gibt alle Zustellungswarteschlangen auf dem lokalen Server zurück, auf dem der nächste Hop ein Sendeconnector ist, der auf dem lokalen Server gehostet wird und für intelligentes Hostrouting konfiguriert ist.
Get-Queue -Include SmartHostConnectorDelivery
Empty Schließt leere Warteschlangen ein oder aus. Leere Warteschlangen haben den Wert 0 in der MessageCount-Eigenschaft . Gibt alle Warteschlangen auf dem lokalen Server zurück, die Nachrichten enthalten.
Get-Queue -Exclude Empty
External Schließt Warteschlangen ein oder aus, die den Wert External in der NextHopCategory-Eigenschaft aufweisen.

Externe Warteschlangen weisen immer einen der folgenden Werte für DeliveryType auf:

  • DeliveryAgent
  • DnsConnectorDelivery
  • NonSmtpGatewayDelivery
  • SmartHostConnectorDelivery

Weitere Informationen finden Sie unter NextHopSolutionKey.

Gibt alle internen Warteschlangen auf dem lokalen Server zurück.
Get-Queue -Exclude External
Internal Dieser Wert schließt Warteschlangen ein oder aus, die den Wert Internal in der NextHopCategory-Eigenschaft aufweisen. Beachten Sie, dass eine Nachricht für einen externen Empfänger möglicherweise mehrere interne Hops erfordert, bevor sie einen Gatewayserver erreicht, auf dem sie extern übermittelt wird. Gibt alle internen Warteschlangen auf dem lokalen Server zurück.
Get-Queue -Include Internal

Beachten Sie, dass Sie die Funktionalität der Parameter Include und Exclude mit dem Parameter Filter duplizieren können. Die folgenden Befehle führen beispielsweise zu demselben Ergebnis:

  • Get-Queue -Exclude Empty

  • Get-Queue -Filter "MessageCount -gt 0"

Wie Sie jedoch sehen können, ist die Syntax der Parameter Include und Exclude einfacher zu merken.

Get-QueueDigest

Mit dem Cmdlet Get-QueueDigest können Sie Mithilfe eines einzigen Befehls Informationen zu einigen oder allen Warteschlangen in Ihrer Organisation anzeigen. Insbesondere ermöglicht das Cmdlet Get-QueueDigest es Ihnen, Informationen zu Warteschlangen basierend auf ihrem Speicherort auf Servern, in DAGs, an Active Directory-Standorten oder in der Active Directory-Gesamtstruktur als Ganzes anzuzeigen.

Beachten Sie, dass Warteschlangen auf einem abonnierten Edge-Transport-Server nicht in den Ergebnissen enthalten sind. Get-QueueDigest ist auch auf einem Edge-Transport-Server verfügbar, aber die Ergebnisse sind auf lokale Warteschlangen auf dem Edge-Transport-Server beschränkt.

Hinweis

Standardmäßig zeigt das Get-QueueDigest-Cmdlet Zustellungswarteschlangen an, die zehn oder mehr Nachrichten enthalten und deren Ergebnisse zwischen ein und zwei Minuten alt sind. Anweisungen zum Ändern der Standardwerte finden Sie unter Konfigurieren von Get-QueueDigest.

In der folgenden Tabelle werden die Filter- und Sortierparameter beschrieben, die im Cmdlet Get-QueueDigest verfügbar sind.

Parameter Beschreibung
Dag, Server oder Site Diese Parameter schließen sich gegenseitig aus (können nicht im selben Befehl verwendet werden) und legen den Bereich für das Cmdlet fest. Sie müssen einen dieser Parameter oder den Schalter Gesamtstruktur angeben. In der Regel verwenden Sie den Namen des Servers, der DAG oder des Active Directory-Standorts, aber Sie können einen beliebigen Wert verwenden, der den Server, die DAG oder den Standort eindeutig identifiziert. Sie können mehrere Server, DAGs oder Websites angeben, die durch Kommas getrennt sind.
Forest Dieser Schalter ist erforderlich, wenn Sie die Parameter Dag, Server oder Site nicht verwenden. Mit dieser Option wird kein Wert angegeben. Mit diesem Switch erhalten Sie Warteschlangen von allen Exchange-Postfachservern in der lokalen Active Directory-Gesamtstruktur. Sie können diesen Schalter nicht verwenden, um Warteschlangen in Active Directory-Remotegesamtstrukturen anzuzeigen.
DetailsLevel Normal ist der Standardwert. Die folgenden Eigenschaften werden in den Ergebnissen zurückgegeben:
  • QueueIdentity
  • ServerIdentity
  • MessageCount

Verbose gibt die folgenden zusätzlichen Eigenschaften in den Ergebnissen zurück:

  • DeferredMessageCount
  • LockedMessageCount*
  • IncomingRate
  • OutgoingRate
  • Velocity
  • NextHopDomain
  • NextHopCategory
  • NextHopConnector
  • DeliveryType*
  • Status
  • RiskLevel*
  • OutboundIPPool*
  • LastError
  • TlsDomain

None Unterlässt den Warteschlangennamen in der Spalte Details in den Ergebnissen.

* Diese Eigenschaften sind für die interne Verwendung von Microsoft reserviert und werden nicht in lokalen Exchange-Organisationen verwendet. Weitere Informationen zu allen Eigenschaften in dieser Liste finden Sie unter Warteschlangeneigenschaften.

Filter Filtern Sie Warteschlangen basierend auf den Warteschlangeneigenschaften, wie im Abschnitt Filterparameter für Warteschlangen-Cmdlets beschrieben. Sie können jede der filterbaren Warteschlangeneigenschaften verwenden, wie im Thema Warteschlangeneigenschaften beschrieben.
GroupBy Gruppiert die Warteschlangenergebnisse. Sie können die Ergebnisse nach einer der folgenden Eigenschaften gruppieren:
  • DeliveryType
  • LastError
  • NextHopCategory
  • NextHopDomain
  • NextHopKey
  • Status
  • ServerName

Standardmäßig werden die Ergebnisse nach NextHopDomain gruppiert. Informationen zu diesen Warteschlangeneigenschaften finden Sie unter Warteschlangeneigenschaften.

Resultsize Schränkt die Warteschlangenergebnisse auf den von Ihnen angegebenen Wert ein. Die Warteschlangen werden in absteigender Reihenfolge basierend auf der Anzahl der Nachrichten in der Warteschlange sortiert und nach dem wert gruppiert, der durch den GroupBy-Parameter angegeben wird. Der Standardwert ist 1000. Damit zeigt der Befehl standardmäßig die ersten 1000 Warteschlangen an, gruppiert nach NextHopDomain und sortiert nach den Warteschlangen mit den meisten Nachrichten bis hin zu den Warteschlangen mit den wenigsten Nachrichten.
Timeout Der Parameter gibt die Anzahl von Sekunden an, bevor das Zeitüberschreitungsintervall für den Vorgang auftritt. Der Standardwert ist 00:00:10 oder 10 Sekunden.

In diesem Beispiel werden alle nicht leeren externen Warteschlangen auf den Servern Mailbox01, Mailbox02 und Mailbox03 zurückgegeben.

Get-QueueDigest -Server Mailbox01,Mailbox02,Mailbox03 -Include External -Exclude Empty

Parameter zur Nachrichtenfilterung

In der folgenden Tabelle sind die Filterparameter zusammengefasst, die in den Nachrichtenverwaltungs-Cmdlets verfügbar sind.

Cmdlet Filterparameter Kommentare
Get-Message Filter
Identity
Queue
Server
Sie können die Parameter Filter, Identity oder Queue nicht im gleichen Befehl verwenden.
Der Parameter Server gibt den Server an, auf dem Sie den Befehl ausführen möchten. Sie können die Parameter Server und Filter im gleichen Befehl verwenden.
Remove-Message
Resume-Message
Suspend-Message
Filter
Identity
Server
Sie müssen entweder den Identity-Parameter oder den Filter-Parameter verwenden, aber Sie können sie nicht beide im selben Befehl verwenden.
Der Parameter Server gibt den Server an, auf dem Sie den Befehl ausführen möchten. Sie können die Parameter Server und Filter im gleichen Befehl verwenden.
Redirect-Message Server Dieses Cmdlet entfernt aktive Nachrichten aus allen Übermittlungswarteschlangen auf dem angegebenen Server, sodass Server der einzige verfügbare Filterparameter ist. Weitere Informationen finden Sie unter Umleiten von Nachrichten in Warteschlangen.
Export-Message Identity Dieser Parameter ist nicht wirklich ein Filter, da er die Nachricht eindeutig identifiziert. Um mehrere Nachrichten für dieses Cmdlet zu identifizieren, verwenden Sie Get-Message , und leiten Sie die Ergebnisse an Export-Message weiter. Weitere Informationen und Beispiele finden Sie unter Exportieren von Nachrichten aus Warteschlangen.

Nachrichtenidentität

Der Identity-Parameter in den Nachrichtenverwaltungs-Cmdlets identifiziert eine Nachricht in einer oder mehreren Warteschlangen eindeutig, sodass Sie keine anderen Parameter für die Nachrichtenfilterung verwenden können. Der Identity-Parameter verwendet die grundlegende Syntax <Server>\<Queue>\<MessageInteger>.

In der folgenden Tabelle wird die Syntax beschrieben, die Sie mit dem Identity-Parameter für die Nachrichtenverwaltungs-Cmdlets verwenden können.

**Identity-Parameterwert Beschreibung**
<Server>\<Queue>\<MessageInteger> oder <Queue>\<MessageInteger> Eine Nachricht in einer bestimmten Warteschlange auf dem angegebenen oder lokalen Server.

<Queue> ist die Identität der Warteschlange, wie im Abschnitt Warteschlangenidentität beschrieben:

  • Name der beständigen Warteschlange
  • Name einer Zustellungswarteschlange
  • Warteschlangenganzzahl
  • Name einer Shadow-Warteschlange

<MessageInteger> ist der eindeutige ganzzahlige Wert, der der Nachricht zugewiesen wird, wenn sie zum ersten Mal in die Warteschlangendatenbank auf dem Server gelangt. Wen die Nachricht an mehrere Empfänger gesendet wird, für die mehrere Warteschlangen erforderlich sind, besitzen alle Kopien der Nachricht in allen Warteschlangen in der Warteschlangendatenbank denselben Ganzzahlwert. Sie müssen jedoch das Cmdlet Get-Message ausführen, um diesen Wert in den Eigenschaften Identity oder MessageIdentity zu finden.

<Server>\*\<MessageInteger>oder oder *\<MessageInteger><MessageInteger> Alle Kopien der Nachricht in allen Warteschlangen in der Warteschlangendatenbank auf dem angegebenen oder lokalen Server.

Filterparameter für Nachrichten-Cmdlets

Sie können den Filter-Parameter mit den Cmdlets Get-Message, Remove-Message, Resume-Message und Suspend-Message verwenden, um eine oder mehrere Nachrichten basierend auf den Eigenschaften der Nachrichten zu identifizieren. Der Parameter Filter erstellt einen OPath-Filter mit Vergleichsoperatoren, um den Befehl auf Nachrichten zu beschränken, die die Filterkriterien erfüllen. Sie können den logischen Operator -and verwenden, um mehrere Bedingungen für die Übereinstimmung anzugeben. Hier ist ein generisches Beispiel für die Syntax:

Get-Message -Filter "<Property1> -<ComparisonOperator> '<Value1>' -and <Property2> -<ComparisonOperator> '<Value2>'..."

Eine vollständige Liste der Nachrichteneigenschaften, die Sie mit dem Parameter Filter verwenden können, finden Sie unter Nachrichteneigenschaften).

Eine Liste der Vergleichsoperatoren, die Sie mit dem Filter-Parameter verwenden können, finden Sie im Abschnitt Vergleichsoperatoren, die beim Filtern von Warteschlangen oder Nachrichten in diesem Thema verwendet werden sollen.

Beispiele für Prozeduren, die den Filter-Parameter zum Anzeigen und Verwalten von Nachrichten verwenden, finden Sie unter Prozeduren für Nachrichten in Warteschlangen.

Der Queue-Parameter

Der Queue-Parameter ist nur für das Cmdlet Get-Message verfügbar. Sie können diesen Parameter verwenden, um alle Nachrichten in einer bestimmten Warteschlange oder alle Nachrichten aus mehreren Warteschlangen mithilfe des Platzhalterzeichens (*) abzurufen. Wenn Sie den Queue-Parameter verwenden, verwenden Sie das Warteschlangenidentitätsformat <Server>\<Queue> , wie im Abschnitt Warteschlangenidentität in diesem Thema beschrieben.

Beim Filtern von Warteschlangen oder Nachrichten verwendbare Vergleichsoperatoren

Wenn Sie mithilfe des Parameters Filter einen Filterausdruck für Warteschlangen oder Nachrichten erstellen, müssen Sie einen Vergleichsoperator für den abzugleichenden Eigenschaftswert einschließen. Die Vergleichsoperatoren, die Sie verwenden können, und die Funktionsweise der einzelnen Operatoren werden in der folgenden Tabelle beschrieben. Bei allen Operatoren ist die Groß-/Kleinschreibung der verglichenen Werte nicht relevant.

Operator Funktion Codebeispiel
-eq Genaue Übereinstimmung des angegebenen Werts. Alle Warteschlangen anzeigen, die den Status Wiederholen haben:
Get-Queue -Filter "Status -eq 'Retry'"
Alle Meldungen anzeigen, die den Status Wiederholen haben:
Get-Message -Filter "Status -eq 'Retry'"
-ne Stimmt nicht mit dem angegebenen Wert überein. Alle Warteschlangen anzeigen, die nicht den Status Aktiv haben:
Get-Queue -Filter "Status -ne 'Active'"
Alle Meldungen anzeigen, die nicht den Status Aktiv haben:
Get-Message -Filter "Status -ne 'Active'"
-gt Größer als der angegebene Ganzzahl- oder Datums-/Uhrzeitwert. Warteschlangen anzeigen, die derzeit mehr als 1.000 Nachrichten enthalten:
Get-Queue -Filter "MessageCount -gt 1000"
Anzeigen von Nachrichten, die derzeit eine Wiederholungsanzahl von mehr als 3 aufweisen:
Get-Message -Filter "RetryCount -gt 3"
-ge Größer oder gleich dem angegebenen Ganzzahl- oder Datums-/Uhrzeitwert. Warteschlangen anzeigen, die derzeit 1.000 oder mehr Nachrichten enthalten:
Get-Queue -Filter "MessageCount -ge 1000"
Anzeigen von Nachrichten, die derzeit eine Wiederholungsanzahl von 3 oder mehr aufweisen:
Get-Message -Filter "RetryCount -ge 3"
-lt Kleiner als der angegebene Ganzzahl- oder Datums-/Uhrzeitwert. Warteschlangen anzeigen, die derzeit weniger als 1.000 Nachrichten enthalten:
Get-Queue -Filter "MessageCount -lt 1000"
Anzeigen von Nachrichten mit einer SCL, die kleiner als 6 ist:
Get-Message -Filter "SCL -lt 6"
-le Kleiner oder gleich dem angegebenen Ganzzahl- oder Datums-/Uhrzeitwert. Warteschlangen anzeigen, die derzeit 1.000 oder weniger Nachrichten enthalten:
Get-Queue -Filter "MessageCount -le 1000"
Anzeigen von Nachrichten mit einer SCL von 6 oder weniger:
Get-Message -Filter "SCL -le 6"
-like Enthält den angegebenen Text. Sie müssen das Platzhalterzeichen (*) in die Textzeichenfolge einschließen. Warteschlangen anzeigen, die ein Ziel für jede SMTP-Domäne haben, die in Contoso.com endet:
Get-Queue -Filter "Identity -like '*contoso.com'"
Anzeigen von Nachrichten mit einem Betreff, der den Text "Auszahlungskredit" enthält:
Get-Message -Filter "Subject -like '*payday loan*'"

Sie können einen Filter angeben, der mehrere Ausdrücke auswertet, indem Sie den logischen Operator verwenden -and. Die Warteschlangen oder Nachrichten müssen allen Filterbedingungen entsprechen, um in die Ergebnisse aufgenommen zu werden.

Dieses Beispiel zeigt eine Liste der Warteschlangen an, deren Ziel eine beliebige auf "Contoso.com" endende SMTP-Domäne ist und die gegenwärtig mehr als 500 Nachrichten enthalten.

Get-Queue -Filter "Identity -like '*contoso.com*' -and MessageCount -gt 500"

In diesem Beispiel wird eine Liste der Nachrichten angezeigt, die von einer beliebigen E-Mail-Adresse in der contoso.com Domäne gesendet werden, deren SCL-Wert größer als 5 ist.

Get-Message -Filter "FromAddress -like '*Contoso.com*' -and SCL -gt 5"

Erweiterte Pagingparameter

Wenn Sie die Exchange-Verwaltungsshell verwenden, um Warteschlangen und Nachrichten in Warteschlangen anzuzeigen, ruft Ihre Abfrage jeweils eine Seite mit Informationen ab. Die erweiterten Auslagerungsparameter steuern die Größe der Ergebnisse und die Reihenfolge, in der die Ergebnisse angezeigt werden. Alle erweiterten Auslagerungsparameter sind optional und können mit oder ohne andere Filterparameter für die Cmdlets Get-Queue und Get-Message verwendet werden. Wenn Sie keine erweiterten Pagingparameter angeben, gibt die Abfrage die Ergebnisse in aufsteigender Reihenfolge der Identität zurück.

Wenn Sie eine Sortierreihenfolge angeben, wird die Identity-Eigenschaft standardmäßig immer in aufsteigender Reihenfolge eingeschlossen und sortiert, da die anderen verfügbaren Warteschlangen- oder Nachrichteneigenschaften nicht eindeutig sind.

Sie können die Parameter BookmarkIndex und BookmarkObject verwenden, um eine Position in den sortierten Ergebnissen zu markieren. Wenn das Lesezeichenobjekt beim Abrufen der nächsten Ergebnisseite nicht mehr vorhanden ist, beginnen die Ergebnisse mit dem Element, das dem Lesezeichen am nächsten liegt, was von der angegebenen Sortierreihenfolge abhängt.

Die erweiterten Auslagerungsparameter werden in der folgenden Tabelle beschrieben.

Parameter Beschreibung
Bookmarkindex Gibt die Position in den Ergebnissen an, an der die angezeigten Ergebnisse beginnen. Der Wert dieses Parameters ist ein 1-basierter Index in den Gesamtergebnissen. Wenn der Wert kleiner als oder gleich Null ist, wird die erste vollständige Seite mit Ergebnissen zurückgegeben. Wenn der Wert auf Int.MaxValuefestgelegt ist, wird die letzte vollständige Ergebnisseite zurückgegeben.
Sie können diesen Parameter nicht mit dem BookmarkObject-Parameter verwenden.
Bookmarkobject Gibt das -Objekt in den Ergebnissen an, an dem die angezeigten Ergebnisse beginnen. Wenn Sie ein Lesezeichenobjekt angeben, wird dieses Objekt als Ausgangspunkt für die Suche verwendet. Die Zeilen vor oder nach diesem Objekt (abhängig vom Wert des SearchForward-Parameters ) werden abgerufen.
Sie können diesen Parameter nicht mit dem BookmarkIndex-Parameter verwenden.
IncludeBookmark Gibt an, ob das Lesezeichenobjekt in die Ergebnisse eingeschlossen werden soll. Gültige Werte sind:
$true: Das Bookmark-Objekt ist in den Ergebnissen enthalten. Dies ist der Standardwert.
$false: Das Lesezeichenobjekt ist nicht in den Ergebnissen enthalten. Verwenden Sie diesen Wert, wenn Sie eine Abfrage für eine begrenzte Ergebnisgröße ausführen, und geben Sie dann das letzte Element als Lesezeichen für die nächste Abfrage an. Dadurch wird verhindert, dass das Lesezeichenobjekt in beiden Ergebnissen enthalten ist.
Resultsize Gibt die Anzahl der pro Seite anzuzeigenden Ergebnisse an. Wenn Sie keinen Wert angeben, wird die Standardergebnisgröße von 1.000 Objekten verwendet. Exchange beschränkt die Ergebnisse auf 250.000.
ReturnPageInfo Dies ist ein ausgeblendeter Parameter. Er gibt Informationen über die Gesamtanzahl der Ergebnisse und den Index des ersten Objekts der aktuellen Seite zurück. Der Standardwert ist $false.
Searchforward Gibt die Richtung der Suche an.
Angegebenes Lesezeichen: Suchen Sie in den Ergebnissen relativ zum Lesezeichenindex oder -objekt vorwärts oder rückwärts.
Kein Lesezeichen angegeben: Suchen Sie in den Ergebnissen des ersten oder letzten Elements in den Ergebnissen vorwärts oder rückwärts.
Gültige Werte sind:
$true: Suchen Sie vorwärts vom ersten Element in den Ergebnissen oder vom angegebenen Lesezeichen aus. Wenn über das Lesezeichen hinaus keine Ergebnisse vorhanden sind, gibt die Abfrage die letzte vollständige Seite der Ergebnisse zurück. Dies ist der Standardwert.
$false: Suchen Sie rückwärts vom letzten Element in den Ergebnissen oder von der angegebenen Textmarke aus. Wenn über das Lesezeichen hinaus weniger als eine vollständige Ergebnisseite vorhanden ist, gibt die Abfrage die erste vollständige Ergebnisseite zurück.
SortOrder Gibt die Nachrichteneigenschaften an, die die Sortierreihenfolge der Ergebnisse steuern. Die Reihenfolge, in der die Eigenschaften angegeben werden, gibt eine absteigende Reihenfolge der Rangfolge an (die Ergebnisse werden nach der ersten Eigenschaft sortiert, dann werden diese Ergebnisse nach der zweiten Eigenschaft und son on sortiert).
Dieser Parameter verwendet die Syntax, <+|-><Property1>,<+|-><Property2>...wobei + die Eigenschaft in aufsteigender Reihenfolge sortiert und - die Eigenschaft in absteigender Reihenfolge sortiert wird.
Wenn Sie diesen Parameter nicht verwenden, werden die Ergebnisse nach der Identity-Eigenschaft in aufsteigender Reihenfolge sortiert.

In diesem Beispiel wird gezeigt, wie die erweiterten Pagingparameter in einer Abfrage verwendet werden. Der Befehl gibt die ersten 500 Nachrichten auf dem angegebenen Server zurück. Die Ergebnisse werden zuerst in aufsteigender Reihenfolge nach Absenderadresse und dann in absteigender Reihenfolge nach Nachrichtengröße sortiert.

Get-Message -Server mailbox01.contoso.com -ResultSize 500 -SortOrder +FromAddress,-Size

In diesem Beispiel werden die ersten 500 Nachrichten auf dem angegebenen Server in der angegebenen Sortierreihenfolge zurückgegeben, ein Lesezeichenobjekt festgelegt, das Bookmark-Objekt aus den Ergebnissen ausgeschlossen und die nächsten 500 Nachrichten in derselben Sortierreihenfolge abgerufen.

  1. Führen Sie den folgenden Befehl aus, um die erste Ergebnisseite abzurufen.

    $Results=Get-Message -Server mailbox01.contoso.com -ResultSize 500 -SortOrder +FromAddress,-Size
    
  2. Führen Sie zum Festlegen des Lesezeichenobjekts den folgenden Befehl aus, um das letzte Element der ersten Seite in einer Variablen zu speichern.

    $Temp=$Results[$results.length-1]
    
  3. Führen Sie den folgenden Befehl aus, um die nächsten 500 Objekte auf dem angegebenen Server abzurufen und das Lesezeichenobjekt auszuschließen.

    Get-Message -Server mailbox01.contoso.com -BookmarkObject:$Temp -IncludeBookmark $false -ResultSize 500 -SortOrder +FromAddress,-Size