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。