通过

Suspend-Message (RTM)

  • 项目

 

适用于： Exchange Server 2007

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

在已安装集线器传输服务器角色或边缘传输服务器角色的计算机上，使用 Suspend-Message cmdlet 可以阻止队列中特定邮件的传递。

语法

Suspend-Message -Identity <MessageIdentity>

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

详细说明

在集线器传输服务器或边缘传输服务器上，Suspend-Message cmdlet 可以阻止队列中一封或多封邮件的传递。不会挂起已在传递中的邮件。传递将继续进行，并且邮件状态将是暂停挂起。如果传递失败，则邮件会重新进入队列，然后被挂起。无法挂起“提交”队列或“带毒邮件”队列中的邮件。

发送给多个收件人的邮件可能位于多个队列中。如果指定了 Identity 参数，当标识仅与一封邮件相匹配时，则单个队列中的邮件将被挂起。如果该标识与多封邮件匹配，则将收到错误消息。若要通过一个操作挂起多个队列中的邮件，必须使用筛选器。必须使用 Identity 参数或 Filter 参数。这两个参数的设置是互斥的。

可以通过将服务器名作为 Identity 参数的一部分包括在内，或将 Server 参数与 Filter 参数一起使用，以挂起远程服务器上的邮件。如果不指定服务器，则仅对本地服务器运行此命令。

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

若要在已安装边缘传输服务器角色的计算机上运行 Suspend-Message cmdlet，必须以该计算机上的本地 Administrators 组成员身份进行登录。

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

参数

参数 必需 类型 说明

Filter

必需

System.String

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

  • DateReceived   接收邮件的日期。

  • ExpirationTime   邮件的过期时间。

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

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

  • InternetMessageId   MessageID: 头字段的值。此属性以后跟发送服务器的 SMTP 地址的 GUID 来表示，如下例所示：67D7543D6103DC4FBEBA6BC7205DACABA61231@exchange.contoso.com。

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

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

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

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

  • SCL   垃圾邮件可信度 (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) 连接到服务器的名称。该远程过程调用所包含的队列中有要挂起的邮件。请输入 server 名称作为主机名或完全限定域名 (FQDN)。如果不使用此参数，则将查询本地服务器。

输入类型

返回类型

错误

错误 说明

 

 

异常

异常 说明

 

 

示例

下列示例显示如何阻止下列条件为真的所有邮件的传递：

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

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

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

Suspend-Message -Filter {FromAddress -eq "sender@contoso.com"}