Suspend-Queue (RTM)

  • 發行項

 

適用版本： Exchange Server 2007

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

使用 Suspend-Queue 指令程式，可以在已安裝 Hub Transport server role 或 Edge Transport server role 的電腦上停止佇列中的輸出活動。

語法

Suspend-Queue -Identity <QueueIdentity>

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

詳細描述

Suspend-Queue 指令程式可停止佇列中狀態處於 Active 或 Retry 的輸出活動。透過 SMTP-send 傳遞的訊息會完成作業。其他訊息則都不會離開佇列。若您指定 Identity 參數，且此識別僅符合單一佇列，該佇列就會暫停。如果該識別與多個佇列相符，則會收到錯誤。若要在單一作業中暫停多個佇列，則必須使用篩選器。

您必須使用 Identity 參數或 Filter 參數。Identity 與 Filter 參數集互斥。將伺服器名稱包含為 Identity 參數的一部分，或使用 Server 參數加上篩選查詢，即可暫停遠端伺服器上的佇列。如果您沒有指定伺服器，則命令只會對本機伺服器執行。

若要執行 Suspend-Queue 指令程式，必須對您使用的帳戶委派下列項目：

  • Exchange Server 系統管理員角色和目標伺服器的本機 Administrators 群組

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

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

參數

參數 必要 類型 描述

Filter

必要

System.String

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

  • DeliveryType   此佇列的傳遞類型，與傳輸所定義的相同。傳遞類型必須是下列其中一個值：
    • DNSConnectorDelivery
    • NonSMTPGatewayDelivery
    • SmartHostConnectorDelivery
    • SmtpRelayWithinAdSitetoEdge
    • MapiDelivery
    • SmtpRelayWithinAdSite
    • SmtpRelaytoRemoteAdSite
    • SmtpRelaytoTiRg
    • Undefined
    • Unreachable
  • Identity   請以 Server\destination 的形式輸入佇列識別，其中 destination 是遠端網域、信箱伺服器或持續佇列名稱。
  • LastError   文字字串，記錄佇列上次的錯誤。
  • LastRetryTime   最後一次嘗試連線此佇列的時間。
  • MessageCount   佇列中的項目數。
  • NextHopConnector   用來建立佇列之連接器的 GUID。
  • NextHopDomain   佇列的下一個躍點網域，指定成遠端簡易郵件傳送通訊協定 (SMTP) 網域、伺服器名稱、Active Directory 站台的名稱或郵件資料庫 (MDB) 識別碼。
  • NextRetryTime   下一次嘗試連線此佇列的時間。
  • Status   佇列的狀態。佇列狀態選項有 Active、Ready、Retry 或 Suspended。

您可以使用 - and 比較運算子來指定多個準則。不是以整數表示的內容值必須用引號括住。

Identity

必要

Microsoft.Exchange.Data.QueueViewer.QueueIdentity

使用 Identity 參數，可指定您要暫停的訊息所在之佇列的識別。請以 Server\destination 的形式輸入佇列識別，其中 destination 是遠端網域、信箱伺服器或持續佇列名稱。

Server

選用

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

使用 Server 參數來指定要連接的伺服器名稱，方法是使用遠端程序呼叫 (RPC)，此遠端程序呼叫包含保留您要暫停的訊息之佇列。請以主機名稱或網域全名 (FQDN) 來輸入伺服器名稱。如果未使用此參數，則會查詢本機伺服器。

輸入類型

傳回類型

錯誤

錯誤 描述

 

 

例外狀況

例外狀況 描述

 

 

範例

下列範例會顯示兩個 Suspend-Queue 命令。第一個命令會針對要傳送到指定網域、且目前狀態為 Retry 的訊息所在之所有佇列，暫停這些佇列上的任何傳出活動。

第二個命令會使用 RPC 繫結至遠端伺服器，並暫停所含訊息超過 100 封的所有佇列。

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

Suspend-Queue -Filter {NextHopDomain -eq "contoso.com" -and Status -eq "retry"}
Suspend-Queue -Server ExchSrv1.contoso.com -Filter {MessageCount -gt 100}

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