Get-QueueDigest
此 cmdlet 仅适用于本地 Exchange。
使用 Get-QueueDigest cmdlet 查看有关组织中数据库可用性组 (DAG) Active Directory 站点或 Active Directory 林的消息传递队列的信息。
默认情况下， Get-QueueDigest cmdlet 显示包含 10 封或更多邮件的传递队列，而且结果每一到两分钟更新一次。 有关如何更改这些默认值的说明，请参阅 配置 Get-QueueDigest。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
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>]
说明
您必须先获得权限，然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数，但如果某些参数未包含在分配给你的权限中，则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Get-QueueDigest -Forest
此示例返回有关 Active Directory 林中所有队列的信息。
示例 2
Get-QueueDigest -Dag DAG01
此示例返回有关 DAG01 的 DAG 中的所有队列的信息。
参数
-Dag
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Dag 参数按 DAG 筛选传递队列结果。 可以指定唯一标识 DAG 的任何值。 可以指定用逗号分隔的多个值。 如果值中有空格，请使用双引号 (") 将此值括起来。
不能将 Dag 参数与服务器、站点或林参数一起使用。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Dag
| Position: | Named |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-DetailsLevel
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
DetailsLevel 参数指定要在结果中显示的详细级别。 此参数的有效值为 None、Normal 和 Verbose。 默认值为 Normal。
参数属性
| 类型: | DetailsLevel |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Filter
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Filter 参数使用 OPATH 筛选器语法指定一个或多个队列。 OPATH 筛选器包括队列属性名称，后跟比较运算符和值 (例如 "NextHopDomain -eq 'contoso.com'") 。 有关可筛选队列属性和比较运算符的详细信息，请参阅 Exchange Server 中的队列属性和在 Exchange 命令行管理程序中查找队列和消息。
可以使用 和 比较运算符指定多个条件。 不以整数表示的属性值必须用引号 (“) 括起来。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Forest
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
林开关按 Active Directory 林筛选传递队列结果。 无需使用林开关指定值。
不能将林开关与服务器、站点或 Dag 参数一起使用。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Forest
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-GroupBy
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
GroupedBy 参数对传递队列结果中的消息进行排序。 有效值包含:
- DeliveryType
- LastError
- NextHopCategory
- NextHopDomain (这是默认值)
- NextHopKey
- RiskLevel
- 状态
- ServerName
- OutboundIPPool
参数属性
| 类型: | QueueDigestGroupBy |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ResultSize
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
ResultSize 参数按队列中的消息数筛选传递队列结果。 此参数的有效输入为整数。 默认值为 1000。 例如，如果指定值 50，则命令将显示包含最多消息的 50 个队列。
参数属性
| 类型: | Unlimited |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Server
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Server 参数按 Exchange 服务器筛选传递队列结果。 可以指定唯一标识服务器的任何值。 可以指定用逗号分隔的多个值。 如果值中有空格，请使用双引号 (") 将此值括起来。
不能将 Server 参数与 Dag、站点或林参数一起使用。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Server
| Position: | Named |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Site
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Site 参数按 Active Directory 站点筛选传递队列结果。 可以指定唯一标识站点的任何值。 可以指定以逗号分隔的多个站点。
不能将 Site 参数与服务器、Dag 或林参数一起使用。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Site
| Position: | Named |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Timeout
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Timeout 参数指定作超时之前的秒数。默认值为 10 秒。
若要指定值，请将其输入为时间跨度：dd.hh：mm：ss，其中 dd = 天，hh = 小时，mm = 分钟，ss = 秒。
参数属性
| 类型: | EnhancedTimeSpan |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
输入
Input types
若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。