Resume-Message (RTM)

 

适用于: Exchange Server 2007

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

使用 Resume-Message cmdlet 可在安装了集线器传输服务器角色或边缘传输服务器角色的计算机上启用队列中以前挂起的邮件的传递。

语法

Resume-Message -Identity <MessageIdentity>

Resume-Message -Filter <String> [-Server <ServerIdParameter>]

详细说明

Resume-Message cmdlet 可在集线器传输服务器或边缘传输服务器上启用队列中以前挂起的邮件的传递。发送给多个收件人的邮件可能位于多个队列中。如果指定 Identity 参数,若该标识只与一封邮件匹配,则将恢复该邮件。如果该标识与多封邮件匹配,则将收到错误消息。若要在一次操作中恢复多个队列中的邮件,必须使用筛选器。

必须使用 Identity 参数或 Filter 参数。这两个参数的设置是互斥的。

通过在 Identity 参数中包含服务器名称,或在 Filter 参数中使用 Server 参数,可以恢复远程服务器上的邮件。如果不指定服务器,该命令将只对本地服务器运行。

要运行 Resume-Message cmdlet,必须为您使用的帐户委派 Exchange Server 管理员角色和目标服务器的本地 Administrators 组。

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

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

参数

参数 必需 类型 说明

Filter

必需

System.String

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

  • DateReceived   接收邮件的日期。

  • ExpirationTime   邮件的过期时间。

  • FromAddress   邮件发件人的简单邮件传输协议 (SMTP) 地址。此值是从邮件信封中的 MAIL FROM: 获取的。

  • Identity   表示特定邮件以及可选的服务器和队列标识的整数。

  • InternetMessageId   位于邮件头中的 Message-ID: 邮件头字段的值。此属性以后跟发送服务器的 SMTP 地址的 GUID 来表示,如下例所示:67D7543D6103DC4FBEBA6BC7205DACABA61231@exchange.contoso.com。

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

  • MessageSourceName   将此邮件提交给队列的组件名的文本字符串。

  • Queue   指定容纳该邮件的队列的标识。以服务器\目标格式输入队列标识,其中的目标是远程域、邮箱服务器或永久队列名。

  • RetryCount   尝试将邮件传递到目标地址的次数。

  • SCL   SCL 属性指定邮件的垃圾邮件可信度。有效的 SCL 条目是从 0 到 9 的整数。空 SCL 属性值表示邮件尚未经过内容筛选器代理处理。

  • Size   邮件的大小。

  • SourceIP   将邮件提交给 Exchange 组织的外部服务器的 IP 地址。

  • Status   邮件的当前状态。邮件状态选项为“活动”、“重试”、“已挂起”、“暂停挂起”和“暂停删除”。

  • Subject   表示电子邮件主题的文本字符串。该值是从 Subject: 头字段中获取的。

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

Identity

必需

Microsoft.Exchange.Data.QueueViewer.MessageIdentity

使用 Identity 参数指定 MessageIdentity 整数。此整数表示特定邮件以及可选的服务器和队列标识。此参数的语法如下:

  • Server\QueueIdentity\MessageIdentity

  • QueueIdentity\MessageIdentity

  • Server\*\MessageIdentity

  • MessageIdentity

Server

可选

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

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

输入类型

返回类型

错误

错误 说明

 

 

异常

异常 说明

 

 

示例

以下示例显示如何恢复处于已挂起状态并且符合下列条件的所有邮件的传递:

  • 邮件从指定发件人的 SMTP 地址发送。

  • 邮件处于运行命令的集线器传输服务器或边缘传输服务器上的队列中。

  • 邮件将在指定日期的下午 3:00 之前过期。

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

Resume-Message -Filter {FromAddress -eq "sender@contoso.com" -and ExpirationTime -lt "yyyy-mm-dd 03:00:00 PM"}