通过

Suspend-Queue

  • 项目

 

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

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

使用 Suspend-Queue cmdlet 可以在安装了集线器传输服务器角色或边缘传输服务器角色的计算机上停止队列的出站活动。

语法

Suspend-Queue -Identity <QueueIdentity> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

Suspend-Queue -Filter <String> [-Confirm [<SwitchParameter>]] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

详细说明

Suspend-Queue cmdlet 可停止状态为“活动”或“重试”的队列中的出站活动。通过 SMTP 发送进行传递的邮件将完成操作。队列中不会保留其他邮件。如果指定了一个 Identity 参数，那么在标识仅与一个队列相匹配时，队列将挂起。如果标识与多个队列相匹配，则系统会向您发送错误消息。若要通过一个操作挂起多个队列，必须使用筛选器。

必须使用 Identity 参数或 Filter 参数。Identity 和 Filter 参数集相互排斥。可以通过将服务器名作为 Identity 参数的一部分包括在内，或者将 Server 参数用于筛选查询来挂起远程服务器上的队列。如果不指定服务器，则仅对本地服务器运行此命令。

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

  • Exchange Server 管理员角色和目标服务器的本地 Administrators 组

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

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

参数

参数 必需 类型 说明

Filter

必需

System.String

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

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

    • DNSConnectorDelivery

    • NonSMTPGatewayDelivery

    • SmartHostConnectorDelivery

    • SmtpRelayWithinAdSitetoEdge

    • MapiDelivery

    • SmtpRelayWithinAdSite

    • SmtpRelaytoRemoteAdSite

    • SmtpRelaytoTiRg

    • Undefined

    • Unreachable

  • Identity 输入形式为 Server\destination 的队列标识，其中 destination 为远程域、邮箱服务器或永久队列名。

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

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

  • MessageCount   队列中的邮件数。

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

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

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

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

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

Identity

必需

Microsoft.Exchange.Data.QueueViewer.QueueIdentity

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

Confirm

可选

System.Management.Automation.SwitchParameter

Confirm 参数将导致命令暂停处理，并且需要您在处理继续之前确认该命令将执行的操作。不必为 Confirm 参数指定值。

Server

可选

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

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

WhatIf

可选

System.Management.Automation.SwitchParameter

WhatIf 参数指示命令模拟对对象执行的操作。通过使用 WhatIf 参数，您可以查看要发生的更改，而不必应用任何这些更改。不必为 WhatIf 参数指定值。

输入类型

返回类型

错误

错误 说明

 

 

异常

异常 说明

 

 

示例

以下示例显示两个 Suspend-Queue 命令。第一个命令挂起所有队列的传出活动。这些队列包含要传递给指定域的邮件，并且队列的当前状态为“重试”。

第二个命令使用 RPC 绑定到远程服务器并且挂起包含 100 封以上邮件的所有队列。

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

Suspend-Queue -Filter {NextHopDomain -eq "contoso.com" -and Status -eq "retry"}
Suspend-Queue -Server ExchSrv1.contoso.com -Filter {MessageCount -gt 100}