Remove-Message (RTM)
適用先: Exchange Server 2007
トピックの最終更新日: 2007-06-08
Remove-Message コマンドレットを使用して、ハブ トランスポート サーバーの役割またはエッジ トランスポート サーバーの役割がインストールされているコンピュータでキューからメッセージを削除します。
構文
Remove-Message -Identity <MessageIdentity> [-WithNDR <$true | $false>]
Remove-Message -Filter <String> [-Server <ServerIdParameter>] [-WithNDR <$true | $false>]
解説
Remove-Message コマンドレットは、ハブ トランスポート サーバーまたはエッジ トランスポート サーバー上のキュー内に存在する 1 つ以上のメッセージを削除します。複数の受信者に送信されるメッセージは、複数のキューに存在する可能性があります。Identity パラメータを指定すると、その ID が 1 つのメッセージのみに一致した場合、メッセージが 1 つのキューから削除されます。その ID が複数のメッセージに一致した場合は、エラーが返されます。1 回の操作で複数のキューからメッセージを削除するには、フィルタを使用する必要があります。現在配信されているメッセージを削除しようとすると、メッセージの状態が "削除保留" に変わります。メッセージの配信は中断されませんが、その配信が失敗してメッセージが再度キューに置かれた場合、そのメッセージは削除されます。
Identity パラメータまたは Filter パラメータを使用する必要があります。この 2 つのパラメータ セットを同時に使用することはできません。
Remove-Message コマンドレットを実行するには、使用するアカウントに Exchange サーバー管理者の役割、および対象サーバーのローカルの Administrators グループが委任されている必要があります。
エッジ トランスポート サーバーの役割がインストールされているコンピュータで Remove-Message コマンドレットを実行するには、そのコンピュータのローカルの Administrators グループのメンバであるアカウントを使用してログオンする必要があります。
アクセス許可、役割の委任、および Microsoft Exchange Server 2007 を管理するために必要な権限の詳細については、「アクセス許可に関する考慮事項」を参照してください。
パラメータ
パラメータ | 必須 | 種類 | 説明 |
---|---|---|---|
Filter |
必須 |
System.String |
Filter パラメータには、削除するメッセージのプロパティ値の条件を指定する式が必要です。この式では、プロパティ名の後に比較演算子と値を指定します。次のメッセージ プロパティは、Filter パラメータの有効な条件です。
-and の比較演算子を使用して、複数のフィルタ条件を指定できます。1 つの整数として表されないプロパティ値は、引用符で囲む必要があります。 |
Identity |
必須 |
Microsoft.Exchange.Data.QueueViewer.MessageIdentity |
特定のメッセージと省略可能なサーバーおよびキュー ID を表す MessageIdentity 整数を指定するには、Identity パラメータを使用します。このパラメータの構文は以下のとおりです。
|
Server |
省略可能 |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
リモート プロシージャ コール (RPC) を使用して接続する、削除対象のメッセージを保持するキューを含むサーバーの名前を指定するには、Server パラメータを使用します。ホスト名または完全修飾ドメイン名 (FQDN) として、Server パラメータを入力します。このパラメータを使用しなかった場合は、ローカル サーバーにクエリが送信されます。 |
WithNDR |
省略可能 |
System.Boolean |
メッセージの送信者に配信不能レポート (NDR) を返すかどうかを指定するには、WithNDR パラメータを使用します。このパラメータは既定では、 |
入力の種類
戻り値の種類
エラー
エラー | 説明 |
---|---|
例外
例外 | 説明 |
---|---|
例
次の例は、以下の条件に該当するすべてのメッセージを削除する方法を示しています。
- メッセージが、指定した送信者の SMTP アドレスから送信されている。
- メッセージが、コマンドが実行されるハブ トランスポート サーバーまたはエッジ トランスポート サーバー上のキューに格納されている。
次の例は、NDR を無効にする方法も示しています。
Exchange 管理シェルを使用してキュー ビューアのタスクを実行する方法の詳細については、「Exchange 管理シェルを使用したキューの管理」を参照してください。
Remove-Message -Filter {FromAddress -eq "sender@contoso.com"} -withNDR $false
参照している情報が最新であることを確認したり、他の Exchange Server 2007 ドキュメントを見つけたりするには、Exchange Server TechCenter を参照してください。