Delete-QuarantineMessage
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
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 |