共用方式為

Remove-Message (RTM)

  • 發行項

 

適用版本： Exchange Server 2007

上次修改主題的時間： 2007-06-08

使用 Remove-Message 指令程式，在已安裝 Hub Transport server role 或 Edge Transport server role 的電腦上刪除佇列中的郵件。

語法

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

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

詳細描述

Remove-Message 指令程式會刪除 Hub Transport Server 或 Edge Transport Server 上之佇列中的一或多封郵件。正要傳輸給多位收件者的郵件可能會在多個佇列中。如果您指定了 Identity 參數，則會從單一佇列中移除郵件 (若該識別只與單一郵件相符)。如果該識別與多封訊息相符，將會收到錯誤。若要在單一作業中移除來自多個佇列中的訊息，您必須使用篩選。如果您嘗試移除目前正在傳遞的郵件，郵件狀態將變更為 PendingDelete。郵件傳遞將不會中斷，但若傳遞失敗並導致郵件重新進入佇列，則會移除它。

您必須使用 Identity 參數或 Filter 參數。這兩個參數組合是互斥的。

若要執行 Remove-Message 指令程式，必須對您使用的帳戶委派 Exchange Server 系統管理員角色及目標伺服器本機 Administrators 群組。

若要在已安裝 Edge Transport server role 的電腦上執行 Remove-Message 指令程式，則必須使用該電腦之本機 Administrators 群組成員的帳戶進行登入。

如需管理 Microsoft Exchange Server 2007 所需之權限、委派角色及權利的相關資訊，請參閱權限考量。

參數

參數 必要 類型 描述

Filter

必要

System.String

Filter 參數需要運算式，來指定您要移除之郵件的內容值準則。運算式包含內容名稱，名稱後面接著比較運算子和值。下列訊息內容是可用於 Filter 參數的有效準則：

  • DateReceived   收到訊息的日期。
  • ExpirationTime   訊息過期的時間。
  • FromAddress   訊息寄件者的簡易郵件傳送通訊協定 (SMTP) 地址。該值是從郵件信封的 MAIL FROM: 中擷取。
  • Identity   代表特定訊息及選用伺服器和佇列識別的整數。
  • InternetMessageId   Message-ID: 標頭欄位的值。此內容的表示方式是 GUID 後面接著傳送伺服器的 SMTP 位址，如下面範例所示：67D7543D6103DC4FBEBA6BC7205DACABA61231@exchange.contoso.com。
  • LastError   文字字串，記錄訊息上次的錯誤。
  • MessageSourceName   將此訊息提交到佇列之元件名稱的文字字串。
  • Queue   指定保留訊息之佇列的識別。請以 Server\destination 的形式輸入佇列識別，其中 destination 是遠端網域、信箱伺服器或持續佇列名稱。
  • RetryCount   將訊息傳遞至目的地的嘗試次數。
  • SCL   SCL 內容指定郵件的垃圾郵件信賴等級。有效 SCL 項目是整數 0 到 9。空白的 SCL 屬性值指出內容篩選器代理程式尚未處理郵件。
  • Size   訊息的大小。
  • SourceIP   將訊息提交到 Exchange 組織的外部伺服器之 IP 位址。
  • Status   目前的訊息狀態。訊息狀態選項有 Active、Retry、Suspended、PendingSuspend 及 PendingRemove。
  • 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 位址傳送的訊息。
  • 訊息正佇列在執行此命令的 Hub Transport Server 或 Edge Transport Server 上。

下列範例也會顯示如何關閉 NDR。

如需如何使用 Exchange 管理命令介面來執行佇列檢視器工作的相關資訊，請參閱使用 Exchange 管理命令介面管理佇列。

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

若要確保您目前閱讀的是最新資訊，並尋找其他的 Exchange Server 2007 說明文件，請造訪 Exchange Server 技術資源中心.