Verwenden der Exchange-Verwaltungsshell zum Verwalten von Warteschlangen

  • Artikel

Gilt für: Exchange Server 2013

Wie in früheren Versionen von Exchange können Sie mithilfe der Exchange-Verwaltungsshell in Microsoft Exchange Server 2013 Informationen zu Warteschlangen und zu den darin enthaltenen Nachrichten anzeigen und Verwaltungsaktionen für Warteschlangen und Nachrichten durchführen. In Exchange 2013 sind Warteschlangen auf Postfachservern und Edge-Transport-Servern vorhanden. In diesem Thema werden diese Server als Transportserver bezeichnet.

Wenn Sie die Shell zum Anzeigen und Verwalten von Warteschlangen und Nachrichten in Warteschlangen auf Transportservern verwenden, müssen Sie wissen, wie die zu verwaltenden Warteschlangen oder Nachrichten identifiziert werden können. Normalerweise enthalten Transportserver eine große Anzahl von Warteschlangen und Nachrichten für die Zustellung. Sie verwenden die in den Cmdlets für die Warteschlangen- und Nachrichtenverwaltung verfügbaren Filterparameter für die Identifikation von Warteschlangen und Nachrichten, die Sie anzeigen oder 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 Cmdlets für die Warteschlangen- und Nachrichtenanzeige unterstützen jedoch mehr filterbare Eigenschaften und Filteroptionen als die Warteschlangenanzeige. Weitere Informationen zur Verwendung der Warteschlangenanzeige finden Sie unter Warteschlangenanzeige.

Parameter zur Warteschlangenfilterung

In der folgenden Tabelle werden die Filterparameter beschrieben, die in den Cmdlets zur Warteschlangenverwaltung verfügbar sind.

Cmdlet Filterparameter Kommentare
Get-Queue Identity

Filter

Include

Exclude		 Sie können den Parameter Identity nicht im gleichen Befehl mit den Filterparametern verwenden. Sie können die Parameter Include und Exclude mit dem Parameter Filter im selben Befehl verwenden.
Resume-Queue

Retry-Queue

Suspend-Queue		 Identity

Filter		 Sie müssen entweder den Parameter Identity oder den Filter-Parameter verwenden, aber Sie können nicht beide in demselben Befehl verwenden.
Get-QueueDigest Server

Dag

Site

Forest

Filter		 Sie müssen den Server-, Dag-, Standort- oder Gesamtstrukturparameter verwenden, aber sie können nicht zusammen in demselben Befehl verwendet werden. Sie können den Filter-Parameter mit jedem der anderen Filterparameter verwenden.

Beachten Sie, dass ein Serverparameter für alle Warteschlangenverwaltungs-Cmdlets verfügbar ist. Im Cmdlet Get-QueueDigest ist der Server-Parameter ein Bereichsparameter, der den Server angibt, auf dem Bzw. auf denen Sie Zusammenfassungsinformationen zu Warteschlangen anzeigen möchten. In allen anderen Warteschlangenverwaltungs-Cmdlets verwenden Sie den Parameter Server , um eine Verbindung mit einem bestimmten Server herzustellen und die Warteschlangenverwaltungsbefehle auf diesem Server auszuführen. Sie können den Server-Parameter mit oder ohne den Parameter Filter verwenden, aber Sie können den Server-Parameter nicht mit dem Identity-Parameter verwenden. Sie verwenden den Hostnamen oder FQDN des Transportservers mit dem Server-Parameter .

Warteschlangenidentität

Der Parameter Identity in den Cmdlets für die Warteschlangenverwaltung bezeichnet eine bestimmte Warteschlange. Wenn Sie den Identity-Parameter verwenden, können Sie keine anderen Warteschlangenfilterparameter angeben, da Sie die Warteschlange bereits eindeutig identifiziert haben. Der Parameter Identity verwendet die grundlegende Syntax <Serverwarteschlange>\<>.

Der <Platzhalter Server> ist der Hostname oder FQDN des Exchange-Servers, z. B mailbox01 . oder mailbox01.contoso.com. Wenn Sie den <Serverqualifizierer> weglassen, wird der lokale Server impliziert.

Der <Platzhalter Warteschlange> akzeptiert einen der folgenden Werte:

  • Name der beständigen Warteschlange: Persistente Warteschlangen haben eindeutige, konsistente Namen auf allen Postfach- oder Edge-Transport-Servern. Die Namen beständiger Warteschlangen lauten:

    • Übermittlung: Diese Warteschlange enthält Nachrichten, die darauf warten, vom Kategorisierer verarbeitet zu werden.
    • Nicht erreichbar: Diese Warteschlange enthält Nachrichten, die nicht weitergeleitet werden können. Diese Warteschlange ist nur dann vorhanden, wenn sich Nachrichten darin befinden.
    • Nicht verarbeitbar: Diese Warteschlange enthält Nachrichten, die als schädlich für den Exchange-Server eingestuft werden. Diese Warteschlange ist nur dann vorhanden, wenn sich Nachrichten darin befinden.

  • Name der Übermittlungswarteschlange: Der Name einer Zustellungswarteschlange ist der Wert der NextHopDomain-Eigenschaft der Warteschlange. Beispielsweise kann der Warteschlangenname dem Adressraum eines Sendeconnectors, dem Namen eines Active Directory-Standorts oder dem Namen einer DAG entsprechen. Weitere Informationen finden Sie im Abschnitt "NextHopSolutionKey" im Thema Warteschlangen.

  • Warteschlangen-Ganzzahl: Übermittlungswarteschlangen und Schattenwarteschlangen wird in der Warteschlangendatenbank ein eindeutiger ganzzahliger Wert zugewiesen. Allerdings müssen Sie das Cmdlet Get-Queue ausführen, um den Ganzzahlwert für die Warteschlange in der Eigenschaft Identity oder QueueIdentity zu finden.

  • Name der Schattenwarteschlange: Eine Schattenwarteschlange verwendet die Syntax Shadow\<QueueInteger>.

In der folgenden Tabelle ist die Syntax zusammengefasst, die Sie mit dem Identity-Parameter für die Warteschlangenverwaltungs-Cmdlets verwenden können. In allen Werten <ist Server> der Hostname oder FQDN des Servers.

Formate der Warteschlangenidentität

Wert des Identity-Parameters Beschreibung
<Server>\<PersistentQueueName> oder <PersistentQueueName> Eine beständige Warteschlange auf dem angegebenen oder dem lokalen Server.

<PersistentQueueName> ist Submission, Unreachableoder Poison.
<Server>\<NextHopDomain> oder <NextHopDomain> Eine Zustellungswarteschlange auf dem angegebenen oder dem lokalen Server.

<NextHopDomain> ist ein Routingziel oder eine Zustellungsgruppe für die Nachrichten in der Warteschlange. Weitere Informationen finden Sie im Abschnitt "NextHopSolutionKey" im Thema Warteschlangen.
<Server>\<QueueInteger> oder <QueueInteger> Eine Zustellungswarteschlange auf dem angegebenen oder dem lokalen Server.

<QueueInteger> ist der eindeutige Ganzzahlwert der Warteschlange, der in der Eigenschaft Identity des Cmdlets Get-Queue angezeigt wird.
<Server>\Shadow\<QueueInteger> oder Shadow\<QueueInteger> Eine Shadow-Warteschlange auf dem angegebenen oder dem lokalen Server.
<Server>\* oder * Alle Warteschlange auf dem angegebenen oder dem lokalen Server. Beachten Sie, dass diese Werte nur mit dem Cmdlet Get-Queue verwendet werden können.

Parameter zur Warteschlangenfilterung

Den Parameter Filter können Sie für alle Cmdlets zur Warteschlangenverwaltung verwenden, um die anzuzeigenden oder zu verwaltenden Warteschlangen basierend auf ihren Eigenschaften anzugeben. Der Parameter Filter erstellt einen Ausdruck mit Vergleichsoperatoren, der den Warteschlangenvorgang auf Warteschlangen beschränkt, die die Filterkriterien erfüllen. Sie können den -and logischen Operator verwenden, um mehrere Bedingungen anzugeben, die die Ergebnisse erfüllen müssen.

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

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 Parameter Filter zum Anzeigen und Verwalten von Warteschlangen verwenden, finden Sie unter Verwalten von Warteschlangen.

Einschließen und Ausschließen von Parametern

Exchange 2013 verfügt über die Parameter Include und Exclude im Get-Queue Cmdlet. Sie können diese Parameter einzeln, zusammen und mit dem Parameter Filter verwenden, um Die Warteschlangenergebnisse auf dem lokalen oder angegebenen Transportserver zu optimieren. Sie haben beispielsweise folgende Möglichkeiten:

  • Ausschließen leerer Warteschlangen aus den Ergebnissen.
  • Ausschließen von Warteschlangen für externe Ziele aus den Ergebnissen.
  • Einbeziehen von Warteschlangen, die in den Ergebnissen einen bestimmten Wert für DeliveryType aufweisen.

Die Parameter Include und Exclude verwenden die folgenden Warteschlangeneigenschaften, um Warteschlangen zu filtern:

Wert Beschreibung Beispiel für Shellcode
DeliveryType Dieser Wert schließt Warteschlangen basierend auf der Eigenschaft DeliveryType ein oder aus. Es können mehrere Werte durch Kommata getrennt angegeben werden. Die gültigen Werte für DeliveryType werden im Abschnitt "NextHopSolutionKey" des Themas Queues erläutert. In diesem Beispiel werden alle Zustellungswarteschlangen auf dem lokalen Server zurückgegeben, bei deren nächsten Hop es sich um einen Sendeconnector auf dem lokalen Server handelt, der für das Smarthostrouting konfiguriert ist:

Get-Queue -Include SmartHostConnectorDelivery
Empty Dieser Wert schließt leere Warteschlangen ein oder aus. Leere Warteschlangen haben den Wert 0 in der MessageCount-Eigenschaft . Dieses Beispiel gibt alle Warteschlangen auf dem lokalen Server zurück, die Nachrichten enthalten.

Get-Queue -Exclude Empty
External Dieser Wert 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 im Abschnitt "NextHopSolutionKey" im Thema Warteschlangen.

 In diesem Beispiel werden alle internen Warteschlangen auf dem lokalen Server zurückgegeben

Get-Queue -Exclude External
Internal Dieser Wert schließt Warteschlangen ein oder aus, die den Wert Internal in der NextHopCategory-Eigenschaft aufweisen. Weitere Informationen finden Sie im Abschnitt "NextHopSolutionKey" im Thema Warteschlangen. In diesem Beispiel werden alle internen Warteschlangen auf dem lokalen Server zurückgegeben.

Get-Queue -Include Internal

Beachten Sie, dass Sie die Funktionalität der Parameter Include und Exclude mit dem Parameter Filter duplizieren können. Der Befehl Get-Queue -Exclude Empty liefert z. B. dasselbe Ergebnis wie Get-Queue -Filter "MessageCount -gt 0". Die Syntax der Parameter Include und Exclude ist jedoch einfacher und leichter zu merken.

Get-QueueDigest

Exchange 2013 fügt ein neues Warteschlangen-Cmdlet namens Get-QueueDigest hinzu. Mit diesem Cmdlet können Sie Informationen zu manchen oder allen Warteschlangen in Ihrer Exchange-Organisation mit nur einem einzigen Befehl 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 im Umkreisnetzwerk nicht in den Ergebnissen enthalten sind. Zudem ist Get-QueueDigest zwar auf einem Edge-Transport-Server verfügbar, aber die Ergebnisse sind auf die 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 mit dem Cmdlet Get-QueueDigest verwendet werden können.

Parameter Beschreibung
Dag, Server oder Site Diese Parameter schließen sich gegenseitig aus 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. Bei Verwendung dieser Option erhalten Sie Warteschlangen von allen Exchange 2013-Postfachservern in der Active Directory-Gesamtstruktur. Sie können den Switch Gesamtstruktur nicht verwenden, um Warteschlangen in Active Directory-Remotegesamtstrukturen anzuzeigen.
DetailsLevel Dieser Parameter akzeptiert die Werte None, Normalund Verbose. Der Standardwert ist Normal. Wenn Sie den Wert Noneverwenden, wird der Warteschlangenname in der Spalte Details in den Ergebnissen weggelassen.
Filter Mit diesem Parameter können Sie Warteschlangen basierend auf den Eigenschaften der Warteschlange filtern. Wie im Thema Warteschlangenfilter beschrieben, können Sie beliebige der filterbaren Warteschlangeneigenschaften verwenden.
GroupBy Dieser Parameter 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 NextHopDomaingruppiert. Informationen zu diesen Warteschlangeneigenschaften finden Sie unter Warteschlangenfilter.
Resultsize Dieser Parameter begrenzt die Warteschlangenergebnisse auf den von Ihnen angegebenen Wert. 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 Exchange 2013-Postfachservern namens "Mailbox01", "Mailbox02" und "Mailbox03" zurückgegeben.

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

Parameter zur Nachrichtenfilterung

In der folgenden Tabelle werden die Filterparameter beschrieben, die in den Cmdlets zur Nachrichtenverwaltung verfügbar sind.

Cmdlet Filterparameter Kommentare
Get-Message Identity

Filter

Queue		 Alle Filterparameter schließen sich gegenseitig aus, und Sie können sie zusammen in demselben Befehl verwenden.
Remove-Message

Resume-Message

Suspend-Message		 Identity

Filter		 Sie müssen entweder den Parameter Identity oder den Filter-Parameter verwenden, aber Sie können nicht beide in demselben Befehl verwenden.
Export-Message Identity Der Identity-Parameter ist erforderlich.

Beachten Sie, dass ein Serverparameter für alle Nachrichtenverwaltungs-Cmdlets mit Ausnahme des Export-Message-Cmdlets verfügbar ist. Sie verwenden den Server-Parameter , um eine Verbindung mit einem bestimmten Server herzustellen, und führen die Nachrichtenverwaltungsbefehle auf diesem Server aus. Sie können den Server-Parameter mit oder ohne den Parameter Filter verwenden, aber Sie können den Server-Parameter nicht mit dem Identity-Parameter verwenden. Sie verwenden den Hostnamen oder FQDN des Transportservers mit dem Server-Parameter .

Nachrichtenidentität

Der Parameter Identity in den Cmdlets zur Nachrichtenverwaltung identifiziert eine bestimmte Nachricht in einer oder mehreren Warteschlangen. Wenn Sie den Identity-Parameter verwenden, können Sie keine anderen Parameter für die Nachrichtenfilterung angeben, da Sie die Nachricht bereits eindeutig identifiziert haben. Der Parameter Identity verwendet die grundlegende Syntax <Server>\<Queue>\<MessageInteger>.

Der <Platzhalter Server> ist der Hostname oder FQDN des Exchange-Servers, z. B mailbox01 . oder mailbox01.contoso.com. Wenn Sie den <Serverqualifizierer> weglassen, wird der lokale Server impliziert.

Der <Platzhalter Queue> akzeptiert die Identität der Warteschlange, wie im Abschnitt "Warteschlangenidentität" in diesem Thema beschrieben. Beispielsweise können Sie den Namen der beständigen Warteschlange, den Wert NextHopDomain oder den eindeutigen Ganzzahlwert der Warteschlange in der Warteschlangendatenbank verwenden.

Der <Platzhalter MessageInteger> stellt den eindeutigen ganzzahligen Wert dar, 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. Allerdings müssen Sie das Cmdlet Get-Message ausführen, um den Ganzzahlwert für die Nachricht in der Eigenschaft Identity oder MessageIdentity zu finden.

In der folgenden Tabelle wird die Syntax zusammengefasst, die Sie mit dem Identity-Parameter für die Nachrichtenverwaltungs-Cmdlets verwenden können. In allen Werten <ist Server> der Hostname oder FQDN des Servers.

Formate der Nachrichtenidentität

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

<MessageInteger> ist der eindeutige Ganzzahlwert der Nachricht, der in der Eigenschaft Identity des Cmdlets Get-Message angezeigt wird.

<Warteschlange> stellt einen der folgenden Werte dar:
  • Name der beständigen Warteschlange: Der Wert Submission, Unreachableoder Poison.
  • Name der Übermittlungswarteschlange: Der Wert der NextHopDomain-Eigenschaft der Warteschlange, der effektiv der Name der Warteschlange ist. Dieser Wert kann ein Routingziel oder eine Verteilergruppe sein. Weitere Informationen finden Sie im Abschnitt "NextHopSolutionKey" im Thema Warteschlangen.
  • Warteschlangen-Ganzzahl: Der eindeutige ganzzahlige Wert der Übermittlungswarteschlange oder Schattenwarteschlange, der in der Identity-Eigenschaft der Cmdlets Get-Message oder Get-Queue angezeigt wird.
  • Schattenwarteschlangenidentität: Die Schattenwarteschlangenidentität verwendet die Syntax Shadow\<QueueInteger>.
<Server>\*\<MessageInteger>oder oder *\<MessageInteger><MessageInteger> Alle Kopien der Nachricht in allen Warteschlangen in der Warteschlangendatenbank auf dem angegebenen oder dem lokalen Server.

Parameter zur Nachrichtenfilterung

Mit dem Parameter Filter in den Cmdlets Get-Message, Remove-Message, Resume-Message und Suspend-Message können Sie die anzuzeigenden oder zu verwaltenden Nachrichten basierend auf den Nachrichteneigenschaften angeben. Der Parameter Filter erstellt einen Ausdruck mit Vergleichsoperatoren, der den Nachrichtenvorgang auf Nachrichten beschränkt, die die Filterkriterien erfüllen. Sie können den -and logischen Operator verwenden, um mehrere Bedingungen anzugeben, die die Ergebnisse erfüllen müssen.

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

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 Parameter Filter zum Anzeigen und Verwalten von Nachrichten verwenden, finden Sie unter Verwalten von Warteschlangen.

Der Queue-Parameter

Der Queue-Parameter wird nur mit dem Cmdlet Get-Message verwendet. 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 <Serverwarteschlange>\<>, 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 folgende Tabelle zeigt die Vergleichsoperatoren, die in Filterausdrücken verwendet werden können, sowie die Funktionsweise der einzelnen Operatoren. Bei allen Operatoren ist die Groß-/Kleinschreibung der verglichenen Werte nicht relevant.

Vergleichsoperatoren

Operator Funktion Beispiel für Shellcode
-eq Dieser Operator wird verwendet, um anzugeben, dass die Ergebnisse genau mit dem im Ausdruck übergebenen Eigenschaftenwert übereinstimmen müssen. To display a list of all queues that have a status of Retry:

Get-Queue -Filter "Status -eq 'Retry'"

To display a list of all messages that have a status of Retry:

Get-Message -Filter "Status -eq 'Retry'"
-ne Dieser Operator wird verwendet, um anzugeben, dass die Ergebnisse nicht mit dem im Ausdruck übergebenen Eigenschaftenwert übereinstimmen müssen. To display a list of all queues that don't have a status of Active:

Get-Queue -Filter "Status -ne 'Active'"

To display a list of all messages that don't have a status of Active:

Get-Message -Filter "Status -ne 'Active'"
-gt Dieser Operator wird für Eigenschaften verwendet, deren Wert als ganze Zahl oder als Datum/Zeit ausgedrückt wird. Die Filterergebnisse enthalten nur Warteschlangen oder Nachrichten, bei denen der Wert der angegebenen Eigenschaft größer als der im Ausdruck angegebene Wert ist. So zeigen Sie eine Liste aller Warteschlangen mit mehr als 1000 Nachrichten an

Get-Queue -Filter "MessageCount -gt 1000"

So zeigen Sie eine Liste aller Nachrichten an, die aktuell einen Wiederholungszähler von mehr als 3 aufweisen

Get-Message -Filter "RetryCount -gt 3"
-ge Dieser Operator wird für Eigenschaften verwendet, deren Wert als ganze Zahl oder als Datum/Zeit ausgedrückt wird. Die Filterergebnisse enthalten nur Warteschlangen oder Nachrichten, bei denen der Wert der angegebenen Eigenschaft größer als oder gleich dem im Ausdruck angegebenen Wert ist. So zeigen Sie eine Liste aller Warteschlangen mit mindestens 1000 Nachrichten an

Get-Queue -Filter "MessageCount -ge 1000"

So zeigen Sie eine Liste der Nachrichten an, die derzeit einen Wiederholungszähler von 3 oder mehr aufweisen

Get-Message -Filter "RetryCount -ge 3"
-lt Dieser Operator wird für Eigenschaften verwendet, deren Wert als ganze Zahl oder als Datum/Zeit ausgedrückt wird. Die Filterergebnisse enthalten nur Warteschlangen oder Nachrichten, bei denen der Wert der angegebenen Eigenschaft kleiner als der im Ausdruck angegebene Wert ist. So zeigen Sie eine Liste aller Warteschlangen mit weniger als 1000 Nachrichten an

Get-Queue -Filter "MessageCount -lt 1000"

So zeigen Sie eine Liste der Nachrichten an, die einen SCL kleiner als 6 aufweisen

Get-Message -Filter "SCL -lt 6"
-le Dieser Operator wird für Eigenschaften verwendet, deren Wert als ganze Zahl oder als Datum/Zeit ausgedrückt wird. Die Filterergebnisse enthalten nur Warteschlangen oder Nachrichten, bei denen der Wert der angegebenen Eigenschaft kleiner als oder gleich dem im Ausdruck angegebenen Wert ist. So zeigen Sie eine Liste aller Warteschlangen mit höchstens 1000 Nachrichten an

Get-Queue -Filter "MessageCount -le 1000"

So zeigen Sie eine Liste der Nachrichten an, die einen SCL von 6 oder weniger aufweisen

Get-Message -Filter "SCL -le 6"
-like This operator is used with properties where the value is expressed as a text string. The filter results only include queues or messages where the value of the specified property contains the text string that's supplied in the expression. Sie können das Platzhalterzeichen (*) in einen -ähnlichen Ausdruck einschließen, der auf ein Zeichenfolgenfeld angewendet wird, aber nicht mit einem Feld, das den Enumerationstyp aufweist. So zeigen Sie eine Liste mit Zustellungswarteschlangen an, deren Ziel eine beliebige SMTP-Domäne ist, die auf "Contoso.com" endet

Get-Queue -Filter "Identity -like '*contoso.com'"

So zeigen Sie eine Liste der Nachrichten mit einem Betreff an, der den Text "Kredit am Zahltag" enthält

Get-Messages -Filter "Subject -like '*payday loan*'"

Mithilfe des Vergleichsoperators -and können Sie einen Filter angeben, der mehrere Ausdrücke auswertet. Die Warteschlangen oder Nachrichten müssen alle Bedingungen des Filters erfüllen, 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"

Dieses Beispiel zeigt eine Liste von Nachrichten an, die von einer beliebigen E-Mail-Adresse in der Domäne "contoso.com" gesendet werden und deren SCL-Wert größer ist als 5.

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

Erweiterte Pagingparameter

Abhängig von der aktuellen Nachrichtenübermittlung können Abfragen auf Warteschlangen und Nachrichten eine große Menge von Objekten zurückgeben. Mithilfe der erweiterten Pagingparameter lässt sich steuern, wie Ergebnismengen abgerufen und angezeigt werden.

Wenn die Shell zum Anzeigen von Warteschlangen und Nachrichten in den Warteschlangen verwendet wird, rufen die Abfragen jeweils eine Seite Informationen ab. Die erweiterten Pagingparameter steuern die Größe der Ergebnismenge und können außerdem zum Sortieren der Ergebnisse verwendet werden. Alle erweiterten Pagingparameter sind optional und können mit allen Parametersätzen kombiniert werden, die mit den Cmdlets Get-Queue und Get-Message verwendet werden können. Wenn Sie keine erweiterten Pagingparameter angeben, gibt die Abfrage die Ergebnisse in aufsteigender Reihenfolge der Identität zurück.

Standardmäßig ist beim Angeben einer Sortierreihenfolge die Nachrichtenidentitätseigenschaft immer eingeschlossen und wird in aufsteigender Reihenfolge sortiert. Dies ist die Standardsortierbeziehung. Die Nachrichtenidentitätseigenschaft wird eingeschlossen, weil die anderen Eigenschaften, die in eine Sortierreihenfolge eingeschlossen werden können, nicht eindeutig sind. Indem Sie die Nachrichtenidentitätseigenschaft explizit in die Sortierreihenfolge einschließen, können Sie angeben, dass die Nachrichtenidentität in den Ergebnissen in absteigender Reihenfolge sortiert anzeigt wird.

Sie können die Parameter BookmarkIndex und BookmarkObject verwenden, um eine Position im sortierten Resultset zu markieren. Wenn das Lesezeichenobjekt beim Abrufen der nächsten Seite mit Ergebnissen nicht mehr vorhanden ist, stellt die standardmäßige Sortierbeziehung sicher, dass die Ergebnismenge mit dem Objekt beginnt, das dem Lesezeichen zunächst liegt. Das nächst gelegene Objekt hängt von der angegebenen Sortierreihenfolge ab.

Die folgende Tabelle beschreibt die erweiterten Pagingparameter.

Parameter Beschreibung
Bookmarkindex Dieser 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. 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.
Bookmarkobject Dieser Parameter gibt das Objekt im Resultset an, bei 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 werden abhängig vom Wert des SearchForward-Parameters abgerufen. Sie können den BookmarkObject-Parameter und den BookmarkIndex-Parameter nicht in einer einzigen Abfrage kombinieren.
IncludeBookmark Dieser Parameter gibt an, ob das Lesezeichenobjekt in das Resultset eingeschlossen werden soll. Standardmäßig ist der Wert auf $true festgelegt, und das Lesezeichenobjekt ist enthalten. Sie können eine Abfrage ausführen, um eine eingeschränkte Ergebnisgröße zurückzugeben, und das letzte Element in der Ergebnismenge als Lesezeichen für die nächste Abfrage verwenden. In diesem Fall sollten Sie IncludeBookmark auf $false festlegen, damit das Objekt nicht in beiden Resultsets enthalten ist.
Resultsize Dieser Parameter 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 das Resultset auf 250.000.
ReturnPageInfo Dieser Parameter 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 Dieser Parameter gibt an, ob im Resultset vorwärts oder rückwärts gesucht werden soll. Dieser Parameter wirkt sich nicht auf die Reihenfolge aus, in der die Ergebnismenge zurückgegeben wird. Er bestimmt die Suchrichtung relativ zum Lesezeichenindex oder -objekt. Wenn kein Lesezeichenindex oder -objekt angegeben ist, bestimmt der SearchForward-Parameter , ob die Suche mit dem ersten oder letzten Objekt im Resultset beginnt.

Der Standardwert für diesen Parameter ist $true. Wenn der this-Parameter auf $true festgelegt ist und ein Lesezeichen angegeben ist, sucht die Abfrage von diesem Lesezeichen aus vorwärts. Wenn Sie diese Konfiguration verwenden und sich hinter dem Lesezeichen keine Ergebnisse befinden, gibt die Abfrage die letzte volle Seite mit Ergebnissen zurück.

Wenn der SearchForward-Parameter auf $false festgelegt ist und ein Lesezeichen angegeben ist, sucht die Abfrage von diesem Lesezeichen aus rückwärts. Wenn Sie diese Konfiguration verwenden und sich weniger als eine volle Seite mit Ergebnissen jenseits des Lesezeichens befindet, gibt die Abfrage die erste volle Seite mit Ergebnissen zurück.
SortOrder Dieser Parameter gibt ein Array mit Nachrichteneigenschaften an, die zum Steuern der Sortierreihenfolge des Resultsets verwendet werden. Die Eigenschaften für die Sortierreihenfolge werden absteigend nach ihrem Vorrang angegeben. Jede Eigenschaft wird durch ein Komma getrennt, und ihr wird ein Pluszeichen (+) angefügt, um in aufsteigender Reihenfolge zu sortieren, oder ein Minuszeichen (-), um in absteigender Reihenfolge zu sortieren.

Wenn durch die Verwendung dieses Parameters keine explizite Sortierreihenfolge angegeben wird, werden die der Abfrage entsprechenden Datensätze angezeigt und nach dem Identitätsfeld für den entsprechenden Objekttyp sortiert. Wenn keine Sortierreihenfolge explizit angegeben ist, werden die Ergebnisse immer nach der Identität in aufsteigender Reihenfolge sortiert.

Das folgende Codebeispiel zeigt die Verwendung der erweiterten Pagingparameter in einer Abfrage. In diesem Beispiel stellt der Befehl eine Verbindung mit dem angegebenen Server her und ruft eine Ergebnismenge ab, die 500 Objekte enthält. Die Ergebnisse werden sortiert angezeigt, zuerst in aufsteigender Reihenfolge nach der Absenderadresse und dann in absteigender Reihenfolge nach der Nachrichtengröße.

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

Wenn Sie aufeinander folgende Seiten anzeigen möchten, können Sie ein Lesezeichen für das letzte in einer Ergebnismenge abgerufene Objekt festlegen und eine weitere Abfrage ausführen. Zum Ausführen dieses Vorgangs müssen Sie die Skriptfähigkeit der Shell verwenden.

Im folgenden Beispiel wird ein Skript verwendet, um die erste Ergebnisseite abzurufen, das Lesezeichenobjekt festzulegen, das Lesezeichenobjekt aus der Ergebnismenge auszuschließen und anschließend die nächsten 500 Objekte auf dem angegebenen Server abzurufen.

  1. Öffnen Sie die Shell, und geben Sie den folgenden Befehl ein, um die erste Ergebnisseite abzurufen.

    $Results=Get-message -Server mailbox01.contoso.com -ResultSize 500 -SortOrder +FromAddress,-Size

  2. Geben Sie zum Festlegen des Lesezeichenobjekts den folgenden Befehl ein, um das letzte Element der ersten Seite in einer Variablen zu speichern.

    $temp=$results[$results.length-1]

  3. Geben Sie den folgenden Befehl ein, 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