New-QuarantinePolicy

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

使用 New-QuarantinePolicy cmdlet 在基于云的组织中创建隔离策略。

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

语法

New-QuarantinePolicy
   [-Name] <String>
   [-AdminDisplayName <String>]
   [-AdminNotificationFrequencyInDays <Int32>]
   [-AdminNotificationLanguage <EsnLanguage>]
   [-AdminNotificationsEnabled <Boolean>]
   [-AdminQuarantinePermissionsList <MultiValuedProperty>]
   [-CustomDisclaimer <String>]
   [-DomainController <Fqdn>]
   [-EndUserQuarantinePermissions <QuarantinePermissions>]
   [-EndUserQuarantinePermissionsValue <Int32>]
   [-EndUserSpamNotificationCustomFromAddress <String>]
   [-EndUserSpamNotificationFrequency <TimeSpan>]
   [-EndUserSpamNotificationFrequencyInDays <Int32>]
   [-EndUserSpamNotificationLanguage <EsnLanguage>]
   [-EsnCustomSubject <MultiValuedProperty>]
   [-ESNEnabled <Boolean>]
   [-MultiLanguageCustomDisclaimer <MultiValuedProperty>]
   [-MultiLanguageSenderName <MultiValuedProperty>]
   [-MultiLanguageSetting <MultiValuedProperty>]
   [-OrganizationBrandingEnabled <Boolean>]
   [-QuarantinePolicyType <QuarantinePolicyType>]
   [-QuarantineRetentionDays <Int32>]
   [<CommonParameters>]

说明

隔离策略根据邮件被隔离的原因定义允许用户对隔离邮件执行的操作, (支持的功能) 和隔离通知设置。 有关详细信息,请参阅 隔离策略

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

示例

示例 1

New-QuarantinePolicy -Name ContosoTag -EndUserQuarantinePermissionsValue 0

此示例创建一个名为 ContosoTag 的新隔离策略,其权限与“无访问权限”预设权限组的权限相同。

若要分配受限访问权限,请使用值 27。 若要分配完全访问权限,请使用值 23。

参数

-AdminDisplayName

AdminDisplayName 参数指定隔离策略的说明。 如果值中有空格,请使用双引号 (") 将此值括起来。

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

-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

-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。

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

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

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。

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

-MultiLanguageCustomDisclaimer

保留此参数以供 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

-MultiLanguageSenderName

保留此参数以供 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

-MultiLanguageSetting

保留此参数以供 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

-Name

Name 参数指定隔离策略的唯一名称。 如果值中有空格,请使用双引号 (") 将此值括起来。

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

-OrganizationBrandingEnabled

保留此参数以供 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

-QuarantinePolicyType

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

Type:QuarantinePolicyType
Accepted values:QuarantinePolicy, GlobalQuarantinePolicy
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