New-QuarantinePermissions

模块:

ExchangePowerShell

适用于:

Exchange Online, Exchange Online Protection

此 cmdlet 仅在基于云的服务中可用。

使用 New-QuarantinePermissions cmdlet 创建用于 New-QuarantineTag cmdlet 的隔离权限对象。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

New-QuarantinePermissions
   [-PermissionToBlockSender <Boolean>]
   [-PermissionToDelete <Boolean>]
   [-PermissionToDownload <Boolean>]
   [-PermissionToPreview <Boolean>]
   [-PermissionToRelease <Boolean>]
   [-PermissionToRequestRelease <Boolean>]
   [-PermissionToViewHeader <Boolean>]
   [<CommonParameters>]

说明

不使用的任何参数的默认值为 $false，因此只需使用参数 (要设置为 $true 的权限) 。

您必须先获得权限，然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

$NoAccess = New-QuarantinePermissions

本示例创建与安全性 & 合规性隔离标记中的“无访问权限”组使用的相同权限。 权限对象存储在名为 的 $NoAccess变量中。

在同一Windows PowerShell会话中，可以在 $NoAccess New-QuarantineTag 或 Set-QuarantineTag 命令中使用 EndUserQuarantinePermissions 参数值。

示例 2

$LimitedAccess = New-QuarantinePermissions -PermissionToBlockSender $true -PermissionToDelete $true -PermissionToPreview $true -PermissionToRequestRelease $true

本示例在安全 & 合规性的隔离标记中创建由受限访问权限组使用的相同权限。 权限对象存储在名为 的 $LimitedAccess变量中。

在同一Windows PowerShell会话中，可以在 $LimitedAccess New-QuarantineTag 或 Set-QuarantineTag 命令中使用 EndUserQuarantinePermissions 参数值。

示例 3

$FullAccess = New-QuarantinePermissions -PermissionToBlockSender $true -PermissionToDelete $true -PermissionToPreview $true -PermissionToRelease $true

此示例在安全 & 合规性的隔离标记中创建完全访问权限组使用的相同权限。 权限对象存储在名为 的 $FullAccess变量中。

在同一Windows PowerShell会话中，可以在 $FullAccess 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