Get-QueueDigest
Dieses Cmdlet ist nur lokal in Exchange verfügbar.
Verwenden Sie das Cmdlet Get-QueueDigest, um Informationen zu Nachrichtenübermittlungswarteschlangen in Active Directory-Standorten (Database Availability Groups, DAGs) oder Active Directory-Gesamtstrukturen in Ihrer Organisation anzuzeigen.
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.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Get-QueueDigest
-Dag <MultiValuedProperty>
[-DetailsLevel <DetailsLevel>]
[-Filter <String>]
[-GroupBy <QueueDigestGroupBy>]
[-ResultSize <Unlimited>]
[-Timeout <EnhancedTimeSpan>]
[<CommonParameters>] Get-QueueDigest
[-Forest]
[-DetailsLevel <DetailsLevel>]
[-Filter <String>]
[-GroupBy <QueueDigestGroupBy>]
[-ResultSize <Unlimited>]
[-Timeout <EnhancedTimeSpan>]
[<CommonParameters>] Get-QueueDigest
-Server <MultiValuedProperty>
[-DetailsLevel <DetailsLevel>]
[-Filter <String>]
[-GroupBy <QueueDigestGroupBy>]
[-ResultSize <Unlimited>]
[-Timeout <EnhancedTimeSpan>]
[<CommonParameters>] Get-QueueDigest
-Site <MultiValuedProperty>
[-DetailsLevel <DetailsLevel>]
[-Filter <String>]
[-GroupBy <QueueDigestGroupBy>]
[-ResultSize <Unlimited>]
[-Timeout <EnhancedTimeSpan>]
[<CommonParameters>] Beschreibung
Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den 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-QueueDigest -ForestIn diesem Beispiel werden Informationen zu allen Warteschlangen in der Active Directory-Gesamtstruktur zurückgegeben.
Beispiel 2
Get-QueueDigest -Dag DAG01In diesem Beispiel werden Informationen über alle Warteschlangen in der DAG namens "DAG01" zurückgegeben.
Parameter
-Dag
Der Parameter Dag filtert die Zustellwarteschlangenergebnisse nach DAG. Sie können einen beliebigen Wert angeben, der die DAG eindeutig identifiziert. Mehrere Werte können durch Kommata getrennt angegeben werden. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").
Sie können den Parameter Dag nicht mit dem Parameter Server, Site oder Forest verwenden.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DetailsLevel
Der Parameter DetailsLevel gibt den Detaillierungsgrad für die Ergebnisanzeige an. Gültige Werte für diesen Parameter sind None, Normal und Verbose. Der Standardwert ist "Normal".
| Type: | DetailsLevel |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Filter
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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Forest
Der Switch "Gesamtstruktur" filtert die Ergebnisse der Übermittlungswarteschlange nach Active Directory-Gesamtstruktur. Für die Option Forest muss kein Wert angegeben werden.
Sie können die Option Forest nicht mit dem Parameter Server, Site oder Dag verwenden.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-GroupBy
Der Parameter GroupedBy sortiert die Nachrichten in den Zustellwarteschlangenergebnissen. Gültige Werte sind:
- DeliveryType
- LastError
- NextHopCategory
- NextHopDomain (dies ist der Standardwert)
- NextHopKey
- RiskLevel
- Status
- ServerName
- OutboundIPPool
| Type: | QueueDigestGroupBy |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ResultSize
Der Parameter ResultSize filtert die Zustellwarteschlangenergebnisse nach der Anzahl von Nachrichten in der Warteschlange. Eine gültige Eingabe für diesen Parameter ist eine Ganzzahl. Der Standardwert ist 1000. Wenn Sie beispielsweise den Wert 50 angeben, zeigt der Befehl die 50 Warteschlangen mit den meisten Nachrichten an.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Server
Der Parameter Server filtert die Ergebnisse der Übermittlungswarteschlange nach Exchange Server. Sie können einen beliebigen Wert angeben, der den Server eindeutig identifiziert. Mehrere Werte können durch Kommata getrennt angegeben werden. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").
Sie können den Parameter Server nicht mit dem Parameter Dag, Site oder Forest verwenden.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Site
Der Parameter Site filtert die Ergebnisse der Übermittlungswarteschlange nach Active Directory-Standort. Sie können einen beliebigen Wert angeben, der den Standort eindeutig identifiziert. Mehrere Standorte können durch Kommata getrennt angegeben werden.
Sie können den Parameter Site nicht mit dem Parameter Server, Dag oder Forest verwenden.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Timeout
Der Parameter Timeout gibt die Anzahl von Sekunden für die Zeitüberschreitung des Vorgangs an. Die Standardeinstellung ist 10 Sekunden.
Um einen Wert anzugeben, geben Sie ihn als Zeitspanne ein: dd.hh:mm:ss, wobei dd = Tage, hh = Stunden, mm = Minuten und ss = Sekunden.
| Type: | EnhancedTimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
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, die dieses Cmdlet akzeptiert, finden Sie unter Cmdlet Input and Output Types. Wenn das Feld Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.