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