Get-Queue
內部部署 Exchange 才有提供此 Cmdlet。
使用 Get-Queue Cmdlet 來檢視信箱伺服器或邊緣傳輸伺服器上佇列的設定資訊。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 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
Exclude 參數會指定您要從結果中排除的佇列類型。 此參數的有效值為：
- 內部
- 外部
- 有效的佇列 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 管理命令介面的佇列中尋找佇列和郵件。
您可以使用 和比較運算子指定多個準則。 未以整數表示的屬性值必須以引號 (“) 括住。
參數屬性
| 類型: | 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
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。