Delete-QuarantineMessage

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Exchange Online, Security & Compliance, Exchange Online Protection

このコマンドレットは、クラウドベースのサービスでのみ使用できます。

Delete-QuarantineMessage コマンドレットを使用して、クラウドベースのorganizationから検疫メッセージを削除する

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

構文

Delete-QuarantineMessage
      -Identities <QuarantineMessageIdentity[]>
      [-Identity <QuarantineMessageIdentity>]
      [-Confirm]
      [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
      [-HardDelete]
      [-RecipientAddress <String[]>]
      [-WhatIf]
      [<CommonParameters>]

Delete-QuarantineMessage
      -Identity <QuarantineMessageIdentity>
      [-Confirm]
      [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
      [-HardDelete]
      [-RecipientAddress <String[]>]
      [-WhatIf]
      [<CommonParameters>]

説明

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

例

例 1

Delete-QuarantineMessage -Identity c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7

次の使用例は、指定した ID 値を持つ検疫済みメッセージを削除します。

例 2

$ids = Get-QuarantineMessage | select -ExpandProperty Identity

Delete-QuarantineMessage -Identity $ids[4]

次の使用例は、Get-QuarantineMessage の結果の一覧で 5 番目に検疫されたメッセージを削除します。最初のメッセージのインデックス番号は 0、2 番目のメッセージのインデックス番号は 1 などです。

例 3

$ids = Get-QuarantineMessage | select -ExpandProperty Identity

Delete-QuarantineMessage -Identities $ids -Identity 000

次の使用例は、検疫されたすべてのメッセージを削除します。 Identity パラメーターは必須ですが、値 000 は無視されます。

パラメーター

-Confirm

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。

破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-EntityType

EntityType パラメーターは、EntityType によって結果をフィルター処理します。有効な値は次のとおりです。

電子メール
SharePointOnline
Teams (現在プレビュー段階)

Type:	Microsoft.Exchange.Management.FfoQuarantine.EntityType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-HardDelete

HardDelete スイッチは、メッセージが完全に削除され、回復不可能であることを指定します。このスイッチで値を指定する必要はありません。

このスイッチを使用しない場合、メッセージは削除されますが、回復可能な可能性があります。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-Identities

Id パラメーターは、一括操作の検疫されたメッセージを識別します。メッセージを識別するには、構文 value1,value2...valueNを使用します。各値は、形式 GUID1\GUID2 (など c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7) の一意の検疫されたメッセージ識別子です。

Get-QuarantineMessage コマンドレットを使用して、検疫済みメッセージの Identity の値を検索することができます。

このパラメーターを使用する場合は、Identity パラメーターが必要ですが、値は無視されます。たとえば、Identity パラメーターには値 000 を使用します。

Type:	QuarantineMessageIdentity[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-Identity

Identity パラメーターは、削除する検疫済みメッセージを指定します。値は、形式 GUID1\GUID2 (など c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7) の一意の検疫済みメッセージ識別子です。

Get-QuarantineMessage コマンドレットを使用して、検疫済みメッセージの Identity の値を検索することができます。

Type:	QuarantineMessageIdentity
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-RecipientAddress

RecipientAddress パラメーターは、受信者の電子メールアドレスで結果をフィルター処理します。複数の値をコンマで区切って指定できます。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-WhatIf

WhatIf スイッチは、コマンドの操作をシミュレートします。このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。このスイッチで値を指定する必要はありません。

WhatIf スイッチは、セキュリティ & コンプライアンス PowerShell では機能しません。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection