Get-QueueDigest

  • Referenz
Modul:
ExchangePowerShell
Gilt für::
Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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 -Forest

In diesem Beispiel werden Informationen zu allen Warteschlangen in der Active Directory-Gesamtstruktur zurückgegeben.

Beispiel 2

Get-QueueDigest -Dag DAG01

In 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.