Retry-Queue

 

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

上一次修改主题: 2008-03-11

使用 Retry-Queue cmdlet 可以强制安装了集线器传输服务器角色或边缘传输服务器角色的计算机上的队列尝试连接。

语法

Retry-Queue -Identity <QueueIdentity> [-Confirm [<SwitchParameter>]] [-Resubmit <$true | $false>] [-WhatIf [<SwitchParameter>]]

Retry-Queue -Filter <String> [-Confirm [<SwitchParameter>]] [-Resubmit <$true | $false>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

详细说明

Retry-Queue cmdlet 强制状态为“重试”的队列尝试连接。如果可能,该命令将与下一个跃点建立连接。如果已计划连接,则此命令会将队列的下一次重试时间重置为当前时间,并尝试连接。如果未建立连接,则会设置新的重试时间。可以使用 Resubmit 参数将队列内容重新提交给分类程序。可以使用此命令重新尝试传递处于“无法到达”队列中的邮件,但是必须包含 Resubmit 参数。

如果将 Resubmit 参数设置为 $false,则 Retry-Queue cmdlet 将强制尝试建立新连接。如果将 Resubmit 参数设置为 $false,则队列中的邮件将重新提交到分类程序。

note注意:
仅当远程队列的状态是“重试”时,才能将 Resubmit 参数设置为 $true

必须使用 Identity 参数或 Filter 参数。Identity 参数和 Filter 参数的设置是互斥的。通过在 Identity 参数中包含服务器名称,或在筛选器查询中使用 Server 参数,可以重试远程服务器上的队列。如果不指定服务器,则仅对本地服务器运行此命令。

若要运行 Retry-Queue cmdlet,必须为您使用的帐户委派下列角色:

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

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

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

参数

参数 必需 类型 说明

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 参数指定包含要重试的邮件的队列的标识。以服务器\目标格式输入队列标识,其中的目标是远程域、邮箱服务器或永久队列名。

Confirm

可选

System.Management.Automation.SwitchParameter

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

Resubmit

可选

System.Boolean

使用 Resubmit 参数指定在建立连接之前,是否应将队列内容重新提交给分类程序。将 Resubmit 参数设置为 $false 可以强制尝试建立新连接。将 Resubmit 参数设置为 $false 可以将队列中的邮件重新提交到分类程序。

Server

可选

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

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

WhatIf

可选

System.Management.Automation.SwitchParameter

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

输入类型

返回类型

错误

错误 说明

 

 

异常

异常 说明

 

 

示例

以下示例显示如何强制所有符合下列条件的队列尝试连接:

  • 队列容纳指定域的邮件。

  • 队列状态为“重试”。

  • 队列位于执行命令的服务器上。

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

Retry-Queue -Filter {NextHopDomain -eq "contoso.com" -and Status -eq "retry"}