Set-QuarantinePermissions
此 cmdlet 仅在基于云的服务中可用。
使用 Set-QuarantinePermissions cmdlet 修改隔离标记中使用的隔离权限对象 (New-QuarantineTag 或 Set-QuarantineTag cmdlet) 。 此 cmdlet 仅适用于由 New-QuarantinePermissions cmdlet 创建并存储在当前在 Windows PowerShell 会话中可用的变量中的权限对象。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Set-QuarantinePermissions
-QuarantinePermissionsObject <QuarantinePermissions>
[-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
本示例修改先前在同一Windows PowerShell会话中创建的退出$Perms
权限对象中的指定隔离标记权限, ($Perms
变量仍可用并填充) 。
在同一Windows PowerShell会话中,可以在 $Perms
New-QuarantineTag 或 Set-QuarantineTag 命令中使用 EndUserQuarantinePermissions 参数值。
参数
-PermissionToBlockSender
PermissionToBlockSender 参数指定是否允许用户将隔离的邮件发件人添加到其阻止发件人列表。 有效值包含:
- $true:“阻止发件人”按钮包含在最终用户隔离通知中。
- $false:最终用户隔离通知中不包括“阻止发件人”按钮。 此值为默认值。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-PermissionToDelete
PermissionToDelete 参数指定是否允许用户从隔离区中删除邮件。 有效值包含:
- $true:隔离邮件详细信息中包含“从隔离区中删除”按钮。
- $false:隔离邮件详细信息中不包括“从隔离区中删除”按钮。 此值为默认值。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-PermissionToDownload
PermissionToDownload 参数指定是否允许用户从隔离区下载邮件。 有效值包含:
- $true:权限已启用。
- $false:禁用权限。 此值为默认值。
目前,此值对最终用户垃圾邮件通知或隔离邮件详细信息中包含的按钮没有影响。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-PermissionToPreview
PermissionToPreview 参数指定是否允许用户预览隔离的邮件。 有效值包含:
- $true:“预览邮件”按钮包含在隔离邮件详细信息中。
- $false:“预览邮件”按钮不包括在隔离邮件详细信息中。 此值为默认值。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-PermissionToRelease
PermissionToRelease 参数指定是否允许用户直接从隔离区释放邮件。 有效值包含:
- $true:“发布”按钮包含在最终用户垃圾邮件通知中,“发布邮件”按钮包含在隔离邮件详细信息中。
- $false:最终用户垃圾邮件通知中不包含“发布”按钮,并且隔离邮件详细信息中不包含“发布邮件”按钮。 此值为默认值。
不要将此参数和 PermissionToRequestRelease 参数设置为$true。 将一个参数设置为$true,另一个参数设置为$false,或将这两个参数设置为$false。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-PermissionToRequestRelease
PermissionToRequestRelease 参数指定是否允许用户请求从隔离区释放邮件。 请求必须由管理员批准。有效值为:
- $true:“发布”按钮包含在最终用户垃圾邮件通知中,“发布邮件”按钮包含在隔离邮件详细信息中。
- $false:最终用户垃圾邮件通知中不包含“发布”按钮,并且隔离邮件详细信息中不包含“发布邮件”按钮。 此值为默认值。
不要将此参数和 PermissionRelease 参数设置为$true。 将一个参数设置为$true,另一个参数设置为$false,或将这两个参数设置为$false。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-PermissionToViewHeader
PermissionToViewHeader 参数指定是否允许用户查看隔离邮件的邮件标头。 有效值包含:
- $true:权限已启用。
- $false:禁用权限。 此值为默认值。
目前,此值对最终用户垃圾邮件通知或隔离邮件详细信息中包含的按钮没有影响。 “查看邮件头”按钮始终在隔离邮件详细信息中可用。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-QuarantinePermissionsObject
QuarantinePermissionsObject 参数指定包含要修改的隔离权限对象的变量。 例如,如果运行命令 $Perms = New-QuarantinePermissions <permissions>
,请使用此参数的值 $Perms
。
Type: | QuarantinePermissions |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |