New-QuarantinePolicy

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

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

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

语法

Default (默认值)

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>]
    [-IncludeMessagesFromBlockedSenderAddress <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

适用:Exchange Online、Exchange Online Protection

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-AdminNotificationFrequencyInDays

适用:Exchange Online、Exchange Online Protection

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

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-AdminNotificationLanguage

适用:Exchange Online、Exchange Online Protection

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

参数属性

类型:EsnLanguage
默认值:None
接受的值: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
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-AdminNotificationsEnabled

适用:Exchange Online、Exchange Online Protection

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

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-AdminQuarantinePermissionsList

适用:Exchange Online、Exchange Online Protection

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

参数属性

类型:MultiValuedProperty
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-CustomDisclaimer

适用:Exchange Online、Exchange Online Protection

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DomainController

适用:Exchange Online、Exchange Online Protection

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

参数属性

类型:Fqdn
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-EndUserQuarantinePermissions

适用:Exchange Online、Exchange Online Protection

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

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

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

参数属性

类型:QuarantinePermissions
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-EndUserQuarantinePermissionsValue

适用:Exchange Online、Exchange Online Protection

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
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-EndUserSpamNotificationCustomFromAddress

适用:Exchange Online、Exchange Online Protection

EndUserSpamNotificationCustomFromAddress 指定要用作隔离通知发件人的现有内部发件人的电子邮件地址。

如果不使用此参数,则默认发件人为 quarantine@messaging.microsoft.com。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-EndUserSpamNotificationFrequency

适用:Exchange Online、Exchange Online Protection

EndUserSpamNotificationFrequency 参数指定向用户发送隔离通知的频率。 有效值包含:

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

参数属性

类型:TimeSpan
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-EndUserSpamNotificationFrequencyInDays

适用:Exchange Online、Exchange Online Protection

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

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-EndUserSpamNotificationLanguage

适用:Exchange Online、Exchange Online Protection

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

参数属性

类型:EsnLanguage
默认值:None
接受的值: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
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-EsnCustomSubject

适用:Exchange Online、Exchange Online Protection

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

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

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

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

参数属性

类型:MultiValuedProperty
默认值:None
支持通配符:False
不显示:False
别名:MultiValuedProperty

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ESNEnabled

适用:Exchange Online、Exchange Online Protection

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

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

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

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-IncludeMessagesFromBlockedSenderAddress

适用:Exchange Online、Exchange Online Protection

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

  • $true:收件人收到来自阻止发件人的受影响邮件的隔离通知。
  • $false:收件人不会收到来自阻止发件人的受影响邮件的隔离通知。 此值为默认值。

参数属性

类型:Boolean
默认值:False
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-MultiLanguageCustomDisclaimer

适用:Exchange Online、Exchange Online Protection

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

参数属性

类型:MultiValuedProperty
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-MultiLanguageSenderName

适用:Exchange Online、Exchange Online Protection

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

参数属性

类型:MultiValuedProperty
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-MultiLanguageSetting

适用:Exchange Online、Exchange Online Protection

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

参数属性

类型:MultiValuedProperty
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Name

适用:Exchange Online、Exchange Online Protection

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:0
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-OrganizationBrandingEnabled

适用:Exchange Online、Exchange Online Protection

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

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-QuarantinePolicyType

适用:Exchange Online、Exchange Online Protection

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

参数属性

类型:QuarantinePolicyType
默认值:None
接受的值:QuarantinePolicy, GlobalQuarantinePolicy
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-QuarantineRetentionDays

适用:Exchange Online、Exchange Online Protection

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

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters