Delete-QuarantineMessage
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
Delete-QuarantineMessage コマンドレットを使用して、クラウドベースのorganizationから検疫メッセージを削除する
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Identities
Delete-QuarantineMessage
-Identities <QuarantineMessageIdentity[]>
[-Identity <QuarantineMessageIdentity>]
[-Confirm]
[-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
[-HardDelete]
[-RecipientAddress <String[]>]
[-WhatIf]
[<CommonParameters>]
IdentityOnly
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
適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットに与える影響は、コマンドレットが続行する前に確認を必要とするかどうかによって異なります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値を指定せずに Confirm スイッチを指定すると、一時停止が発生し、続行する前にコマンドの確認を強制されます。
このコマンドレットには一時停止が組み込まれているため、 -Confirm:$false を使用して確認をスキップします。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | Cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-EntityType
適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン
EntityType パラメーターは、EntityType で結果をフィルター処理します。 有効な値は次のとおりです。
- 電子メール
- SharePointOnline
- Teams (現在プレビュー段階)
- DataLossPrevention
パラメーターのプロパティ
| 型: | Microsoft.Exchange.Management.FfoQuarantine.EntityType |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-HardDelete
適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン
HardDelete スイッチは、メッセージを完全に削除し、回復不可能であることを指定します。 このスイッチで値を指定する必要はありません。
このスイッチを使用しない場合、メッセージは削除されますが、回復できる可能性があります。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identities
適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン
Identities パラメーターは、一括操作のために検疫されたメッセージを識別します。 次の構文を使用してメッセージを識別します。 value1,value2...valueN。 各値は、 GUID1\GUID2 形式 ( c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7 など) の一意の検疫されたメッセージ識別子です。
Get-QuarantineMessage コマンドレットを使用して、検疫済みメッセージの Identity の値を検索することができます。
このパラメーターを使用する場合、Identity パラメーターは必須ですが、値は無視されます。 たとえば、Identity パラメーターに値 000 を使用します。
パラメーターのプロパティ
| 型: | QuarantineMessageIdentity[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Identities
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン
Identity パラメーターには、削除する検疫済みメッセージを指定します。 値は、 GUID1\GUID2 形式 ( c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7 など) の一意の検疫されたメッセージ識別子です。
Get-QuarantineMessage コマンドレットを使用して、検疫済みメッセージの Identity の値を検索することができます。
パラメーターのプロパティ
| 型: | QuarantineMessageIdentity |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Identities
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
IdentityOnly
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-RecipientAddress
適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン
RecipientAddress パラメーターは、受信者の電子メール アドレスで結果をフィルター処理します。 複数の値をコンマで区切って指定できます。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | wi |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。