Get-QueueDigest

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。

Get-QueueDigest コマンドレットを使用して、データベース可用性グループ (DAG) Active Directory サイト、または組織内の Active Directory フォレスト間のメッセージ配信キューに関する情報を表示します。

既定では、Get-QueueDigest コマンドレットには、10 個以上のメッセージを含む配信キューが表示され、結果は 1 分から 2 分前です。これらの既定値を変更する方法については、「 Get-QueueDigest の構成」を参照してください。

以下の構文セクションのパラメーターセットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

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>]

説明

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例

例 1

Get-QueueDigest -Forest

この例では、Active Directory フォレスト内のすべてのキューに関する情報を返します。

例 2

Get-QueueDigest -Dag DAG01

この例では、DAG01 という名前の DAG 内にあるすべてのキューに関する情報が返されます。

パラメーター

-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 です。既定値は標準です。

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 フィルター構文を使用して 1 つ以上のキューを指定します。 OPATH フィルターには、キュープロパティ名の後に比較演算子と値 (例: "NextHopDomain -eq 'contoso.com'") が含まれます。フィルター可能なキューのプロパティと比較演算子の詳細については、「Exchange Serverのキュープロパティ」および「Exchange Management Shell のキュー内のキューとメッセージを検索する」を参照してください。

および比較演算子を使用して、複数の条件を指定できます。整数として表されないプロパティ値は、引用符 (") で囲む必要があります。

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
状態
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 パラメーターは、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

このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。

次の方法で共有