通过

Remove-Message (RTM)

  • 项目

 

适用于： Exchange Server 2007

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

使用 Remove-Message cmdlet，可以从安装了集线器传输服务器角色或边缘传输服务器角色的计算机上的队列中删除邮件。

语法

Remove-Message -Identity <MessageIdentity> [-WithNDR <$true | $false>]

Remove-Message -Filter <String> [-Server <ServerIdParameter>] [-WithNDR <$true | $false>]

详细说明

Remove-Message cmdlet 用于删除位于集线器传输服务器或边缘传输服务器上队列中的一个或多个邮件。要传输到多个收件人的邮件可能位于多个队列中。如果指定 Identity 参数，并且该标识仅与一封邮件相匹配，则会从单个队列中删除邮件。如果该标识与多封邮件匹配，则将收到错误消息。若要通过一个操作从多个队列中删除邮件，必须使用筛选器。如果试图删除当前正在传递中的邮件，则邮件状态将更改为 PendingDelete。邮件传递不会中断，但是，如果传递失败并导致邮件重新进入队列，则会将其删除。

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

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

若要在安装了边缘传输服务器角色的计算机上运行 Remove-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 参数。如果不使用此参数，则将查询本地服务器。

WithNDR

可选

System.Boolean

使用 WithNDR 参数可以指定是否将未送达报告 (NDR) 返回给邮件的发件人。此参数的默认行为设置为 $true。此参数可以同时与 Identity 参数和 Filter 参数集一起使用。

输入类型

返回类型

错误

错误 说明

异常

异常 说明

示例

下列示例显示如何删除满足下列条件的所有邮件：

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

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

下列示例还显示了如何禁止 NDR。

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

Remove-Message -Filter {FromAddress -eq "sender@contoso.com"} -withNDR $false