Set-QuarantinePermissions
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
注: このコマンドレットを使用して検疫ポリシーのアクセス許可を設定する代わりに、New-QuarantinePolicy コマンドレットと Set-QuarantinePolicy コマンドレットで EndUserQuarantinePermissionsValue パラメーターを使用することをお勧めします。
Set-QuarantinePermissions コマンドレットを使用して、New-QuarantinePermissions によって作成され、現在の PowerShell セッションに変数として格納された検疫アクセス許可オブジェクトを変更します。 変数は、同じ PowerShell セッション内の New-QuarantinePolicy または Set-QuarantinePolicy コマンドレットの EndUserQuarantinePermission パラメーターの値として使用します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
Set-QuarantinePermissions
-QuarantinePermissionsObject <QuarantinePermissions>
[[-PermissionToAllowSender] <Boolean>]
[[-PermissionToBlockSender] <Boolean>]
[[-PermissionToDelete] <Boolean>]
[[-PermissionToDownload] <Boolean>]
[[-PermissionToPreview] <Boolean>]
[[-PermissionToRelease] <Boolean>]
[[-PermissionToRequestRelease] <Boolean>]
[[-PermissionToViewHeader] <Boolean>]
[<CommonParameters>]
説明
変更する permissions オブジェクトの現在の値を確認するには、変数名をコマンドとして実行します。 たとえば、コマンド $Perms を実行して、 $Perms 変数に格納されている検疫ポリシーのアクセス許可を確認します。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事ではコマンドレットのすべてのパラメーターを一覧表示しますが、割り当てられたアクセス許可にパラメーターが含まれていない場合は、一部のパラメーターにアクセスできない可能性があります。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Set-QuarantinePermissions -QuarantinePermissionsObject $Perms -PermissionToRequestRelease $true -PermissionToRelease $false
次の使用例は、同じ PowerShell セッションで New-QuarantinePermissions コマンドレットを使用して以前に作成された、終了する $Perms 変数の検疫ポリシーのアクセス許可を変更します ( $Perms 変数は引き続き使用でき、設定されています)。
同じ PowerShell セッションでは、New-QuarantinePolicy または Set-QuarantinePolicy コマンドで EndUserQuarantinePermissions パラメーター値に$Permsを使用できます。
パラメーター
-PermissionToAllowSender
適用対象: Exchange Online、Exchange Online Protection
PermissionToBlockSender パラメーターは、検疫されたメッセージ送信者を差出人セーフ リストに追加できるかどうかを指定します。 有効な値は次のとおりです。
- $true: [送信者を許可する] は、検疫で影響を受けるメッセージに対して使用できます。
- $false: 検疫中の影響を受けるメッセージに送信者を許可することはできません。 この値が既定値です。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PermissionToBlockSender
適用対象: Exchange Online、Exchange Online Protection
PermissionToBlockSender パラメーターは、検疫されたメッセージ送信者をブロックされた送信者の一覧にユーザーが追加できるかどうかを指定します。 有効な値は次のとおりです。
- $true: [送信者のブロック] は、影響を受けるメッセージの検疫通知で使用でき、検疫で影響を受けるメッセージに対して [送信者のブロック] を使用できます。
- $false: 影響を受けるメッセージの検疫通知では送信者のブロックを使用できません。また、検疫中の影響を受けるメッセージに対して送信者をブロックすることはできません。 この値が既定値です。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 2 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PermissionToDelete
適用対象: Exchange Online、Exchange Online Protection
PermissionToDelete パラメーターは、ユーザーが検疫からメッセージを削除できるかどうかを指定します。 有効な値は次のとおりです。
- $true: [メッセージの削除] と [検疫からの削除] は、検疫で影響を受けるメッセージに対して使用できます。
- $false: [メッセージの削除] と [検疫から削除] は、検疫内の影響を受けるメッセージには使用できません。 この値が既定値です。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 3 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PermissionToDownload
適用対象: Exchange Online、Exchange Online Protection
PermissionToDownload パラメーターは、ユーザーが検疫からメッセージをダウンロードできるかどうかを指定します。 有効な値は次のとおりです。
- $true: アクセス許可が有効になっています。
- $false: アクセス許可が無効になっています。 この値が既定値です。
現時点では、この値は、影響を受けるメッセージの検疫通知または検疫で使用できるアクションには影響しません。 エンド ユーザーは検疫されたメッセージをダウンロードできません。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 4 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PermissionToPreview
適用対象: Exchange Online、Exchange Online Protection
PermissionToPreview パラメーターは、ユーザーが検疫されたメッセージをプレビューできるかどうかを指定します。 有効な値は次のとおりです。
- $true: プレビュー メッセージは、検疫中の影響を受けるメッセージに対して使用できます。
- $false: プレビュー メッセージは、検疫中の影響を受けるメッセージには使用できません。 この値が既定値です。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 5 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PermissionToRelease
適用対象: Exchange Online、Exchange Online Protection
PermissionToRelease パラメーターは、影響を受けるメッセージを検疫からユーザーが直接解放できるかどうかを指定します。 有効な値は次のとおりです。
- $true: リリースは、影響を受けるメッセージの検疫通知で使用でき、検疫の影響を受けるメッセージに対してリリース (リリース電子メール) を使用できます。
- $false: 影響を受けるメッセージの検疫通知ではリリース メッセージを使用できません。また、検疫中の影響を受けるメッセージに対してリリースとリリースの電子メールを使用することはできません。
このパラメーターと PermissionToRequestRelease パラメーターを$trueに設定しないでください。 1 つのパラメーターを $true に設定し、もう 1 つを $falseに設定するか、両方のパラメーターを $false に設定します。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 6 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PermissionToRequestRelease
適用対象: Exchange Online、Exchange Online Protection
PermissionToRequestRelease パラメーターは、ユーザーが検疫から解放されるメッセージを要求できるかどうかを指定します。 要求は管理者によって承認される必要があります。有効な値は次のとおりです。
- $true: 要求リリースは、影響を受けるメッセージの検疫通知で使用でき、検疫の影響を受けるメッセージに対して要求リリースを使用できます。
- $false: 要求リリースは、影響を受けるメッセージの検疫通知では使用できません。また、検疫中の影響を受けるメッセージに対してリリースを要求することはできません。
このパラメーターと PermissionRelease パラメーターを$trueに設定しないでください。 1 つのパラメーターを $true に設定し、もう 1 つを $falseに設定するか、両方のパラメーターを $false に設定します。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 7 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PermissionToViewHeader
適用対象: Exchange Online、Exchange Online Protection
PermissionToViewHeader パラメーターは、ユーザーが検疫されたメッセージのメッセージ ヘッダーを表示できるかどうかを指定します。 有効な値は次のとおりです。
- $true: アクセス許可が有効になっています。
- $false: アクセス許可が無効になっています。 この値が既定値です。
現時点では、この値は、影響を受けるメッセージの検疫通知または検疫で使用できるアクションには影響しません。 メッセージ ヘッダーの表示は、検疫で影響を受けるメッセージに対して常に使用できます。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 8 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-QuarantinePermissionsObject
適用対象: Exchange Online、Exchange Online Protection
QuarantinePermissionsObject パラメーターは、変更する検疫アクセス許可を含む既存の変数を指定します。 たとえば、以前にコマンド $Perms = New-QuarantinePermissions <permissions>を実行した場合は、このパラメーターに $Perms 値を使用します。
パラメーターのプロパティ
| 型: | QuarantinePermissions |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 9 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。