Remove-Message

  • [アーティクル]

 

適用先: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

トピックの最終更新日: 2007-06-28

Remove-Message コマンドレットを使用して、ハブ トランスポート サーバーの役割またはエッジ トランスポート サーバーの役割がインストールされているコンピュータでキューからメッセージを削除します。

構文

Remove-Message -Identity <MessageIdentity> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [-WithNDR <$true | $false>]

Remove-Message -Filter <String> [-Confirm [<SwitchParameter>]] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]] [-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 パラメータの有効な条件です。

  • DateReceived   メッセージを受信した日付です。
  • ExpirationTime   メッセージの有効期限が切れる時刻です。
  • FromAddress   メッセージ送信者の SMTP (簡易メール転送プロトコル) アドレスです。この値は、メッセージ エンベロープの MAIL FROM: から取得されます。
  • Identity   特定のメッセージと省略可能なサーバーおよびキュー ID を表す整数です。
  • InternetMessageId   Message-ID: ヘッダー フィールドの値です。このプロパティは、次の例のように、GUID の後に送信側サーバーの SMTP アドレスが付加された形式で表されます。67D7543D6103DC4FBEBA6BC7205DACABA61231@exchange.contoso.com
  • LastError   メッセージに対して記録された最新のエラーを示す文字列です。
  • MessageSourceName   このメッセージをキューに送信したコンポーネントの名前を示す文字列です。
  • Queue   メッセージを保持するキューの ID を指定します。Server\destination という形式でキュー ID を入力します。ここで destination は、リモート ドメイン、メールボックス サーバー、または永続キューの名前です。
  • RetryCount   送信先へのメッセージ配信が試行された回数です。
  • SCL   SCL プロパティは、メッセージの SCL (Spam Confidence Level) を指定します。有効な SCL の値は、0 ～ 9 の範囲の整数です。SCL プロパティの値が空白の場合、メッセージがコンテンツ フィルタ エージェントで処理されていないことを意味します。
  • Size   メッセージのサイズです。
  • SourceIP   Exchange 組織にメッセージを送信した外部サーバーの IP アドレスです。
  • Status   現在のメッセージの状態です。メッセージの状態のオプションには、アクティブ、再試行、中断、中断保留、および PendingRemove があります。
  • Subject   電子メールの件名を表す文字列です。この値は、Subject: ヘッダー フィールドから取得されます。

-and の比較演算子を使用して、複数のフィルタ条件を指定できます。1 つの整数として表されないプロパティ値は、引用符で囲む必要があります。

Identity

必須

Microsoft.Exchange.Data.QueueViewer.MessageIdentity

特定のメッセージと省略可能なサーバーおよびキュー ID を表す MessageIdentity 整数を指定するには、Identity パラメータを使用します。このパラメータの構文は以下のとおりです。

  • Server\QueueIdentity\MessageIdentity
  • QueueIdentity\MessageIdentity
  • Server\*\MessageIdentity
  • MessageIdentity

Confirm

省略可能

System.Management.Automation.SwitchParameter

Confirm パラメータを指定すると、コマンドの処理が一時停止します。処理を続行するためには、コマンドの処理内容を確認する必要があります。Confirm パラメータに値を指定する必要はありません。

Server

省略可能

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

リモート プロシージャ コール (RPC) を使用して接続する、削除対象のメッセージを保持するキューを含むサーバーの名前を指定するには、Server パラメータを使用します。ホスト名または完全修飾ドメイン名 (FQDN) として、Server パラメータを入力します。このパラメータを使用しなかった場合は、ローカル サーバーにクエリが送信されます。

WhatIf

省略可能

System.Management.Automation.SwitchParameter

WhatIf パラメータには、オブジェクトに対して行われる操作をシミュレートすることを指定します。WhatIf パラメータを使用することで、実際に変更を加えずに、発生する変更内容を表示することができます。WhatIf パラメータに値を指定する必要はありません。

WithNDR

省略可能

System.Boolean

メッセージの送信者に配信不能レポート (NDR) を返すかどうかを指定するには、WithNDR パラメータを使用します。このパラメータは既定では、$true に設定されます。このパラメータは、Identity パラメータ セットおよび Filter パラメータ セットの両方と組み合わせて使用できます。

入力の種類

戻り値の種類

エラー

エラー 説明

例外

例外 説明

例

次の例は、以下の条件に該当するすべてのメッセージを削除する方法を示しています。

  • メッセージが、指定した送信者の SMTP アドレスから送信されている。
  • メッセージが、コマンドが実行されるハブ トランスポート サーバーまたはエッジ トランスポート サーバー上のキューに格納されている。

次の例は、NDR を無効にする方法も示しています。

Exchange 管理シェルを使用してキュー ビューアのタスクを実行する方法の詳細については、「Exchange 管理シェルを使用したキューの管理」を参照してください。

Remove-Message -Filter {FromAddress -eq "sender@contoso.com"} -withNDR $false

参照している情報が最新であることを確認したり、他の Exchange Server 2007 ドキュメントを見つけたりするには、Exchange Server TechCenter を参照してください。