Get-Queue

 

Gilt für:Exchange Server 2013

Dieses Cmdlet ist nur lokal in Exchange Server 2013 verfügbar.

Verwenden Sie das Cmdlet Get-Queue, um Konfigurationsinformationen für Warteschlangen auf Postfachservern oder Edge-Transport-Servern anzuzeigen.

Get-Queue [-Filter <String>] [-Server <ServerIdParameter>] <COMMON PARAMETERS>
Get-Queue [-Identity <QueueIdentity>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-BookmarkIndex <Int32>] [-BookmarkObject <ExtensibleQueueInfo>] [-Exclude <QueueViewerIncludesAndExcludes>] [-Include <QueueViewerIncludesAndExcludes>] [-IncludeBookmark <$true | $false>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-SortOrder <QueueViewerSortOrderEntry[]>]

In diesem Beispiel werden detaillierte Informationen zu allen Warteschlangen auf dem Postfachserver angezeigt, auf dem der Befehl ausgeführt wird.

Get-Queue | Format-List

In diesem Beispiel werden Warteschlangen mit mehr als 100 Nachrichten angezeigt.

Get-Queue -Filter {MessageCount -gt 100}

In diesem Beispiel werden detaillierte Informationen für eine bestimmte Warteschlange auf dem Postfachserver namens "Server1" angezeigt.

Get-Queue Server1\contoso.com | Format-List

In diesem Beispiel werden nur die externen Warteschlangen aufgeführt.

Get-Queue -Exclude Internal

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. In diesem Thema sind zwar alle Parameter für das Cmdlet aufgeführt, aber Sie verfügen möglicherweise nicht über Zugriff auf einige Parameter, falls diese nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Informationen zu den von Ihnen benötigten Berechtigungen finden Sie unter "Warteschlangen" im Thema Berechtigungen für den Nachrichtenfluss.

 

Parameter Erforderlich Typ Beschreibung

BookmarkIndex

Optional

System.Int32

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.

BookmarkObject

Optional

Microsoft.Exchange.Data.QueueViewer.ExtensibleQueueInfo

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.

Exclude

Optional

Microsoft.Exchange.Data.QueueViewerIncludesAndExcludes

Der Parameter Exclude gibt die Typen von Warteschlangen an, die aus den Ergebnissen ausgeschlossen werden sollen. Gültige Werte für diesen Parameter sind:

  • Intern

  • External

  • Ein gültiger DeliveryType-Wert einer Warteschlange. Weitere Informationen finden Sie im Abschnitt "NextHopSolutionKey" in Warteschlangen.

Filter

Optional

System.String

Mit dem Parameter Filter werden mit der OPath-Filtersyntax eine oder mehrere Warteschlangen angegeben. Der OPath-Filter beinhaltet einen Eigenschaftennamen für eine Warteschlange gefolgt von einem Vergleichsoperator und -wert, wie zum Beispiel {NextHopDomain -eq "contoso.com"}. Einzelheiten zu filterbaren Warteschlangeneigenschaften und Vergleichsoperatoren finden Sie unter Warteschlangenfilter und Verwenden der Exchange-Verwaltungsshell zum Verwalten von Warteschlangen.

Mithilfe des Vergleichsoperators and können mehrere Kriterien angegeben werden. Eigenschaftenwerte, die nicht als ganze Zahl ausgedrückt werden, müssen in Anführungszeichen (") eingeschlossen werden.

Identity

Optional

Microsoft.Exchange.Data.QueueViewer.QueueIdentity

Der Identity-Parameter gibt die Warteschlange an. Gültige Eingaben für diesen Parameter verwenden die Syntax Server\Queue oder Queue, z. B. Mailbox01\contoso.com oder Unreachable. Nähere Informationen zu Warteschlangenidentität finden Sie im Abschnitt „Warteschlangenidentität“ in Verwenden der Exchange-Verwaltungsshell zum Verwalten von Warteschlangen.

Include

Optional

Microsoft.Exchange.Data.QueueViewerIncludesAndExcludes

Der Parameter Include gibt die Typen von Warteschlangen an, die in die Ergebnisse einbezogen werden sollen. Gültige Werte für diesen Parameter sind:

  • Intern

  • External

  • Ein gültiger DeliveryType-Wert einer Warteschlange. Weitere Informationen finden Sie im Abschnitt "NextHopSolutionKey" in Warteschlangen.

IncludeBookmark

Optional

System.Boolean

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.

ResultSize

Optional

Microsoft.Exchange.Data.Unlimited

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

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

Der SearchForward-Parameter gibt an, ob im Resultset vorwärts oder rückwärts gesucht 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

Der Parameter Server gibt den Exchange-Server an, auf dem dieser Befehl ausgeführt werden soll. Sie können einen beliebigen Wert verwenden, der den Server eindeutig identifiziert. Beispiel:

  • Name

  • FQDN

  • Distinguished Name (DN)

  • Exchange-Legacy-DN

Wenn Sie den Parameter Server nicht verwenden, wird der Befehl auf dem lokalen Server ausgeführt.

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.

SortOrder

Optional

Microsoft.Exchange.Data.QueueViewerSortOrderEntry[]

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äß QueueIdentity angezeigt.

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.

Rückgabetypen bzw. Ausgabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets . Wenn das Feld mit dem Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.

 
Anzeigen: