通过

Suspend-Message

  • 项目

 

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

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

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

语法

Suspend-Message -Identity <MessageIdentity> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

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

详细说明

在集线器传输服务器或边缘传输服务器上，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   指定包含邮件的队列的标识。请以 Server\destination 的格式输入队列标识，其中 destination 是远程域、邮箱服务器或持久性队列名称。

  • 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

Confirm

可选

System.Management.Automation.SwitchParameter

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

Server

可选

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

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

WhatIf

可选

System.Management.Automation.SwitchParameter

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

输入类型

返回类型

错误

错误 说明

 

 

异常

异常 说明

 

 

示例

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

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

  • 在运行命令的集线器传输服务器或边缘传输服务器上使邮件排队。

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

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