Get-Queue

參考

模組:: ExchangePowerShell

適用於:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

內部部署 Exchange 才有提供此 Cmdlet。

使用 Get-Queue Cmdlet 來檢視信箱伺服器或 Edge Transport Server 上佇列的組態資訊。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

Get-Queue
   [[-Identity] <QueueIdentity>]
   [-BookmarkIndex <Int32>]
   [-BookmarkObject <ExtensibleQueueInfo>]
   [-Exclude <QueueViewerIncludesAndExcludes>]
   [-Include <QueueViewerIncludesAndExcludes>]
   [-IncludeBookmark <Boolean>]
   [-ResultSize <Unlimited>]
   [-ReturnPageInfo <Boolean>]
   [-SearchForward <Boolean>]
   [-SortOrder <QueueViewerSortOrderEntry[]>]
   [<CommonParameters>]

Get-Queue
   [-Server <ServerIdParameter>]
   [-Filter <String>]
   [-BookmarkIndex <Int32>]
   [-BookmarkObject <ExtensibleQueueInfo>]
   [-Exclude <QueueViewerIncludesAndExcludes>]
   [-Include <QueueViewerIncludesAndExcludes>]
   [-IncludeBookmark <Boolean>]
   [-ResultSize <Unlimited>]
   [-ReturnPageInfo <Boolean>]
   [-SearchForward <Boolean>]
   [-SortOrder <QueueViewerSortOrderEntry[]>]
   [<CommonParameters>]

Description

您必須已獲指派權限，才能執行此指令程式。雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

Get-Queue | Format-List

此範例會顯示執行命令之信箱伺服器上所有佇列的詳細資訊。

範例 2

Get-Queue -Filter "MessageCount -gt 100"

此範例會列出包含超過 100 則訊息的佇列。

範例 3

Get-Queue Server1\contoso.com | Format-List

此範例會顯示位於名為 Server1 之信箱伺服器上特定佇列的詳細資訊。

範例 4

Get-Queue -Exclude Internal

此範例只會列出外部佇列。

參數

-BookmarkIndex

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-BookmarkObject

BookmarkObject 參數指定在結果集中開始顯示結果的物件。 BookmarkObject 參數不能與 BookmarkIndex 參數一起使用。

Type:	ExtensibleQueueInfo
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Exclude

Exclude 參數會指定您想要從結果中排除的佇列類型。此參數的有效值為：

內部
外部
有效的佇列 DeliveryType 值。如需詳細資訊，請參閱佇列和佇列中的訊息中的 NextHopSolutionKey 一節。

Type:	QueueViewerIncludesAndExcludes
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Filter

Filter 參數會使用 OPATH 篩選語法來指定一或多個佇列。 OPATH 篩選器包含佇列屬性名稱，後面接著比較運算子和值 (例如， "NextHopDomain -eq 'contoso.com'") 。如需可篩選佇列屬性和比較運算子的詳細資訊，請參閱Exchange Server中的佇列屬性和在 Exchange 管理命令介面的佇列中尋找佇列和訊息。

您可以使用和比較運算子來指定多個準則。未以整數表示的屬性值必須以引號括住 (「) 。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Identity 參數會指定佇列。此參數的有效輸入會使用以下語法：Server\Queue 或 Queue，例如，Mailbox01\contoso.com 或 Unreachable。如需佇列身分識別的詳細資訊，請參閱佇列身分識別。

Type:	QueueIdentity
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Include

Include 參數會指定您想要包含結果的佇列類型。此參數的有效值為：

內部
外部
有效的佇列 DeliveryType 值。如需詳細資訊，請參閱佇列和佇列中的訊息中的 NextHopSolutionKey 一節。

Type:	QueueViewerIncludesAndExcludes
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-IncludeBookmark

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ResultSize

ResultSize 參數會指定傳回的結果筆數上限。若要傳回符合查詢的所有要求，請使用 unlimited 作為此參數的值。預設值為 1000。

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ReturnPageInfo

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SearchForward

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Server

Server 參數指定您要執行此命令的 Exchange 伺服器。您可以使用唯一識別伺服器的任何值。例如：

Name
FQDN
辨別名稱 (DN)
Exchange Legacy DN

Exchange Legacy DN

同一個命令中可以同時使用 Server 參數和 Filter 參數。同一個命令中不能同時使用 Server 參數和 Identity 參數。

Type:	ServerIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SortOrder

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

如果您未指定排序次序，結果集會依 QueueIdentity 以遞增順序顯示。

Type:	QueueViewerSortOrderEntry[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

輸入

Input types

若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。

輸出

Output types

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。