通过

Remove-Message

  • 项目

 

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

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

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

语法

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

Remove-Message -Filter <String> [-Confirm [<SwitchParameter>]] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]] [-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   指定包含邮件的队列的标识。请以 Server\destination 的格式输入队列标识，其中 destination 是远程域、邮箱服务器或持久性队列名称。

  • 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

Confirm

可选

System.Management.Automation.SwitchParameter

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

Server

可选

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

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

WhatIf

可选

System.Management.Automation.SwitchParameter

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

WithNDR

可选

System.Boolean

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

输入类型

返回类型

错误

错误 说明

异常

异常 说明

示例

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

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

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

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

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

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