Get-Queue
內部部署 Exchange 才有提供此 Cmdlet。
使用 Get-Queue 指令小子來查看郵箱伺服器或邊緣傳輸伺服器上佇列的設定資訊。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Identity
Get-Queue
[[-Identity] <QueueIdentity>]
[-BookmarkIndex <Int32>]
[-BookmarkObject <ExtensibleQueueInfo>]
[-Exclude <QueueViewerIncludesAndExcludes>]
[-Include <QueueViewerIncludesAndExcludes>]
[-IncludeBookmark <Boolean>]
[-ResultSize <Unlimited>]
[-ReturnPageInfo <Boolean>]
[-SearchForward <Boolean>]
[-SortOrder <QueueViewerSortOrderEntry[]>]
[<CommonParameters>]
Server
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 的所有參數，但如果某些參數未包含在你分配的權限中，你可能無法存取這些參數。 若要尋找在組織中執行任何 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
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
BookmarkIndex 參數指定在結果集中開始顯示結果的位置。 此參數的值是總結果集中以 1 為基礎的索引。 BookmarkIndex 參數不能與 BookmarkObject 參數一起使用。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-BookmarkObject
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
BookmarkObject 參數指定在結果集中開始顯示結果的物件。 BookmarkObject 參數不能與 BookmarkIndex 參數一起使用。
參數屬性
| 類型: | ExtensibleQueueInfo |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Exclude
適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
排除參數指定你想從結果中排除的隊列類型。 此參數的有效值為：
- 內部
- 外部
- 一個有效的佇列 DeliveryType 值。 詳情請參閱 佇列 中的 NextHopSolutionKey 區段及佇列中的訊息。
參數屬性
| 類型: | QueueViewerIncludesAndExcludes |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Filter
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Filter 參數透過 OPATH 濾波器語法指定一個或多個佇列。 OPATH 濾波器包含佇列屬性名稱，後接比較運算子及值 (，例如 "NextHopDomain -eq 'contoso.com'") 。 關於可篩選佇列屬性與比較運算子的詳細資訊，請參閱 Exchange Server 中的佇列屬性，以及 Exchange 管理殼層中的佇列與訊息。
你可以透過使用 and 比較運算子來指定多個條件。 非整數表示的財產價值必須以引號 (“) ”作為標示。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Server
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Identity 參數會指定佇列。 此參數的有效輸入會使用以下語法：Server\Queue 或 Queue，例如，Mailbox01\contoso.com 或 Unreachable。 關於佇列身份的詳細資訊，請參見 佇列身份。
注意：Identity 參數的值$null或不存在的值，會回傳 所有 物件，就像你執行 Get- 指令時沒有 Identity 參數一樣。 請確認 Identity 參數的值清單是否準確，且不包含不存在的 $null 值。
參數屬性
| 類型: | QueueIdentity |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Include
適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Include 參數指定你想包含結果的隊列類型。 此參數的有效值為：
- 內部
- 外部
- 一個有效的佇列 DeliveryType 值。 詳情請參閱 佇列 中的 NextHopSolutionKey 區段及佇列中的訊息。
參數屬性
| 類型: | QueueViewerIncludesAndExcludes |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-IncludeBookmark
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
IncludeBookmark 參數指定顯示的查詢結果是否要包含書籤物件。 IncludeBookmark 參數配合 BookmarkObject 或 BookmarkIndex 參數使用時有效。 如果未指定 IncludeBookmark 參數的值，則會使用預設值 $true。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ResultSize
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
ResultSize 參數會指定傳回的結果筆數上限。 若要傳回符合查詢的所有要求，請使用 unlimited 作為此參數的值。 預設值為 1000。
參數屬性
| 類型: | Unlimited |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ReturnPageInfo
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
ReturnPageInfo 參數是隱藏參數。 使用它以傳回有關總結果數及目前頁面之第一個物件的索引的相關資訊。 預設值為 $false。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SearchForward
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
SearchForward 參數指定要在結果集中進行往前或往回搜尋。 預設值為 $true。 此值會從結果集的開頭或從所指定的書籤往前計算結果頁。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Server
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Server 參數指定您要執行此命令的 Exchange 伺服器。 您可以使用唯一識別伺服器的任何值。 例如：
- Name
- FQDN
- 辨別名稱 (DN)
- Exchange Legacy DN
Exchange Legacy DN
同一個命令中可以同時使用 Server 參數和 Filter 參數。 同一個命令中不能同時使用 Server 參數和 Identity 參數。
參數屬性
| 類型: | ServerIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Server
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-SortOrder
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
SortOrder 參數指定用來控制結果集之排序順序的郵件內容陣列。 以逗號分隔每個屬性。 在屬性名稱的開頭加上加號 (+)，以使用遞增順序顯示結果。 在屬性名稱的開頭加上減號 (-)，以使用遞減順序顯示結果。
如果你沒有指定排序順序，結果集會由 QueueIdentity 以升序顯示。
參數屬性
| 類型: | QueueViewerSortOrderEntry[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸入
Input types
若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。