Exchange 管理シェルでキュー内のキューとメッセージを検索する

以前のバージョンの Exchange と同様に、Exchange Serverの Exchange 管理シェルを使用してキューとメッセージに関する情報を表示し、その情報を使用してキューとメッセージに対してアクションを実行できます。 通常、アクティブな Exchange には多数のキューと配信されるメッセージが含まれているため、管理するキューまたはメッセージを識別する方法を理解することが重要です。

なお、キューとキュー内メッセージの管理には、Exchange ツールボックスのキュー ビューアーも使用できます。 ただし、Exchange 管理シェルのキューおよびメッセージ表示コマンドレットでは、キュー ビューアーよりもフィルター可能なプロパティとフィルター オプションがサポートされています。 キュー ビューアーの使用の詳細については、「キュー ビューアー」を参照してください。

また、キューはメールボックス サーバーとエッジ トランスポート サーバー (トランスポート サービス) に存在します。 キューとキュー内のメッセージの詳細については、「キューとキュー 内のメッセージ」を参照してください。

キュー フィルター処理パラメーター

次の表は、キュー管理コマンドレットで使用できるフィルター処理パラメーターをまとめたものです。

キュー ID

Identity パラメーターは、基本的な構文<サーバー キューを使用します>\ <>。 通常、この値はキューを一意に識別するため、 Identity パラメーターで他のフィルター処理パラメーターを使用することはできません。 例外は Get-Queue コマンドレットで、Identity パラメーターで Include パラメーターと Exclude パラメーターを使用できます。

次の表では、キュー管理コマンドレットの IDENTITY パラメーター構文について説明します。

キュー コマンドレットのフィルター パラメーター

すべてのキュー管理コマンドレットで Filter パラメーターを使用して、キューのプロパティに基づいて 1 つ以上のキューを識別できます。 Filter パラメーターは、比較演算子を使用して OPath フィルターを作成し、フィルター条件を満たすキューにコマンドを制限します。 論理演算子 -and を使用して、一致する複数の条件を指定できます。 構文の一般的な例を次に示します。

Get-Queue -Filter "<Property1> -<ComparisonOperator> '<Value1>' -and <Property2> -<ComparisonOperator> '<Value2>'..."

Filter パラメーターで使用できるキュー プロパティの完全な一覧については、「キューのプロパティ」を参照してください。

Filter パラメーターで使用できる比較演算子の一覧については、このトピックの「キューまたはメッセージをフィルター処理するときに使用する比較演算子」セクションを参照してください。

Filter パラメーターを使用してキューを表示および管理するプロシージャの例については、「キューのプロシージャ」を参照してください。

Get-Queueにパラメーターを含めるおよび除外する

Get-Queue コマンドレットの Include パラメーターと Exclude パラメーターは、それぞれ、または他のフィルター処理パラメーターと共に使用して、結果を微調整できます。 たとえば、次のようなことが可能です。

• 空のキューを除外します。

• 外部宛先へのキューを除外します。

• DeliveryType の特定の値を持つキューを含めます。

Include パラメーターと Exclude パラメーターは次のキュー プロパティを使用してキューをフィルター処理します。

Filter パラメーターを使用して、Include パラメーターと Exclude パラメーターの機能を複製できることに注意してください。 たとえば、次のコマンドは同じ結果を生成します。

• Get-Queue -Exclude Empty

• Get-Queue -Filter "MessageCount -gt 0"

ただし、ご覧のとおり、 Include パラメーターと Exclude パラメーターの構文は簡単で覚えやすくなります。

Get-QueueDigest

Get-QueueDigest コマンドレットを使用すると、1 つのコマンドを使用して、組織内のキューの一部または全部に関する情報を表示できます。 具体的には、 Get-QueueDigest コマンドレットは、サーバー、DAG、Active Directory サイト、または Active Directory フォレスト全体の場所に基づいて、キューに関する情報を表示できます。

サブスクライブされたエッジ トランスポート サーバー上のキューは結果に含まれないことに注意してください。 また、 Get-QueueDigest はエッジ トランスポート サーバーで使用できますが、結果はエッジ トランスポート サーバー上のローカル キューに制限されます。

次の表では、 Get-QueueDigest コマンドレットで使用できるフィルター処理と並べ替えパラメーターについて説明します。

次の使用例は、Mailbox01、Mailbox02、Mailbox03 という名前のサーバー上のすべての空でない外部キューを返します。

Get-QueueDigest -Server Mailbox01,Mailbox02,Mailbox03 -Include External -Exclude Empty

メッセージ フィルター処理パラメーター

次の表は、メッセージ管理コマンドレットで使用できるフィルター処理パラメーターをまとめたものです。

メッセージ ID

メッセージ管理コマンドレットの Identity パラメーターは、1 つ以上のキュー内のメッセージを一意に識別するため、他のメッセージ フィルター パラメーターを使用することはできません。 Identity パラメーターは、基本的な構文 を使用します<Server>\<Queue>\<MessageInteger>。

次の表では、メッセージ管理コマンドレットで Identity パラメーターで使用できる構文について説明します。

メッセージ コマンドレットのフィルター パラメーター

Filter パラメーターを Get-Message、Remove-Message、Resume-Message、Suspend-Message コマンドレットと共に使用すると、メッセージのプロパティに基づいて 1 つ以上のメッセージを識別できます。 Filter パラメーターは、比較演算子を使用して OPath フィルターを作成し、フィルター条件を満たすメッセージにコマンドを制限します。 論理演算子 -and を使用して、一致する複数の条件を指定できます。 構文の一般的な例を次に示します。

Get-Message -Filter "<Property1> -<ComparisonOperator> '<Value1>' -and <Property2> -<ComparisonOperator> '<Value2>'..."

Filter パラメーターで使用できるメッセージ プロパティの完全な一覧については、「メッセージ のプロパティ」を参照してください。

Filter パラメーターで使用できる比較演算子の一覧については、このトピックの「キューまたはメッセージをフィルター処理するときに使用する比較演算子」セクションを参照してください。

メッセージを表示および管理するために Filter パラメーターを使用するプロシージャの例については、「 キュー内のメッセージのプロシージャ」を参照してください。

キュー パラメーター

Queue パラメーターは、Get-Message コマンドレットでのみ使用できます。 このパラメーターを使用すると、ワイルドカード文字 (*) を使用して、特定のキュー内のすべてのメッセージ、または複数のキューからすべてのメッセージを取得できます。 Queue パラメーターを使用する場合は、このトピックの「キュー ID」セクションの説明に従って、キュー ID 形式<Server>\<Queue>を使用します。

キューまたはメッセージのフィルター処理に使用する比較演算子

Filter パラメーターを使用してキューまたはメッセージ フィルター式を作成するには、一致させるプロパティ値に対する比較演算子を含める必要があります。 使用できる比較演算子と、各演算子関数の説明を次の表に示します。 すべての演算子は、比較する値の大文字小文字を区別しません。

論理演算子 -andを使用して、複数の式を評価するフィルターを指定できます。 キューまたはメッセージは、結果に含まれるすべてのフィルター条件と一致する必要があります。

この例では、Contoso.com で終わる SMTP ドメイン名を送信先に持つキューと、現在 500 を超えるメッセージが存在するキューの一覧が表示されます。

Get-Queue -Filter "Identity -like '*contoso.com*' -and MessageCount -gt 500"

次の使用例は、SCL 値が 5 より大きい contoso.com ドメイン内の任意の電子メール アドレスから送信されるメッセージの一覧を表示します。

Get-Message -Filter "FromAddress -like '*Contoso.com*' -and SCL -gt 5"

高度なページ パラメーター

Exchange 管理シェルを使用してキュー内のキューとメッセージを表示すると、クエリは一度に 1 ページの情報を取得します。 詳細ページング パラメーターは、結果のサイズと結果の表示順序を制御します。 すべての高度なページング パラメーターは省略可能であり、 Get-Queue コマンドレットと Get-Message コマンドレットで他のフィルター 処理パラメーターの有無にかかわらず使用できます。 高度なページ パラメーターを指定しない場合、クエリは ID を昇順に並べて結果を返します。

既定では、並べ替え順序を指定すると、 Identity プロパティは常に含まれ、昇順で並べ替えられます。これは、他の使用可能なキューまたはメッセージ プロパティが一意ではないのでです。

BookmarkIndex パラメーターと BookmarkObject パラメーターを使用して、並べ替えられた結果の位置をマークできます。 結果の次のページを取得するときにブックマーク オブジェクトが存在しなくなった場合、結果はブックマークに最も近い項目から始まります。これは、指定した並べ替え順序によって異なります。

詳細なページング パラメーターについては、次の表を参照してください。

この例では、クエリで高度なページング パラメーターを使用する方法を示します。 コマンドは、指定されたサーバー上の最初の 500 個のメッセージを返します。 結果は、最初に送信者アドレスで昇順に並べ替え、次にメッセージ サイズで降順に並べ替えられます。

Get-Message -Server mailbox01.contoso.com -ResultSize 500 -SortOrder +FromAddress,-Size

次の使用例は、指定した並べ替え順序で指定したサーバー上の最初の 500 個のメッセージを返し、ブックマーク オブジェクトを設定し、結果からブックマーク オブジェクトを除外し、次の 500 個のメッセージを同じ並べ替え順序で取得します。

1. 次のコマンドを実行して、結果の最初のページを取得します。

   $Results=Get-Message -Server mailbox01.contoso.com -ResultSize 500 -SortOrder +FromAddress,-Size
   

2. ブックマーク オブジェクトを設定するには、次のコマンドを実行して、最初のページの最後の要素を変数に保存します。

   $Temp=$Results[$results.length-1]
   

3. 指定したサーバー上の次の 500 個のオブジェクトを取得し、ブックマーク オブジェクトを除外するには、次のコマンドを実行します。

   Get-Message -Server mailbox01.contoso.com -BookmarkObject:$Temp -IncludeBookmark $false -ResultSize 500 -SortOrder +FromAddress,-Size