Set-QuarantinePolicy

模块:

ExchangePowerShell

适用于:

Exchange Online, Exchange Online Protection

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

使用 Set-QuarantinePolicy cmdlet 修改基于云的组织中的隔离策略。

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

语法

Set-QuarantinePolicy
   [-Identity] <QuarantineTagIdParameter>
   [-AdminNotificationFrequencyInDays <Int32>]
   [-AdminNotificationLanguage <EsnLanguage>]
   [-AdminNotificationsEnabled <Boolean>]
   [-AdminQuarantinePermissionsList <MultiValuedProperty>]
   [-Confirm]
   [-CustomDisclaimer <String>]
   [-DomainController <Fqdn>]
   [-EndUserQuarantinePermissions <QuarantinePermissions>]
   [-EndUserQuarantinePermissionsValue <Int32>]
   [-EndUserSpamNotificationCustomFromAddress <String>]
   [-EndUserSpamNotificationFrequency <TimeSpan>]
   [-EndUserSpamNotificationFrequencyInDays <Int32>]
   [-EndUserSpamNotificationLanguage <EsnLanguage>]
   [-EsnCustomSubject <MultiValuedProperty>]
   [-ESNEnabled <Boolean>]
   [-IgnoreDehydratedFlag]
   [-MultiLanguageCustomDisclaimer <MultiValuedProperty>]
   [-MultiLanguageSenderName <MultiValuedProperty>]
   [-MultiLanguageSetting <MultiValuedProperty>]
   [-OrganizationBrandingEnabled <Boolean>]
   [-QuarantineRetentionDays <Int32>]
   [-WhatIf]
   [<CommonParameters>]

说明

不能修改名为 AdminOnlyAccessPolicy 或 DefaultFullAccessPolicy 的内置隔离策略。

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

示例

示例 1

Set-QuarantinePolicy -Identity CustomAccess -EndUserQuarantinePermissionsValue 1

此示例在名为 CustomAccess 的隔离策略中配置权限，该策略仅允许用户删除隔离的邮件。

示例 2

Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy -MultiLanguageSetting ('English','ChineseSimplified','French') -MultiLanguageCustomDisclaimer ('For more information, contact the Help Desk.','有关更多信息，请联系服务台','Pour plus d''informations, contactez le service d''assistance.') -ESNCustomSubject ('You have quarantined messages','您有隔离邮件','Vous avez des messages en quarantaine') -MultiLanguageSenderName ('Contoso administrator','Contoso管理员','Administrateur Contoso') -EndUserSpamNotificationCustomFromAddress aashutosh@contso.onmicrosoft.com -OrganizationBrandingEnabled $true -EndUserSpamNotificationFrequency 04:00:00

此示例修改隔离通知的全局设置 (以前称为最终用户垃圾邮件通知设置) ：

• 隔离通知针对英语、中文和法语进行自定义。 在法语 MultiLanguageCustomDisclaimer 值中，需要额外的引号作为文本中引号字符的转义字符。
• 现有用户 aashutosh@contso.onmicrosoft.com 用作隔离通知发件人。
• 以前配置的自定义徽标将替换默认的 Microsoft 徽标。
• 隔离通知的频率更改为 4 小时。

参数

-AdminNotificationFrequencyInDays

保留此参数以供 Microsoft 内部使用。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-AdminNotificationLanguage

保留此参数以供 Microsoft 内部使用。

Type:	EsnLanguage
Accepted values:	Default, English, French, German, Italian, Japanese, Spanish, Korean, Portuguese, Russian, ChineseSimplified, ChineseTraditional, Amharic, Arabic, Bulgarian, BengaliIndia, Catalan, Czech, Cyrillic, Danish, Greek, Estonian, Basque, Persian, Finnish, Filipino, Galician, Gujarati, Hebrew, Hindi, Croatian, Hungarian, Indonesian, Icelandic, Kazakh, Kannada, Lithuanian, Latvian, Malayalam, Marathi, Malay, Dutch, NorwegianNynorsk, Norwegian, Odia, Polish, PortuguesePortugal, Romanian, Slovak, Slovenian, SerbianCyrillic, Serbian, Swedish, Swahili, Tamil, Telugu, Thai, Turkish, Ukrainian, Urdu, Vietnamese
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-AdminNotificationsEnabled

保留此参数以供 Microsoft 内部使用。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-AdminQuarantinePermissionsList

保留此参数以供 Microsoft 内部使用。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Confirm

Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

• 破坏性 cmdlet (例如，Remove-* cmdlet) 具有内置的暂停，该暂停会强制你在继续操作之前确认命令。 对于这些 cmdlet，可以使用此确切语法跳过确认提示：-Confirm:$false。
• 大多数其他 cmdlet (例如，New-* 和 Set-* cmdlet) 没有内置暂停。 对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-CustomDisclaimer

保留此参数以供 Microsoft 内部使用。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-DomainController

保留此参数以供 Microsoft 内部使用。

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-EndUserQuarantinePermissions

保留此参数以供 Microsoft 内部使用。

Type:	QuarantinePermissions
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-EndUserQuarantinePermissionsValue

EndUserQuarantinePermissionsValue 参数指定隔离策略的最终用户权限。

此参数使用从二进制值转换的十进制值。 二进制值对应于按特定顺序排列的可用权限列表。 对于每个权限，值 1 等于 True，值 0 等于 False。 以下列表中介绍了从最高 (1000000 或 128) 到最低 (00000001或 1) 所需的顺序：

• PermissionToViewHeader：值 0 不会隐藏隔离区中的 “查看邮件头 ”操作。 如果邮件在隔离区中可见，则操作始终可用于邮件。
• PermissionToDownload： (值 0 或 1 不执行任何) ，则不使用此权限。
• PermissionToAllowSender： (值 0 或 1 不执行任何) ，则不使用此权限。
• PermissionToBlockSender
• PermissionToRequestRelease：不要将此权限和 PermissionToRelease 设置为值 1。 将一个值设置为 1，将另一个值设置为 0，或将这两个值都设置为 0。
• PermissionToRelease：不要将此权限和 PermissionToRequestRelease 设置为值 1。 将一个值设置为 1，将另一个值设置为 0，或将这两个值都设置为 0。 对于被隔离为恶意软件或高置信度网络钓鱼的邮件，不具有此权限。 如果隔离策略向用户授予此权限，则允许用户请求释放其隔离的恶意软件或高置信度钓鱼邮件，就像选择了 PermissionToRequestRelease 一样。
• PermissionToPreview
• PermissionToDelete

以下列表中介绍了预设最终用户权限组的值：

• 无访问权限：Binary = 0000000，因此请使用十进制值 0。
• 受限访问：Binary = 00011011，因此请使用十进制值 27。
• 完全访问权限：Binary = 00010111，因此请使用十进制值 23。

对于自定义权限，获取与所需权限对应的二进制值。 将二进制值转换为要使用的十进制值。 不要对此参数使用二进制值。

注意：如果此参数的值为 0 (无访问) 且 ESNEnabled 参数的值$true，则用户可以在隔离区中查看其邮件，但邮件的唯一可用操作是 “查看邮件头”。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-EndUserSpamNotificationCustomFromAddress

EndUserSpamNotificationCustomFromAddress 指定要用作隔离通知发件人的现有内部发件人的电子邮件地址。 若要将此参数设置回默认电子邮件地址 quarantine@messaging.microsoft.com，请使用 值$null。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-EndUserSpamNotificationFrequency

EndUserSpamNotificationFrequency 参数会设置隔离通知发送给用户的频率。 有效值包含:

• 04：00：00 (4 小时)
• 1.00：00：00 (1 天)
• 7.00：00：00 (7 天)

Type:	TimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-EndUserSpamNotificationFrequencyInDays

保留此参数以供 Microsoft 内部使用。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-EndUserSpamNotificationLanguage

保留此参数以供 Microsoft 内部使用。

Type:	EsnLanguage
Accepted values:	Default, English, French, German, Italian, Japanese, Spanish, Korean, Portuguese, Russian, ChineseSimplified, ChineseTraditional, Amharic, Arabic, Bulgarian, BengaliIndia, Catalan, Czech, Cyrillic, Danish, Greek, Estonian, Basque, Persian, Finnish, Filipino, Galician, Gujarati, Hebrew, Hindi, Croatian, Hungarian, Indonesian, Icelandic, Kazakh, Kannada, Lithuanian, Latvian, Malayalam, Marathi, Malay, Dutch, NorwegianNynorsk, Norwegian, Odia, Polish, PortuguesePortugal, Romanian, Slovak, Slovenian, SerbianCyrillic, Serbian, Swedish, Swahili, Tamil, Telugu, Thai, Turkish, Ukrainian, Urdu, Vietnamese
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-EsnCustomSubject

EsnCustomSubject 参数指定在隔离通知的“主题”字段中使用的文本。

可以使用语法指定用逗号分隔的多个值： ('value1',''value2',...'valueN')。 对于使用 MultiLanguageSetting 参数指定的每种语言，需要指定唯一的 Sender 文本。 请务必按相同的顺序对齐相应的 MultiLanguageSetting、MultiLanguageCustomDisclaimer、EsnCustomSubject 和 MultiLanguageSenderName 参数值。

若要修改现有值并保留其他值，需要按现有顺序指定所有现有值和新值。

此设置仅在控制全局隔离策略设置的名为 DefaultGlobalTag 的内置隔离策略中可用。 若要访问此隔离策略，请使用以下语法启动命令： Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ...。

Type:	undefined
Aliases:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-ESNEnabled

ESNEnabled 参数指定是否为策略启用隔离通知 (以前称为最终用户垃圾邮件通知) 。 有效值包含:

• $true：已启用隔离通知。
• $false：隔离通知已禁用。 用户只能在隔离区中访问隔离邮件，而不能在电子邮件通知访问。 此值为默认值。

注意：如果此参数的值$true并且 EndUserQuarantinePermissionsValue 参数的值为 0 (无访问权限（其中所有权限都处于关闭状态) ），则用户可以在隔离区中查看其邮件，但邮件的唯一可用操作是 “查看邮件头”。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Identity

Identity 参数指定要修改的隔离策略。 可以使用唯一标识隔离策略的任何值。 例如：

• 名称
• 可分辨名称 (DN)
• GUID

Type:	QuarantineTagIdParameter
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-IgnoreDehydratedFlag

保留此参数以供 Microsoft 内部使用。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-MultiLanguageCustomDisclaimer

MultiLanguageCustomDisclaimer 参数指定要在隔离通知底部附近使用的自定义免责声明文本。 本地化文本（组织 免责声明： ）始终先包含，后跟为此参数指定的文本。

可以使用语法指定用逗号分隔的多个值： ('value1',''value2',...'valueN')。 对于使用 MultiLanguageSetting 参数指定的每种语言，需要指定唯一的自定义免责声明文本。 请务必按相同的顺序对齐相应的 MultiLanguageSetting、MultiLanguageCustomDisclaimer、EsnCustomSubject 和 MultiLanguageSenderName 参数值。

若要修改现有值并保留其他值，需要按现有顺序指定所有现有值和新值。

此设置仅在控制全局隔离策略设置的名为 DefaultGlobalTag 的内置隔离策略中可用。 若要访问此隔离策略，请使用以下语法启动命令： Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ...。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-MultiLanguageSenderName

MultiLanguageSenderName 参数指定要在隔离通知中使用的电子邮件发件人的显示名称。

可以使用语法指定用逗号分隔的多个值： ('value1',''value2',...'valueN')。 对于使用 MultiLanguageSetting 参数指定的每种语言，可以指定唯一的发件人名称。 请确保按相同的顺序对齐相应的 MultiLanguageSetting、MultiLanguageCustomDisclaimer 和 MultiLanguageSenderName 参数值。

若要修改现有值并保留其他值，需要按现有顺序指定所有现有值和新值。

此设置仅在控制全局设置的名为 DefaultGlobalTag 的内置隔离策略中可用。 若要访问此隔离策略，请使用以下语法启动命令： Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ...。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-MultiLanguageSetting

MultiLanguageSetting 参数指定隔离通知的语言。 有效值包含:

Default、Amharic、阿拉伯语、巴斯克语、孟加拉语、保加利亚语、加泰罗尼亚语、ChineseSimplified、ChineseTraditional、克罗地亚文、西里尔文、 捷克、丹麦语、荷兰语、英语、爱沙尼亚语、菲律宾语、芬兰语、法语、加利西亚语、德语、希腊语、古吉拉特语、希伯来语、印地语、匈牙利语、冰岛语、印度尼西亚语、意大利语、日语、卡纳达语、哈萨克语、韩语、拉脱维亚语、立陶宛语、马来语、马拉雅拉姆语、马拉地语、挪威语、挪威语、奥迪亚语、波斯语、波兰语、葡萄牙语、葡萄牙语、葡萄牙语、罗马尼亚语、俄语、塞尔维亚语、塞尔维亚语、塞尔维亚语、 斯洛伐克语、斯洛文尼亚语、西班牙语、斯瓦西里语、瑞典语、泰米尔语、泰卢固语、泰国语、土耳其语、乌克兰语、乌尔都语和越南语。

可以使用语法指定用逗号分隔的多个值： ('value1',''value2',...'valueN')。 默认值为 Default，这意味着隔离通知使用基于云的组织的默认语言。

对于指定的每种语言，可以为 MultiLanguageCustomDisclaimer 和 MultiLanguageSenderName 参数指定唯一值。 请确保按相同的顺序对齐相应的 MultiLanguageSetting、MultiLanguageCustomDisclaimer 和 MultiLanguageSenderName 参数值。

此设置仅在控制全局设置的名为 DefaultGlobalTag 的内置隔离策略中可用。 若要访问此隔离策略，请使用以下语法启动命令： Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ...。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-OrganizationBrandingEnabled

OrganizationBrandingEnabled 参数启用或禁用最终用户隔离通知消息中的组织品牌。 有效值包含:

• $true：已启用组织品牌打造。 隔离通知中使用的默认 Microsoft 徽标将替换为自定义徽标。 执行此操作之前，需要按照为 组织自定义 Microsoft 365 主题 中的说明上传自定义徽标。
• $false：禁用组织品牌。 默认的 Microsoft 徽标用于隔离通知。 此值为默认值。

此设置仅在控制全局设置的名为 DefaultGlobalTag 的内置隔离策略中可用。 若要访问此隔离策略，请使用以下语法启动命令： Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ...。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-QuarantineRetentionDays

保留此参数以供 Microsoft 内部使用。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-WhatIf

WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection