Retry-Queue (RTM)

  • 發行項

 

適用版本： Exchange Server 2007

上次修改主題的時間： 2008-03-11

使用 Retry-Queue 指令程式，可以在已安裝 Hub Transport server role 或 Edge Transport server role 的電腦上，強迫執行佇列的連線嘗試。

語法

Retry-Queue -Identity <QueueIdentity> [-Resubmit <$true | $false>]

Retry-Queue -Filter <String> [-Resubmit <$true | $false>] [-Server <ServerIdParameter>]

詳細描述

Retry-Queue 指令程式會針對具有 Retry 狀態的佇列強迫執行連線嘗試。命令會在可行時建立通往下個躍點的連線。如果已排定了連線，這個命令會將佇列的下一次重試時間重設為目前的時間，然後嘗試連線。如果未排定連線，便會設定新的重試時間。您可以使用 Resubmit 參數，讓佇列內容重新提交到分類程式。您可以使用這個命令重新嘗試傳遞 Unreachable 佇列中的郵件，但是必須包含 Resubmit 參數。

如果您將 Resubmit 參數設為 $false，Retry-Queue 指令程式會強制執行新的連線嘗試。如果您將 Resubmit 參數設為 $false，佇列中的郵件會重新提交至分類程式。

note附註：
只有當遠端佇列的狀態為 [重試] 時，才能將 Resubmit 參數設為 $true。

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

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

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

若要在已安裝 Edge Transport server role 的電腦上執行 Retry-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 是遠端網域、信箱伺服器或持續佇列名稱。

Resubmit

選用

System.Boolean

使用 Resubmit 參數可以指定建立連線之前，是否應該將佇列內容重新提交到分類程式。將 Resubmit 參數設為 $false，以強制執行新的連線嘗試。將 Resubmit 參數設為 $false ，以便將佇列中的郵件重新提交至分類程式。

Server

選用

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

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

輸入類型

傳回類型

錯誤

錯誤 描述

 

 

例外狀況

例外狀況 描述

 

 

範例

下列範例顯示如何針對符合下列準則的所有佇列強迫執行連線嘗試：

  • 佇列保留了指定網域的郵件。

  • 佇列狀態為 Retry。

  • 佇列位於執行命令的伺服器上。

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

Retry-Queue -Filter {NextHopDomain -eq "contoso.com" -and Status -eq "retry"}