Get-Queue (RTM)

  • 發行項

 

適用版本： Exchange Server 2007 SP1, Exchange Server 2007

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

使用 Get-Queue 指令程式可檢視已安裝 Hub Transport server role 或 Edge Transport server role 之電腦上的佇列組態資訊。

語法

Get-Queue [-BookmarkIndex <Int32>] [-BookmarkObject <QueueInfo>] [-Filter <String>] [-IncludeBookmark <$true | $false>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-Server <ServerIdParameter>] [-SortOrder <SortOrderEntry[]>]

Get-Queue [-Identity <QueueIdentity>] [-BookmarkIndex <Int32>] [-BookmarkObject <QueueInfo>] [-IncludeBookmark <$true | $false>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-SortOrder <SortOrderEntry[]>]

詳細描述

Get-Queue 指令程式可顯示 Hub Transport Server 或 Edge Transport Server 上現有佇列的相關資訊。如果不提供參數，命令會查詢本機伺服器上的所有佇列，並傳回一頁結果。預設的頁面大小是 1,000 個物件。將伺服器名稱包含為 Identity 參數的一部分，或使用 Server 參數加上篩選查詢，就可以顯示遠端伺服器上的佇列。Identity 參數及 Filter 參數集是互斥的。

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

  • Exchange Server 系統管理員角色

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

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

參數

參數 必要 類型 描述

BookmarkIndex

選用

System.Int32

使用 BookmarkIndex 參數可以指定所顯示結果在結果集中的開始位置。此參數的值是總結果集中以 1 為基礎的索引。BookmarkIndex 不可與 BookmarkObject 參數搭配使用。

BookmarkObject

選用

Microsoft.Exchange.Data.QueueViewer.QueueInfo

使用 BookmarkObject 參數可以指定所顯示結果在結果集中的開始物件。BookmarkObject 不可與 BookmarkIndex 參數搭配使用。

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 是遠端網域、信箱伺服器或持續佇列名稱。

IncludeBookmark

選用

System.Boolean

使用 IncludeBookmark 參數可以指定是否要在顯示查詢結果時包括書籤物件。IncludeBookmark 參數在配合 BookmarkObject 或 BookmarkIndex 參數使用時為有效的參數。如果未指定 IncludeBookmark 參數的值，則會使用 $true 的預設值。

ResultSize

選用

Microsoft.Exchange.Data.Unlimited

使用 ResultSize 參數可以指定要顯示在結果集中的總項目數。預設的 ResultSize 參數值是設為 1,000。ResultSize 支援沒有限制的結果數，但是 Microsoft Exchange 會將結果集限制為 250,000。

ReturnPageInfo

選用

System.Boolean

ReturnPageInfo 參數是隱藏參數。使用它以傳回有關總結果數及目前頁面之第一個物件的索引的相關資訊。預設值為 $false。

SearchForward

選用

System.Boolean

使用 SearchForward 參數可以指定要在結果集中進行往前或往後的搜尋。預設值為 $true。此值會從結果集的開頭或從所指定的書籤往前計算結果頁。

Server

選用

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

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

SortOrder

選用

Microsoft.Exchange.Configuration.Tasks.SortOrderEntry[]

使用 SortOrder 參數可以指定用來控制結果集之排序順序的郵件內容的陣列。以逗號分隔每個內容。在內容名稱的開頭加上 + 號，以使用遞增順序顯示結果。在內容名稱的開頭加上 - 號，以使用遞減順序顯示結果。如果您未指定排序順序，結果集會按 QueueIdentity 遞增順序顯示。

輸入類型

傳回類型

錯誤

錯誤 描述

 

 

範例

下列範例顯示三個 Get-Queue 命令。第一個命令顯示如何顯示執行命令的 Hub Transport Server 或 Edge Transport Server 上所有佇列的組態資訊。此命令會傳送至 Format-List 命令，將結果格式化為詳細清單。

第二個命令顯示如何只顯示包含超過 100 封郵件之佇列的組態資訊。

第三個命令顯示如何顯示位於遠端伺服器上之佇列的組態資訊。

如需管線的相關資訊，請參閱管線。

如需如何處理命令輸出的相關資訊，請參閱使用命令列輸出。

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

Get-Queue | format-list
Get-Queue -Filter {MessageCount -gt 100}
Get-Queue -Identity Server1\contoso.com

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