Set-QuarantinePermissions
此 cmdlet 仅在基于云的服务中可用。
注意:建议对 New-QuarantinePolicy 和 Set-QuarantinePolicy cmdlet 使用 EndUserQuarantinePermissionsValue 参数,而不是使用此 cmdlet 设置隔离策略权限。
使用 Set-QuarantinePermissions cmdlet 修改 New-QuarantinePermissions 创建并作为变量存储在当前 PowerShell 会话中的隔离权限对象。 将 变量用作同一 PowerShell 会话中的 New-QuarantinePolicy 或 Set-QuarantinePolicy cmdlet 上的 EndUserQuarantinePermission 参数的值。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Default (默认值)
Set-QuarantinePermissions
-QuarantinePermissionsObject <QuarantinePermissions>
[[-PermissionToAllowSender] <Boolean>]
[[-PermissionToBlockSender] <Boolean>]
[[-PermissionToDelete] <Boolean>]
[[-PermissionToDownload] <Boolean>]
[[-PermissionToPreview] <Boolean>]
[[-PermissionToRelease] <Boolean>]
[[-PermissionToRequestRelease] <Boolean>]
[[-PermissionToViewHeader] <Boolean>]
[<CommonParameters>]
说明
若要查看要修改的权限对象的当前值,请将变量名称作为命令运行。 例如,运行 命令 $Perms 以查看变量中 $Perms 存储的隔离策略权限。
您必须先获得权限,然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数,但如果某些参数未包含在分配给你的权限中,则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Set-QuarantinePermissions -QuarantinePermissionsObject $Perms -PermissionToRequestRelease $true -PermissionToRelease $false
此示例修改以前在同一 PowerShell 会话中使用 New-QuarantinePermissions cmdlet 创建的退出 $Perms 变量中的隔离策略权限, (该 $Perms 变量仍然可用并填充) 。
在同一 PowerShell 会话中,可以在 $Perms New-QuarantinePolicy 或 Set-QuarantinePolicy 命令中使用 EndUserQuarantinePermissions 参数值。
参数
-PermissionToAllowSender
适用:Exchange Online、Exchange Online Protection
PermissionToBlockSender 参数指定是否允许用户将隔离的邮件发件人添加到其安全发件人列表。 有效值包含:
- $true:允许发件人可用于隔离区中受影响的邮件。
- $false:允许发件人不适用于隔离区中受影响的邮件。 此值为默认值。
参数属性
| 类型: | Boolean |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 1 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-PermissionToBlockSender
适用:Exchange Online、Exchange Online Protection
PermissionToBlockSender 参数指定是否允许用户将隔离的邮件发件人添加到其阻止发件人列表。 有效值包含:
- $true:阻止发件人在受影响邮件的隔离通知中可用,阻止发件人可用于隔离区中受影响的邮件。
- $false:阻止发件人在受影响邮件的隔离通知中不可用,并且阻止发件人不适用于隔离区中受影响的邮件。 此值为默认值。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 2 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-PermissionToDelete
适用:Exchange Online、Exchange Online Protection
PermissionToDelete 参数指定是否允许用户从隔离区中删除邮件。 有效值包含:
- $true:“删除邮件”和“从隔离区中删除”可用于隔离区中受影响的邮件。
- $false:删除邮件和从隔离区中删除邮件不适用于隔离区中受影响的邮件。 此值为默认值。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 3 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-PermissionToDownload
适用:Exchange Online、Exchange Online Protection
PermissionToDownload 参数指定是否允许用户从隔离区下载邮件。 有效值包含:
- $true:权限已启用。
- $false:禁用权限。 此值为默认值。
目前,此值对受影响邮件的隔离通知或隔离中的可用作没有影响。 最终用户无法下载隔离的邮件。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 4 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-PermissionToPreview
适用:Exchange Online、Exchange Online Protection
PermissionToPreview 参数指定是否允许用户预览隔离的邮件。 有效值包含:
- $true:预览邮件可用于隔离区中受影响的邮件。
- $false:预览邮件不适用于隔离区中受影响的邮件。 此值为默认值。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 5 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-PermissionToRelease
适用:Exchange Online、Exchange Online Protection
PermissionToRelease 参数指定是否允许用户直接从隔离区中释放受影响的邮件。 有效值包含:
- $true:受影响邮件的隔离通知中提供发布, (发布电子邮件) 可用于隔离区中受影响的邮件。
- $false:发布邮件在受影响邮件的隔离通知中不可用,并且发布和发布电子邮件不适用于隔离区中受影响的邮件。
不要将此参数和 PermissionToRequestRelease 参数设置为$true。 将一个参数设置为$true,另一个参数设置为$false,或将这两个参数设置为$false。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 6 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-PermissionToRequestRelease
适用:Exchange Online、Exchange Online Protection
PermissionToRequestRelease 参数指定是否允许用户请求从隔离区释放邮件。 请求必须由管理员批准。有效值为:
- $true:请求释放在受影响邮件的隔离通知中可用,请求释放可用于隔离区中受影响的邮件。
- $false:请求释放在受影响邮件的隔离通知中不可用,并且请求发布不适用于隔离区中受影响的邮件。
不要将此参数和 PermissionRelease 参数设置为$true。 将一个参数设置为$true,另一个参数设置为$false,或将这两个参数设置为$false。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 7 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-PermissionToViewHeader
适用:Exchange Online、Exchange Online Protection
PermissionToViewHeader 参数指定是否允许用户查看隔离邮件的邮件标头。 有效值包含:
- $true:权限已启用。
- $false:禁用权限。 此值为默认值。
目前,此值对受影响邮件的隔离通知或隔离中的可用作没有影响。 查看邮件头始终可用于隔离区中受影响的邮件。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 8 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-QuarantinePermissionsObject
适用:Exchange Online、Exchange Online Protection
QuarantinePermissionsObject 参数指定包含要修改的隔离权限的现有变量。 例如,如果之前运行了 命令 $Perms = New-QuarantinePermissions <permissions>,请使用此参数的值 $Perms 。
参数属性
| 类型: | QuarantinePermissions |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 9 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。