Release-QuarantineMessage
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
Release-QuarantineMessage コマンドレットは、クラウドベースの組織内の検疫からメッセージをリリースする場合に使用します。 元の受信者全員、または特定の受信者にメッセージを解放することができます。
SharePoint、OneDrive、Microsoft Teams の安全な添付ファイルによって検疫されたファイルの場合、Release-QuarantineMessage コマンドレットを使用してそれぞれのチーム サイトとドキュメント ライブラリ内のファイルのブロックを解除して、ユーザーがファイルにアクセスし、共有し、ダウンロードできるようにすることができます。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
OrgReleaseToUser
Release-QuarantineMessage
-User <String[]>
[-Identities <QuarantineMessageIdentity[]>]
[-Identity <QuarantineMessageIdentity>]
[-AllowSender]
[-Confirm]
[-Force]
[-ReportFalsePositive]
[-WhatIf]
[<CommonParameters>]
OrgReleaseToAll
Release-QuarantineMessage
[-Identities <QuarantineMessageIdentity[]>]
[-Identity <QuarantineMessageIdentity>]
[-ReleaseToAll]
[-AllowSender]
[-Confirm]
[-Force]
[-ReportFalsePositive]
[-WhatIf]
[<CommonParameters>]
Identities
Release-QuarantineMessage
-Identities <QuarantineMessageIdentity[]>
[-Identity <QuarantineMessageIdentity>]
[-ActionType <ReleaseActionType>]
[-AllowSender]
[-Confirm]
[-Force]
[-ReportFalsePositive]
[-WhatIf]
[<CommonParameters>]
IdentityOnly
Release-QuarantineMessage
-Identity <QuarantineMessageIdentity>
[-AllowSender]
[-Confirm]
[-Force]
[-ReportFalsePositive]
[-WhatIf]
[<CommonParameters>]
説明
次のシナリオを考えてみましょう。 john@gmail.com が faith@contoso.com と john@subsidiary.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 コマンドレットを使用して、元の受信者julia@contoso.comに Message-ID 値<5c695d7e-6642-4681-a4b0-9e7a86613cb7@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
適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン
ActionType パラメーターには、リリース アクションの種類を指定します。 有効な値は次のとおりです。
- 拒否
- リリース: メッセージを解放するか、メッセージの解放要求を承認するには、この値を使用します。
- 要求
パラメーターのプロパティ
| 型: | ReleaseActionType |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-AllowSender
適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン
AllowSender スイッチは、送信者からの今後のすべてのメッセージが検疫されないことを指定します。 このスイッチで値を指定する必要はありません。
トランスポート ルールまたはブロックされている送信者が原因でこのメッセージが検疫された場合、今後も、この送信者からのメッセージをブロックすることができます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットに与える影響は、コマンドレットが続行する前に確認を必要とするかどうかによって異なります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値を指定せずに Confirm スイッチを指定すると、一時停止が発生し、続行する前にコマンドの確認を強制されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | Cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Force
適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン
[強制] スイッチは、警告または確認メッセージを非表示にします。 このスイッチで値を指定する必要はありません。
以前に解放されたメッセージを検疫から再解放しようとするときは、必ずこのスイッチを使用します。
パラメーターのプロパティ
| 型: | 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 コマンドレットを使用すると、検疫されたメッセージの ID 値を見つけることができます。
このパラメーターを使用する場合、Identity パラメーターは必須ですが、値は無視されます。 たとえば、Identity パラメーターに値 000 を使用します。
パラメーターのプロパティ
| 型: | QuarantineMessageIdentity[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Identities
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
OrgReleaseToAll
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
OrgReleaseToUser
| 配置: | 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 |
OrgReleaseToAll
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
OrgReleaseToUser
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
IdentityOnly
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-ReleaseToAll
適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン
ReleaseToAll スイッチは、元の受信者すべてに検疫済みメッセージをリリースします。 このスイッチで値を指定する必要はありません。
このスイッチは、検疫の種類 SPOMalware に必要です。
以前に User パラメータまたは ReleaseToAll スイッチを使用して、元の受信者の一部またはすべてに対して検疫されたメッセージを解放した場合、ReleaseToAll スイッチを再度使用すると、それらの受信者はスキップされます。
同じコマンドで、ReleaseToAll スイッチと User パラメーターを使用することはできません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
OrgReleaseToAll
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ReportFalsePositive
適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン
ReportFalsePositive スイッチは、メッセージを誤検知 (良いメッセージが悪いとマークされたメッセージ) として Microsoft に報告するかどうかを指定します。 このスイッチで値を指定する必要はありません。
このスイッチは、検疫されたスパム メッセージに対してのみ使用できます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-User
適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン
User パラメーターは、検疫済みメッセージをリリースするユーザーの電子メール アドレスを指定します。 複数のメール アドレスをコンマで区切って指定できます。
このパラメータを使用して、元のメッセージの受信者、または organization 内の他の電子メール アドレスにメッセージを解放できます。
以前に ReleaseToAll スイッチを使用して検疫済みメッセージを元の受信者のすべてに解放しており、後で User パラメーターを使用してメッセージを再び解放すると、User パラメーターで指定した元の受信者はスキップされます。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
OrgReleaseToUser
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
WhatIf スイッチは、セキュリティ/コンプライアンス PowerShell では機能しません。
[WhatIf] スイッチは、何も変更を加えずにコマンドが実行する内容を表示します。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | 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」を参照してください。
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。