Commands › Exchange Online
Get-QueueDigest
View information about message delivery queues across database availability groups (DAGs) Active Directory sites, or Active Directory forests in your organization. By default, the Get-QueueDigest cmdlet displays delivery queues that contain ten or more messages, and the results are between one and two minutes old. For instructions on how to change these default values, see Configure Get-QueueDigest.
Quick start script
# Get-QueueDigest — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-ExchangeOnline -CertificateThumbprint $thumb -AppId $appId -Organization $org
# 2. Run and inspect
Get-QueueDigest -Dag <MultiValuedProperty> -Forest <SwitchParameter> -Server <MultiValuedProperty> | Format-List
# 3. Export for evidence / drift tracking
Get-QueueDigest | Export-Clixml .\QueueDigest-$(Get-Date -Format yyyyMMdd).xmlSyntax — 4 parameter sets
Dag
Get-QueueDigest -Dag <MultiValuedProperty>
[-DetailsLevel <DetailsLevel>]
[-Filter <String>]
[-GroupBy <QueueDigestGroupBy>]
[-ResultSize <Unlimited>]
[-Timeout <EnhancedTimeSpan>]
[<CommonParameters>]Forest
Get-QueueDigest [-Forest]
[-DetailsLevel <DetailsLevel>]
[-Filter <String>]
[-GroupBy <QueueDigestGroupBy>]
[-ResultSize <Unlimited>]
[-Timeout <EnhancedTimeSpan>]
[<CommonParameters>]Server
Get-QueueDigest -Server <MultiValuedProperty>
[-DetailsLevel <DetailsLevel>]
[-Filter <String>]
[-GroupBy <QueueDigestGroupBy>]
[-ResultSize <Unlimited>]
[-Timeout <EnhancedTimeSpan>]
[<CommonParameters>]Site
Get-QueueDigest -Site <MultiValuedProperty>
[-DetailsLevel <DetailsLevel>]
[-Filter <String>]
[-GroupBy <QueueDigestGroupBy>]
[-ResultSize <Unlimited>]
[-Timeout <EnhancedTimeSpan>]
[<CommonParameters>]Parameters (9)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -Dag | MultiValuedProperty | yes | The Dag parameter filters the delivery queue results by DAG. You can specify any value that uniquely identifies the DAG. You can specify multiple values separated by commas. If the value contains spaces, enclose the... |
| -Forest | SwitchParameter | yes | The Forest switch filters the delivery queue results by Active Directory forest. You don't need to specify a value with the Forest switch. |
| -Server | MultiValuedProperty | yes | The Server parameter filters the delivery queue results by Exchange server. You can specify any value that uniquely identifies the server. You can specify multiple values separated by commas. If the value contains... |
| -Site | MultiValuedProperty | yes | The Site parameter filters the delivery queue results by Active Directory site. You can specify any value that uniquely identifies the site. You can specify multiple sites separated by commas. |
| -DetailsLevel | DetailsLevel | The DetailsLevel parameter specifies the level of detail to display in the results. Valid values for this parameter are None, Normal and Verbose. The default value is Normal. | |
| -Filter | String | The Filter parameter specifies one or more queues by using OPATH filter syntax. The OPATH filter includes a queue property name followed by a comparison operator and value (for example, `"NextHopDomain -eq... | |
| -GroupBy | QueueDigestGroupBy | The GroupedBy parameter sorts the messages in the delivery queue results. Valid values are: | |
| -ResultSize | Unlimited | The ResultSize parameter filters the delivery queue results by the number of messages in the queue. Valid input for this parameter is an integer. The default value is 1000. For example, if you specify the value 50,... | |
| -Timeout | EnhancedTimeSpan | The Timeout parameter specifies the number of seconds before the operation times out. The default value is 10 seconds. |
Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.