Get-QueueDigest
內部部署 Exchange 才有提供此 Cmdlet。
使用 Get-QueueDigest Cmdlet 來檢視跨資料庫可用性群組的訊息傳遞佇列相關信息， (DAG) Active Directory 網站或您組織中的 Active Directory 樹系。
依預設， Get-QueueDigest 指令程式會顯示包含十封郵件以上的傳遞佇列，而且會是一到二分鐘之前的結果。 如需如何變更這些預設值的指示，請參閱 設定 Get-QueueDigest。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Dag
Get-QueueDigest
-Dag <MultiValuedProperty>
[-DetailsLevel <DetailsLevel>]
[-Filter <String>]
[-GroupBy <QueueDigestGroupBy>]
[-ResultSize <Unlimited>]
[-Timeout <EnhancedTimeSpan>]
[<CommonParameters>]
Forest
Get-QueueDigest
[-Forest]
[-DetailsLevel <DetailsLevel>]
[-Filter <String>]
[-GroupBy <QueueDigestGroupBy>]
[-ResultSize <Unlimited>]
[-Timeout <EnhancedTimeSpan>]
[<CommonParameters>]
Server
Get-QueueDigest
-Server <MultiValuedProperty>
[-DetailsLevel <DetailsLevel>]
[-Filter <String>]
[-GroupBy <QueueDigestGroupBy>]
[-ResultSize <Unlimited>]
[-Timeout <EnhancedTimeSpan>]
[<CommonParameters>]
Site
Get-QueueDigest
-Site <MultiValuedProperty>
[-DetailsLevel <DetailsLevel>]
[-Filter <String>]
[-GroupBy <QueueDigestGroupBy>]
[-ResultSize <Unlimited>]
[-Timeout <EnhancedTimeSpan>]
[<CommonParameters>]
Description
您必須已獲指派權限，才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數，但如果某些參數未包含在指派給您的許可權中，您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Get-QueueDigest -Forest
此範例會傳回 Active Directory 樹系中所有佇列的相關信息。
範例 2
Get-QueueDigest -Dag DAG01
本範例傳回 DAG 中名為 DAG01 的所有佇列相關資訊。
參數
-Dag
適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Dag參數會由 DAG 過濾傳遞佇列結果。 您可以指定唯一識別 DAG 的任何值。 您可以指定多個以逗號分隔的值。 如果值包含空格，請使用引號 (") 括住值。
您不能搭配 Dag 參數或 Server 參數使用 Site 或 Forest 參數。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Dag
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-DetailsLevel
適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
DetailsLevel 參數會在結果中指定要顯示的詳細資訊層級。 此參數的有效值為 None、Normal 及 Verbose。 預設值為 Normal。
參數屬性
| 類型: | DetailsLevel |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Filter
適用：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 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Forest
適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
樹係參數會依 Active Directory 樹系篩選傳遞佇列結果。 使用 Forest 參數時不需指定任何值。
您不能搭配 Forest、Server 或 Site 參數使用 Dag 參數。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Forest
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-GroupBy
適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
GroupedBy參數會排序傳遞佇列結果中的訊息。 有效值為：
- DeliveryType
- LastError
- NextHopCategory
- NextHopDomain (這是預設值)
- NextHopKey
- RiskLevel
- Status
- ServerName
- OutboundIPPool
參數屬性
| 類型: | QueueDigestGroupBy |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ResultSize
適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
\ ResultSize 參數會依照佇列的訊息數過濾傳遞佇列結果。 這個參數的有效輸入是整數。 預設值為 1000。 例如，若您指定 50 為值，則命令會顯示包含最多訊息的 50 個佇列。
參數屬性
| 類型: | Unlimited |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Server
適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Server 參數會依 Exchange Server 篩選傳遞佇列結果。 您可以指定唯一識別伺服器的任何值。 您可以指定多個以逗號分隔的值。 如果值包含空格，請使用引號 (") 括住值。
您不能搭配 Server 參數或 Dag 參數使用 Site 或 Forest 參數。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Server
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Site
適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Site 參數會依 Active Directory 月臺篩選傳遞佇列結果。 您可以指定唯一識別站台的任何值。 您可以指定多個以逗號分隔的站台。
您不能搭配 Site 參數或 Server 參數使用 Dag 或 Forest 參數。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Site
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Timeout
適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Timeout 參數可指定作業逾時前的秒數。預設值為 10 秒。
若要指定值，請將其輸入為時間範圍：dd.hh：mm：ss，其中 dd = days、hh = hours、mm = minutes 和 ss = seconds。
參數屬性
| 類型: | EnhancedTimeSpan |
| 預設值: | 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
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。