Release-QuarantineMessage
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
Release-QuarantineMessage コマンドレットは、クラウドベースの組織内の検疫からメッセージをリリースする場合に使用します。 すべての元の受信者、または特定の受信者にメッセージをリリースできます。
SharePoint、OneDrive、Microsoft Teams の安全な添付ファイルによって検疫されたファイルの場合は、ユーザーがファイルにアクセス、共有、ダウンロードできるように、Release-QuarantineMessage コマンドレットを使用して、それぞれのチーム サイトとドキュメント ライブラリ内のファイルのブロックを解除できます。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Release-QuarantineMessage
-User <String[]>
[-Identities <QuarantineMessageIdentity[]>]
[-Identity <QuarantineMessageIdentity>]
[-AllowSender]
[-Confirm]
[-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
[-Force]
[-ReportFalsePositive]
[-WhatIf]
[<CommonParameters>] Release-QuarantineMessage
[-Identities <QuarantineMessageIdentity[]>]
[-Identity <QuarantineMessageIdentity>]
[-ReleaseToAll]
[-AllowSender]
[-Confirm]
[-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
[-Force]
[-ReportFalsePositive]
[-WhatIf]
[<CommonParameters>] Release-QuarantineMessage
-Identities <QuarantineMessageIdentity[]>
[-Identity <QuarantineMessageIdentity>]
[-ActionType <ReleaseActionType>]
[-AllowSender]
[-Confirm]
[-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
[-Force]
[-ReportFalsePositive]
[-WhatIf]
[<CommonParameters>] Release-QuarantineMessage
-Identity <QuarantineMessageIdentity>
[-AllowSender]
[-Confirm]
[-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
[-Force]
[-ReportFalsePositive]
[-WhatIf]
[<CommonParameters>] 説明
次のシナリオを考えてみましょう。 john@gmail.com と john@subsidiary.contoso.comにメッセージをfaith@contoso.com送信します。 Gmail では、このメッセージが 2 つのコピーに分割され、どちらも Microsoft のフィッシングとして検疫にルーティングされます。 管理者は、これらのメッセージの両方を にリリースします admin@contoso.com。 管理者メールボックスに到達する最初のリリースされたメッセージが配信されます。 2 番目にリリースされたメッセージは重複配信として識別され、スキップされます。 メッセージが同じメッセージ ID を持ち、受信時刻が同じ場合、メッセージは重複として識別されます。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Get-QuarantineMessage -MessageID "<5c695d7e-6642-4681-a4b0-9e7a86613cb7@contoso.com>" | Release-QuarantineMessage -User julia@contoso.comこの例では、Get-QuarantineMessage コマンドレットを使用して、メッセージ ID 値 <5c695d7e-6642-4681-a4b0-9e7a86613cb7@contoso.com> を持つ検疫済みメッセージを元の受信者に解放します julia@contoso.com。
例 2
Release-QuarantineMessage -Identity c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7 -ReleaseToAllこの例では、指定された Identity の値を持つ検疫済みメッセージを元の受信者すべてにリリースします。
例 3
Get-QuarantineMessage | Release-QuarantineMessage -ReleaseToAllこの例では、すべてのメッセージを元のすべての受信者に解放します。
例 4
$q = Get-QuarantineMessage -QuarantineTypes SPOMalware
$q[-1] | Release-QuarantineMessage -ReleaseToAllこの例では、SharePoint、OneDrive、および Microsoft Teams の安全な添付ファイルの一部として検疫されたファイルをリリースします。 最初のコマンドは、検疫されたすべてのファイルを変数$qに格納します。 2 番目のコマンドは、リスト内の最後のファイルを解放します。 配列内の要素とインデックス番号の詳細については、「 配列要素へのアクセスと使用」を参照してください。
パラメーター
-ActionType
ActionType パラメーターは、リリース アクションの種類を指定します。 有効な値は次のとおりです。
- 承認する
- 拒否
- リリース
- 要求
| Type: | ReleaseActionType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Security & Compliance, Exchange Online Protection |
-AllowSender
AllowSender スイッチは、今後、送信者からのすべてのメッセージを検疫しないことを指定します。 このスイッチに値を指定する必要はありません。
トランスポート ルールまたはブロックされている送信者が原因でこのメッセージが検疫された場合、今後も、この送信者からのメッセージをブロックすることができます。
| 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 |
-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 |
-Force
[強制] スイッチは、警告メッセージまたは確認メッセージを非表示にします。 このスイッチで値を指定する必要はありません。
以前にリリースされたメッセージを検疫から解放しようとするたびに、このスイッチを使用します。
| 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) の一意の検疫済みメッセージ識別子です。
検疫されたメッセージの ID 値は、Get-QuarantineMessage コマンドレットを使用して確認できます。
このパラメーターを使用する場合は、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, Security & Compliance, Exchange Online Protection |
-ReleaseToAll
ReleaseToAll スイッチは、元の受信者すべてに検疫済みメッセージをリリースします。 このスイッチで値を指定する必要はありません。
このスイッチは、検疫の種類 SPOMalware に必要です。
以前に User パラメーターまたは ReleaseToAll スイッチを使用して、検疫されたメッセージを元の受信者の一部または全部にリリースした場合、ReleaseToAll スイッチをもう一度使用すると、それらの受信者はスキップされます。
同じコマンドで、ReleaseToAll スイッチと User パラメーターを使用することはできません。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Security & Compliance, Exchange Online Protection |
-ReportFalsePositive
ReportFalsePositive スイッチは、メッセージを Microsoft に誤検知として報告するかどうかを指定します (不適切とマークされた適切なメッセージ)。 このスイッチで値を指定する必要はありません。
このスイッチは、検疫されたスパム メッセージに対してのみ使用できます。
| 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 |
-User
User パラメーターは、検疫済みメッセージをリリースするユーザーの電子メール アドレスを指定します。 複数のメール アドレスをコンマで区切って指定できます。
このパラメーターを使用して、元のメッセージの受信者、またはorganization内の他の電子メール アドレスにメッセージを解放できます。
以前に ReleaseToAll スイッチを使用して検疫済みメッセージを元の受信者のすべてに解放しており、後で User パラメーターを使用してメッセージを再び解放すると、User パラメーターで指定した元の受信者はスキップされます。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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 |
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示