共用方式為

Suspend-Message (RTM)

  • 發行項

 

適用版本： Exchange Server 2007

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

使用 Suspend-Message 指令程式可在已安裝 Hub Transport server role 或 Edge Transport server role 的電腦上，防止將佇列中的特定郵件傳遞出去。

語法

Suspend-Message -Identity <MessageIdentity>

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

詳細描述

Suspend-Message 指令程式可防止將 Hub Transport Server 或 Edge Transport Server 上佇列中的一或多封郵件傳遞出去。傳遞已在進行中的訊息則不會暫停。傳遞將會繼續，且訊息狀態會是 PendingSuspend。如果傳遞失敗了，訊息將會重新進入佇列，然後訊息會被暫停。您無法將位於提交佇列或毒藥郵件佇列的郵件暫停。

正要傳送給多位收件者的訊息可能會在多個佇列中。如果您指定了 Identity 參數，則會將單一佇列中的訊息暫停 (若該識別碼只與單一訊息相符)。如果該識別與多封訊息相符，將會收到錯誤。若要在單一作業中暫停位於多個佇列中的訊息，您必須使用篩選。您必須使用 Identity 參數或 Filter 參數。這兩個參數組合是互斥的。

將伺服器名稱包含為 Identity 參數的一部分，或使用 Server 參數加上 Filter 參數，就可以暫停遠端伺服器上的訊息。如果您沒有指定伺服器，則命令只會對本機伺服器執行。

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

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

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

參數

參數 必要 類型 描述

Filter

必要

System.String

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

  • DateReceived   收到訊息的日期。
  • ExpirationTime   訊息過期的時間。
  • FromAddress   訊息寄件者的簡易郵件傳送通訊協定 (SMTP) 地址。該值是從郵件信封的 MAIL FROM: 中擷取。
  • Identity   代表特定訊息及選用伺服器和佇列識別的整數。
  • InternetMessageId   MessageID: 標頭欄位的值。此內容的表示方式是 GUID 後面接著傳送伺服器的 SMTP 位址，如下面範例所示：67D7543D6103DC4FBEBA6BC7205DACABA61231@exchange.contoso.com。
  • LastError   文字字串，記錄訊息上次的錯誤。
  • MessageSourceName   將此訊息提交到佇列之元件名稱的文字字串。
  • Queue   指定保留訊息之佇列的識別。請以 Server\destination 的形式輸入佇列識別，其中 destination 是遠端網域、信箱伺服器或持續佇列名稱。
  • RetryCount   將訊息傳遞至目的地的嘗試次數。
  • SCL   垃圾郵件信賴等級 (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 名稱。如果未使用此參數，則會查詢本機伺服器。

輸入類型

傳回類型

錯誤

錯誤 描述

 

 

例外狀況

例外狀況 描述

 

 

範例

下列範例顯示如何防止將符合下列條件的所有訊息傳遞出去：

  • 從指定的寄件者 SMTP 位址傳送的訊息。
  • 訊息正佇列在執行此命令的 Hub Transport Server 或 Edge Transport Server 上。

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

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

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