Get-QueueDigest

內部部署 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

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