Resume-Message

 

適用版本: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上次修改主題的時間: 2007-06-28

使用 Resume-Message 指令程式,可以在已安裝 Hub Transport server role 或 Edge Transport server role 的電腦上,傳遞佇列中先前擱置的郵件。

語法

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

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

詳細描述

Resume-Message 指令程式會傳遞 Hub Transport Server 或 Edge Transport Server 的佇列中,先前擱置的郵件。正要傳送給多位收件者的訊息可能會在多個佇列中。如果您指定了 Identity 參數,則會繼續傳遞單一佇列中的郵件 (若該識別只與單一郵件相符)。如果該識別與多封訊息相符,將會收到錯誤。若要在單一作業中繼續進行位於多個佇列中的訊息,您必須使用篩選。

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

將伺服器名稱包含為 Identity 參數的一部分,或使用 Server 參數加上 Filter 參數,就可以繼續傳遞遠端伺服器上的郵件。如果您沒有指定伺服器,則命令只會對本機伺服器執行。

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

若要在已安裝 Edge Transport server role 的電腦上執行 Resume-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

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 參數指定任何值。

輸入類型

傳回類型

錯誤

錯誤 描述

 

 

例外狀況

例外狀況 描述

 

 

範例

下列範例顯示如何繼續傳遞所有處於擱置狀態以及符合下列條件的郵件:

  • 從指定的寄件者 SMTP 位址傳送的郵件。
  • 訊息正佇列在執行此命令的 Hub Transport Server 或 Edge Transport Server 上。
  • 郵件會在指定日期當天下午 3:00 之前到期。

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

Resume-Message -Filter {FromAddress -eq "sender@contoso.com" -and ExpirationTime -lt "yyyy-mm-dd 03:00:00 PM"}

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