Get-QueueDigest

參考

模組:: ExchangePowerShell

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

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

使用 Get-QueueDigest Cmdlet 來檢視跨資料庫可用性群組的訊息傳遞佇列相關資訊， (DAG) Active Directory 網站或您組織中的 Active Directory 樹系。

依預設， Get-QueueDigest 指令程式會顯示包含十封郵件以上的傳遞佇列，而且會是一到二分鐘之前的結果。如需如何變更這些預設值的指示，請參閱設定 Get-QueueDigest。

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

Syntax

Get-QueueDigest
   -Dag <MultiValuedProperty>
   [-DetailsLevel <DetailsLevel>]
   [-Filter <String>]
   [-GroupBy <QueueDigestGroupBy>]
   [-ResultSize <Unlimited>]
   [-Timeout <EnhancedTimeSpan>]
   [<CommonParameters>]

Get-QueueDigest
   [-Forest]
   [-DetailsLevel <DetailsLevel>]
   [-Filter <String>]
   [-GroupBy <QueueDigestGroupBy>]
   [-ResultSize <Unlimited>]
   [-Timeout <EnhancedTimeSpan>]
   [<CommonParameters>]

Get-QueueDigest
   -Server <MultiValuedProperty>
   [-DetailsLevel <DetailsLevel>]
   [-Filter <String>]
   [-GroupBy <QueueDigestGroupBy>]
   [-ResultSize <Unlimited>]
   [-Timeout <EnhancedTimeSpan>]
   [<CommonParameters>]

Get-QueueDigest
   -Site <MultiValuedProperty>
   [-DetailsLevel <DetailsLevel>]
   [-Filter <String>]
   [-GroupBy <QueueDigestGroupBy>]
   [-ResultSize <Unlimited>]
   [-Timeout <EnhancedTimeSpan>]
   [<CommonParameters>]

Description

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

範例

範例 1

Get-QueueDigest -Forest

此範例會傳回 Active Directory 樹系中所有佇列的相關資訊。

範例 2

Get-QueueDigest -Dag DAG01

本範例傳回 DAG 中名為 DAG01 的所有佇列相關資訊。

參數

-Dag

Dag參數會由 DAG 過濾傳遞佇列結果。您可以指定唯一識別 DAG 的任何值。您可以指定多個以逗號分隔的值。如果值包含空格，請使用引號 (") 括住值。

您不能搭配 Dag 參數或 Server 參數使用 Site 或 Forest 參數。

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

-DetailsLevel

DetailsLevel 參數會在結果中指定要顯示的詳細資訊層級。此參數的有效值為 None、Normal 及 Verbose。預設值為 Normal。

Type:	DetailsLevel
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 2013, Exchange Server 2016, Exchange Server 2019

-Forest

樹系參數會依 Active Directory 樹系篩選傳遞佇列結果。使用 Forest 參數時不需指定任何值。

您不能搭配 Forest、Server 或 Site 參數使用 Dag 參數。

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

-GroupBy

GroupedBy參數會排序傳遞佇列結果中的訊息。有效值為：

DeliveryType
LastError
NextHopCategory
NextHopDomain (這是預設值)
NextHopKey
RiskLevel
Status
ServerName
OutboundIPPool

Type:	QueueDigestGroupBy
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

-ResultSize

\ ResultSize 參數會依照佇列的訊息數過濾傳遞佇列結果。這個參數的有效輸入是整數。預設值為 1000。例如，若您指定 50 為值，則命令會顯示包含最多訊息的 50 個佇列。

Type:	Unlimited
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

-Server

Server 參數會依 Exchange Server 篩選傳遞佇列結果。您可以指定唯一識別伺服器的任何值。您可以指定多個以逗號分隔的值。如果值包含空格，請使用引號 (") 括住值。

您不能搭配 Server 參數或 Dag 參數使用 Site 或 Forest 參數。

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

-Site

Site 參數會依 Active Directory 月臺篩選傳遞佇列結果。您可以指定唯一識別站台的任何值。您可以指定多個以逗號分隔的站台。

您不能搭配 Site 參數或 Server 參數使用 Dag 或 Forest 參數。

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

-Timeout

Timeout 參數可指定作業逾時前的秒數。預設值為 10 秒。

若要指定值，請將其輸入為時間範圍：dd.hh：mm：ss，其中 dd = days、hh = hours、mm = minutes 和 ss = seconds。

Type:	EnhancedTimeSpan
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

輸入

Input types

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

輸出

Output types

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

共用方式為