Retry-Queue (RTM)

Exchange 2007
 

適用版本: 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 參數設為 $falseRetry-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"}
 
顯示: