Get-Queue
Dieses Cmdlet ist nur lokal in Exchange verfügbar.
Verwenden Sie das Cmdlet Get-Queue, um Konfigurationsinformationen für 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
Identity
Get-Queue
[[-Identity] <QueueIdentity>]
[-BookmarkIndex <Int32>]
[-BookmarkObject <ExtensibleQueueInfo>]
[-Exclude <QueueViewerIncludesAndExcludes>]
[-Include <QueueViewerIncludesAndExcludes>]
[-IncludeBookmark <Boolean>]
[-ResultSize <Unlimited>]
[-ReturnPageInfo <Boolean>]
[-SearchForward <Boolean>]
[-SortOrder <QueueViewerSortOrderEntry[]>]
[<CommonParameters>]
Server
Get-Queue
[-Server <ServerIdParameter>]
[-Filter <String>]
[-BookmarkIndex <Int32>]
[-BookmarkObject <ExtensibleQueueInfo>]
[-Exclude <QueueViewerIncludesAndExcludes>]
[-Include <QueueViewerIncludesAndExcludes>]
[-IncludeBookmark <Boolean>]
[-ResultSize <Unlimited>]
[-ReturnPageInfo <Boolean>]
[-SearchForward <Boolean>]
[-SortOrder <QueueViewerSortOrderEntry[]>]
[<CommonParameters>]
Beschreibung
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-Queue | Format-List
In diesem Beispiel werden detaillierte Informationen zu allen Warteschlangen auf dem Postfachserver angezeigt, auf dem der Befehl ausgeführt wird.
Beispiel 2
Get-Queue -Filter "MessageCount -gt 100"
In diesem Beispiel werden Warteschlangen mit mehr als 100 Nachrichten angezeigt.
Beispiel 3
Get-Queue Server1\contoso.com | Format-List
In diesem Beispiel werden detaillierte Informationen für eine bestimmte Warteschlange auf dem Postfachserver namens "Server1" angezeigt.
Beispiel 4
Get-Queue -Exclude Internal
In diesem Beispiel werden nur die externen Warteschlangen aufgeführt.
Parameter
-BookmarkIndex
Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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
Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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: | ExtensibleQueueInfo |
| 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 |
-Exclude
Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Der Parameter Exclude gibt die Typen von Warteschlangen an, die aus den Ergebnissen ausgeschlossen werden sollen. Der Parameter PasswordQuality gibt die Mindestbewertung für die Qualität von Kennwörtern an, die für Gerätekennwörter erforderlich ist. Kennwortqualität ist eine numerische Skala, die die Sicherheit und die Komplexität des Kennworts angibt. Ein höherer Qualitätswert signalisiert ein sichereres Kennwort.
- Intern
- Extern
- Ein gültiger DeliveryType-Wert einer Warteschlange. Weitere Informationen finden Sie im Abschnitt NextHopSolutionKey unter Warteschlangen und Nachrichten in Warteschlangen.
Parametereigenschaften
| Typ: | QueueViewerIncludesAndExcludes |
| 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
Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Der Parameter Filter gibt eine oder mehrere Warteschlangen mithilfe der OPATH-Filtersyntax an. Der OPATH-Filter enthält einen Warteschlangeneigenschaftsnamen, gefolgt von einem Vergleichsoperator und -wert (z. B "NextHopDomain -eq 'contoso.com'". ). Ausführliche Informationen zu filterbaren Warteschlangeneigenschaften und Vergleichsoperatoren finden Sie unter Warteschlangeneigenschaften in Exchange Server 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
Server
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Identity
Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Der Parameter Identity gibt die Warteschlange an. Gültige Eingaben für diesen Parameter verwenden die Syntax Server\Queue oder Queue, z. B. Mailbox01\contoso.comoder Unreachable. Ausführliche Informationen zur Warteschlangenidentität finden Sie unter Warteschlangenidentität.
Parametereigenschaften
| Typ: | QueueIdentity |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Identity
| Position: | 1 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Include
Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Der Parameter Include gibt die Typen von Warteschlangen an, die in die Ergebnisse einbezogen werden sollen. Der Parameter PasswordQuality gibt die Mindestbewertung für die Qualität von Kennwörtern an, die für Gerätekennwörter erforderlich ist. Kennwortqualität ist eine numerische Skala, die die Sicherheit und die Komplexität des Kennworts angibt. Ein höherer Qualitätswert signalisiert ein sichereres Kennwort.
- Intern
- Extern
- Ein gültiger DeliveryType-Wert einer Warteschlange. Weitere Informationen finden Sie im Abschnitt NextHopSolutionKey unter Warteschlangen und Nachrichten in Warteschlangen.
Parametereigenschaften
| Typ: | QueueViewerIncludesAndExcludes |
| 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 |
-IncludeBookmark
Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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 |
-ResultSize
Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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
Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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
Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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
Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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
Server
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-SortOrder
Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
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.