Get-QueueDigest

参考

模块:: ExchangePowerShell

适用于:: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

此 cmdlet 仅适用于本地 Exchange。

使用 Get-QueueDigest cmdlet 可查看有关组织中数据库可用性组 (DAG) Active Directory 站点或 Active Directory 林的消息传递队列的信息。

默认情况下， Get-QueueDigest cmdlet 显示包含 10 封或更多邮件的传递队列，而且结果每一到两分钟更新一次。有关如何更改这些默认值的说明，请参阅配置 Get-QueueDigest。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

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

说明

您必须先获得权限，然后才能运行此 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

Dag 参数按 DAG 筛选传递队列结果。可以指定唯一标识 DAG 的任何值。可以指定用逗号分隔的多个值。如果值中有空格，请使用双引号 (") 将此值括起来。

不能将 Dag 参数与服务器、站点或林参数一起使用。

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

DetailsLevel 参数指定要在结果中显示的详细级别。此参数的有效值为 None、Normal 和 Verbose。默认值为 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

Filter 参数使用 OPATH 筛选器语法指定一个或多个队列。 OPATH 筛选器包括队列属性名称，后跟比较运算符和值 (例如 "NextHopDomain -eq 'contoso.com'") 。有关可筛选队列属性和比较运算符的详细信息，请参阅 Exchange Server 中的队列属性和在 Exchange 命令行管理程序中查找队列和消息。

可以使用和比较运算符指定多个条件。不以整数表示的属性值必须用引号 (“) 括起来。

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

林开关按 Active Directory 林筛选传递队列结果。无需使用林开关指定值。

不能将林开关与服务器、站点或 Dag 参数一起使用。

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

GroupedBy 参数对传递队列结果中的消息进行排序。有效值包含:

DeliveryType
LastError
NextHopCategory
NextHopDomain (这是默认值)
NextHopKey
RiskLevel
状态
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

ResultSize 参数按队列中的消息数筛选传递队列结果。此参数的有效输入为整数。默认值为 1000。例如，如果指定值 50，则命令将显示包含最多消息的 50 个队列。

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

Server 参数按 Exchange 服务器筛选传递队列结果。可以指定唯一标识服务器的任何值。可以指定用逗号分隔的多个值。如果值中有空格，请使用双引号 (") 将此值括起来。

不能将 Server 参数与 Dag、站点或林参数一起使用。

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

Site 参数按 Active Directory 站点筛选传递队列结果。可以指定唯一标识站点的任何值。可以指定以逗号分隔的多个站点。

不能将 Site 参数与服务器、Dag 或林参数一起使用。

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

Timeout 参数指定操作超时之前的秒数。默认值为 10 秒。

若要指定值，请将其输入为时间跨度：dd.hh：mm：ss，其中 dd = 天，hh = 小时，mm = 分钟，ss = 秒。

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

输入

Input types

若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。