Get-Queue

Artikel
09/29/2014

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-Queue können Sie Konfigurationsinformationen zu Warteschlangen auf einem Computer anzeigen, auf dem die Serverfunktion Hub-Transport oder Edge-Transport installiert ist.

Syntax

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

Get-Queue [-Identity <QueueIdentity>] [-BookmarkIndex <Int32>] [-BookmarkObject <QueueInfo>] [-IncludeBookmark <$true | $false>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-SortOrder <SortOrderEntry[]>]

Detaillierte Beschreibung

Das Cmdlet Get-Queue dient dem Anzeigen von Informationen zu vorhandenen Warteschlangen auf einem Hub-Transport- oder Edge-Transport-Server. Wenn Sie keine Parameter angeben, fragt der Befehl alle 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 Warteschlangen auf einem Remoteserver anzeigen, indem Sie den Servernamen im Parameter Identity angeben oder den Parameter Server einer Filterabfrage hinzufügen. Die Parametersätze Identity und Filter schließen sich gegenseitig aus.

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

Exchange-Serveradministratoren (Rolle)

Um das Cmdlet Get-Queue 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.QueueInfo	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 Warteschlangen angegeben werden. Der Ausdruck schließt einen Eigenschaftennamen, gefolgt von einem Vergleichsoperator und einem Wert, ein. Die folgenden Warteschlangeneigenschaften stellen gültige Kriterien für den Filter-Parameter dar: DeliveryType Der Übermittlungstyp für die betreffende Warteschlange, wie er durch den Transport definiert ist. Der Übermittlungstyp muss einen der folgenden Werte aufweisen: DNSConnectorDelivery NonSMTPGatewayDelivery SmartHostConnectorDelivery SmtpRelayWithinAdSitetoEdge MapiDelivery SmtpRelayWithinAdSite SmtpRelaytoRemoteAdSite SmtpRelaytoTiRg Nicht definiert Nicht erreichbar Identity Geben Sie die Warteschlangen-ID in der Form Server\Ziel ein, wobei Ziel für eine Remotedomäne, einen Postfachserver oder den Namen einer beständigen Warteschlange steht. LastError Eine Textzeichenfolge mit dem letzten für eine Warteschlange aufgezeichneten Fehler. LastRetryTime Der Zeitpunkt des letzten Verbindungsversuchs für die betreffende Warteschlange. MessageCount Die Anzahl der Zeilen in der Warteschlange. NextHopConnector Die GUID des Connectors, der zum Erstellen der Warteschlange verwendet wurde. NextHopDomain Die nächste Hopdomäne der Warteschlange, die als SMTP-Domäne (Simple Mail Transfer Protocol), als Servername, als Name eines Active Directory-Standorts oder als Nachrichtendatenbank-ID (MDB) angegeben ist. NextRetryTime Der Zeitpunkt, zu dem der nächste Verbindungsversuch für die betreffende Warteschlange ausgeführt wird. Status Der Status der Warteschlange. Die Optionen für den Warteschlangenstatus sind Aktiv, Bereit, Wiederholen und Angehalten. Mithilfe des Vergleichsoperators -and können mehrere Kriterien angegeben werden. Eigenschaftenwerte, die nicht als ganze Zahl ausgedrückt sind, müssen in Anführungszeichen eingeschlossen werden.
Identity	Optional	Microsoft.Exchange.Data.QueueViewer.QueueIdentity	Mit dem Parameter Identity 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.
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.
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 Servernamen als Hostnamen oder als 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äß QueueIdentity angezeigt.

Eingabetypen

Rückgabetypen

Fehler

Fehler	Beschreibung

Beispiel

In den folgenden Beispielen werden drei Get-Queue-Befehle gezeigt. Der erste Befehl zeigt, wie die Konfigurationsinformationen zu allen Warteschlangen auf dem Hub-Transport- oder Edge-Transport-Server angezeigt werden, auf dem der Befehl ausgeführt wird. Der Befehl kann über eine Pipe an den Befehl Format-List übergeben werden, damit die Ergebnisse als detaillierte Liste formatiert werden.

Der zweite Befehl zeigt, wie nur die Konfigurationsinformationen zu Warteschlangen angezeigt werden, die mehr als 100 Nachrichten enthalten.

Der dritte Befehl zeigt, wie die Konfigurationsinformationen zu einer Warteschlange angezeigt werden, die auf einem Remoteserver vorhanden ist.

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-Queue | format-list
Get-Queue -Filter {MessageCount -gt 100}
Get-Queue -Identity Server1\contoso.com