通过

Get-Queue (RTM)

  • 项目

 

适用于： Exchange Server 2007 SP1, Exchange Server 2007

上一次修改主题： 2007-08-06

使用 Get-Queue cmdlet 可以在安装了集线器传输服务器角色或边缘传输服务器角色的计算机上查看队列的配置信息。

语法

Get-Queue [-BookmarkIndex <Int32>] [-BookmarkObject <QueueInfo>] [-Filter <String>] [-IncludeBookmark <$true | $false>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-Server <ServerIdParameter>] [-SortOrder <SortOrderEntry[]>]

Get-Queue [-Identity <QueueIdentity>] [-BookmarkIndex <Int32>] [-BookmarkObject <QueueInfo>] [-IncludeBookmark <$true | $false>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-SortOrder <SortOrderEntry[]>]

详细说明

Get-Queue cmdlet 显示集线器传输服务器或边缘传输服务器上有关现有队列的信息。如果未提供任何参数，则该命令将查询本地服务器上的所有队列并返回单页结果。默认页面大小为 1,000 个对象。通过在 Identity 参数中包含服务器名，或在筛选器查询中使用 Server 参数，可以显示远程服务器上的队列。Identity 参数和 Filter 参数的设置是互斥的。

若要运行 Get-Queue cmdlet，必须为您使用的帐户委派下列角色：

  • Exchange 服务器管理员角色 (Exchange Server Administrators role)

若要在安装了边缘传输服务器角色的计算机上运行 Get-Queue cmdlet，必须使用属于该计算机上的本地 Administrators 组成员的帐户登录。

有关管理 Microsoft Exchange Server 2007 所需的权限、角色委派以及权利的详细信息，请参阅权限注意事项。

参数

参数 必需 类型 说明

BookmarkIndex

可选

System.Int32

使用 BookmarkIndex 参数指定所显示的结果在结果集中的起始位置。此参数的值是结果集总数中从 1 开始的索引。BookmarkIndex 不能与 BookmarkObject 参数一起使用。

BookmarkObject

可选

Microsoft.Exchange.Data.QueueViewer.QueueInfo

使用 BookmarkObject 参数指定所显示的结果在结果集中的起始对象。BookmarkObject 不能与 BookmarkIndex 参数一起使用。

Filter

可选

System.String

Filter 参数需要一个表达式来为要显示的队列指定属性值条件。表达式中包含属性名后接比较运算符和值。下列队列属性是 Filter 参数的有效条件：

  • DeliveryType   传输定义的此队列的传递类型。传递类型必须是下列值之一：

    • DNSConnectorDelivery

    • NonSMTPGatewayDelivery

    • SmartHostConnectorDelivery

    • SmtpRelayWithinAdSitetoEdge

    • MapiDelivery

    • SmtpRelayWithinAdSite

    • SmtpRelaytoRemoteAdSite

    • SmtpRelaytoTiRg

    • Undefined

    • Unreachable

  • Identity   以服务器\目标格式输入队列标识，其中的目标是远程域、邮箱服务器或永久队列名。

  • LastError 为队列记录的上一个错误的文本字符串。

  • LastRetryTime 此队列上次尝试连接的时间。

  • MessageCount 队列中的邮件数。

  • NextHopConnector 用于创建队列的连接器的 GUID。

  • NextHopDomain   队列的下一个跃点域，指定为远程简单邮件传输协议 (SMTP) 域、服务器名称、Active Directory 站点名称或邮件数据库 (MDB) 标识符。

  • NextRetryTime   此队列下次尝试连接的时间。

  • Status   队列的状态。队列状态选项为“活动”、“就绪”、“重试”或“已挂起”。

可以使用 -and 比较运算符指定多个条件。未以整数表示的属性值必须加上引号。

Identity

可选

Microsoft.Exchange.Data.QueueViewer.QueueIdentity

使用 Identity 参数指定包含要显示的邮件的队列的标识。以服务器\目标格式输入队列标识，其中的目标是远程域、邮箱服务器或永久队列名。

IncludeBookmark

可选

System.Boolean

使用 IncludeBookmark 参数指定在显示查询结果时是否包含书签对象。IncludeBookmark 参数与 BookmarkObject 或 BookmarkIndex 参数一起使用时有效。如果未指定 IncludeBookmark 参数的值，则使用默认值 $true。

ResultSize

可选

Microsoft.Exchange.Data.Unlimited

使用 ResultSize 参数指定在结果集中显示的总项数。ResultSize 参数的默认值设置为 1,000。ResultSize 不限制结果数，但是 Microsoft Exchange 将结果集限制为 250,000。

ReturnPageInfo

可选

System.Boolean

ReturnPageInfo 参数是隐藏参数。使用该参数返回当前页面的总结果数以及第一个对象的索引的有关信息。默认值为 $false。

SearchForward

可选

System.Boolean

使用 SearchForward 参数指定在结果集中向前搜索还是向后搜索。默认值为 $true。此值使结果页从结果集开头向前计算或从指定的书签向前计算。

Server

可选

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

使用 Server 参数指定要使用远程过程调用 (RPC) 连接到的服务器名称，该远程过程调用包含容纳要显示的邮件的队列。输入服务器名作为主机名或完全限定的域名 (FQDN)。 如果不使用 Server 参数，则将查询本地服务器。

SortOrder

可选

Microsoft.Exchange.Configuration.Tasks.SortOrderEntry[]

使用 SortOrder 参数指定用于控制结果集排序顺序的邮件属性数组。每个属性使用逗号分隔。如果在属性名开头添加一个 + 符号，则按升序显示结果。如果在属性名开头添加一个 - 符号，则按降序显示结果。如果不指定排序顺序，则按 QueueIdentity 的升序显示结果集。

输入类型

返回类型

错误

错误 说明

 

 

示例

以下示例显示三个 Get-Queue 命令。第一个命令显示如何为运行命令的集线器传输服务器或边缘传输服务器上的所有队列显示配置信息。该命令通过管道传输给 Format-List 命令，以便将结果格式化为详细列表。

第二个命令显示如何只为包含的邮件数超过 100 封的队列显示配置信息。

第三个命令显示如何为远程服务器上的队列显示配置信息。

有关管道传输的详细信息，请参阅管道传输。

有关如何处理命令输出的详细信息，请参阅使用命令输出。

有关如何使用 Exchange 命令行管理程序执行队列查看器任务的详细信息，请参阅使用 Exchange 命令行管理程序管理队列。

Get-Queue | format-list
Get-Queue -Filter {MessageCount -gt 100}
Get-Queue -Identity Server1\contoso.com