Set-QuarantinePolicy

此 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]
   [-IncludeMessagesFromBlockedSenderAddress <Boolean>]
   [-MultiLanguageCustomDisclaimer <MultiValuedProperty>]
   [-MultiLanguageSenderName <MultiValuedProperty>]
   [-MultiLanguageSetting <MultiValuedProperty>]
   [-OrganizationBrandingEnabled <Boolean>]
   [-QuarantineRetentionDays <Int32>]
   [-WhatIf]
   [<CommonParameters>]

说明

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

您必须先获得权限,然后才能运行此 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 内部使用。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:Exchange Online, Exchange Online Protection

-AdminNotificationLanguage

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

类型:EsnLanguage
接受的值: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
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:Exchange Online, Exchange Online Protection

-AdminNotificationsEnabled

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

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:Exchange Online, Exchange Online Protection

-AdminQuarantinePermissionsList

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

类型:MultiValuedProperty
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:Exchange Online, Exchange Online Protection

-Confirm

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

  • 破坏性 cmdlet(例如 Remove-* cmdlets)内置有暂停,可强制要求先确认命令,然后再继续操作。 对于这些 cmdlet,可以使用此确切语法跳过确认提示:-Confirm:$false。
  • 其他大多数 cmdlet(例如 New-* 和 Set-* cmdlet)都没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。
类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:Exchange Online, Exchange Online Protection

-CustomDisclaimer

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

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:Exchange Online, Exchange Online Protection

-DomainController

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

类型:Fqdn
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:Exchange Online, Exchange Online Protection

-EndUserQuarantinePermissions

注意:若要在隔离策略中设置权限,建议使用 EndUserQuarantinePermissionsValue 参数。

EndUserQuarantinePermissions 通过使用 New-QuarantinePermissions 或 Set-QuarantinePermissions 命令输出中的变量来指定隔离策略的最终用户权限。

例如,运行以下命令,将所需权限存储在变量中: $Perms = New-QuarantinePermissions <permissions>。 在同一 PowerShell 会话中,为此参数使用 值 $Perms

类型:QuarantinePermissions
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:Exchange Online, Exchange Online Protection

-EndUserQuarantinePermissionsValue

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

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

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

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

  • 无访问权限:Binary = 0000000,因此请使用十进制值 0。
  • 受限访问:Binary = 00101011,因此请使用十进制值 43。
  • 完全访问权限:Binary = 00100111,因此请使用十进制值 39。

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

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

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:Exchange Online, Exchange Online Protection

-EndUserSpamNotificationCustomFromAddress

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

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:Exchange Online, Exchange Online Protection

-EndUserSpamNotificationFrequency

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

  • 04:00:00 (4 小时)
  • 1.00:00:00 (1 天)
  • 7.00:00:00 (7 天)
类型:TimeSpan
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:Exchange Online, Exchange Online Protection

-EndUserSpamNotificationFrequencyInDays

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

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:Exchange Online, Exchange Online Protection

-EndUserSpamNotificationLanguage

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

类型:EsnLanguage
接受的值: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
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:Exchange Online, Exchange Online Protection

-EsnCustomSubject

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

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

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

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

类型:MultiValuedProperty
别名:MultiValuedProperty
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:Exchange Online, Exchange Online Protection

-ESNEnabled

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

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

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

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:Exchange Online, Exchange Online Protection

-Identity

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

  • 名称
  • 可分辨名称 (DN)
  • GUID
类型:QuarantineTagIdParameter
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False
适用于:Exchange Online, Exchange Online Protection

-IgnoreDehydratedFlag

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

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:Exchange Online, Exchange Online Protection

-IncludeMessagesFromBlockedSenderAddress

IncludeMessagesFromBlockedSenderAddress 参数指定是否为来自阻止发件人地址的隔离邮件发送隔离通知。 有效值包含:

  • $true:收件人收到来自阻止发件人的受影响邮件的隔离通知。
  • $false:收件人不会收到来自阻止发件人的受影响邮件的隔离通知。 此值为默认值。
类型:Boolean
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False
适用于:Exchange Online, Exchange Online Protection

-MultiLanguageCustomDisclaimer

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

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

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

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

类型:MultiValuedProperty
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:Exchange Online, Exchange Online Protection

-MultiLanguageSenderName

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

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

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

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

类型:MultiValuedProperty
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于: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 ...

注意:值 English 映射到除 en-US 以外的每个英语语言代码。 如果只有 en-US 邮箱的用户,请使用默认值。 如果混合了具有 en-US 和其他英语语言代码的邮箱, (en-GB、en-CA、en-AU 等 ) ,请在一个自定义隔离通知中使用默认值,并在另一个自定义隔离通知中使用“英语”值。

类型:MultiValuedProperty
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:Exchange Online, Exchange Online Protection

-OrganizationBrandingEnabled

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

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

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

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:Exchange Online, Exchange Online Protection

-QuarantineRetentionDays

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

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:Exchange Online, Exchange Online Protection

-WhatIf

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

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:Exchange Online, Exchange Online Protection