Set-ContentFilterConfig
此 cmdlet 仅适用于本地 Exchange。
使用 Set-ContentFilterConfig cmdlet 可修改邮箱服务器或边缘传输服务器上的内容筛选器配置。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Default (默认值)
Set-ContentFilterConfig
[-BypassedRecipients <MultiValuedProperty>]
[-BypassedSenderDomains <MultiValuedProperty>]
[-BypassedSenders <MultiValuedProperty>]
[-Confirm]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-ExternalMailEnabled <Boolean>]
[-InternalMailEnabled <Boolean>]
[-OutlookEmailPostmarkValidationEnabled <Boolean>]
[-QuarantineMailbox <SmtpAddress>]
[-RejectionResponse <AsciiString>]
[-SCLDeleteEnabled <Boolean>]
[-SCLDeleteThreshold <Int32>]
[-SCLQuarantineEnabled <Boolean>]
[-SCLQuarantineThreshold <Int32>]
[-SCLRejectEnabled <Boolean>]
[-SCLRejectThreshold <Int32>]
[-WhatIf]
[<CommonParameters>]
说明
您必须先获得权限,然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数,但如果某些参数未包含在分配给你的权限中,则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Set-ContentFilterConfig -BypassedSenderDomains woodgrovebank.com
本示例指定将发件人域 woodgrovebank.com 作为回避域。 从该域收到的邮件将绕过内容筛选器代理。
示例 2
Set-ContentFilterConfig -SCLQuarantineEnabled $true -SCLRejectEnabled $true -SCLDeleteEnabled $true -SCLQuarantineThreshold 5 -SCLRejectThreshold 6 -SCLDeleteThreshold 8 -QuarantineMailbox SpamQuarantineMailbox@contoso.com -RejectionResponse "Message rejected due to content restrictions" -BypassedRecipients user1@contoso.com,user2@contoso.com
本示例对内容筛选器代理配置做如下修改:
它启用并配置 SCL 阈值功能,分别将邮件隔离、拒绝和删除为 5、6 和 8。
它指定 SpamQuarantineMailbox@contoso.com 为垃圾邮件隔离邮箱。
它定义内容筛选器不处理消息的两个用户。
参数
-BypassedRecipients
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
BypassedRecipients 参数指定跳过内容筛选器代理处理的收件人的 SMTP 地址。
可以指定用逗号分隔的多个收件人, (例如 "recipient1@contoso.com","recipient2@contoso.com") 。 收件人条目的最大数目为 100。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-BypassedSenderDomains
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
BypassedSenderDomains 参数指定跳过内容筛选器代理处理的发件人的发件人电子邮件地址域。
可以指定用逗号分隔的多个发送方域 ("contoso.com","fabrikam.com") 。 使用通配符 (*) 指定域和所有子域 (,例如: *.contoso.com) 。 最大域条目数为 100。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-BypassedSenders
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
BypassedSenders 参数指定跳过内容筛选器代理处理的发件人的 SMTP 地址。
可以指定用逗号分隔的多个发件人, (例如 "sender1@contoso.com","sender2@contoso.com") 。 收件人条目的最大数目为 100。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Confirm
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。
- 破坏性 cmdlet(例如 Remove-* cmdlets)内置有暂停,可强制要求先确认命令,然后再继续操作。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:
-Confirm:$false。 - 其他大多数 cmdlet(例如 New-* 和 Set-* cmdlet)都没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-DomainController
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如,dc01.contoso.com。
边缘传输服务器上不支持 DomainController 参数。 边缘传输服务器使用活动目录轻型目录服务 (AD LDS) 的本地实例来读取和写入数据。
参数属性
| 类型: | Fqdn |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Enabled
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Enabled 参数指定在运行此命令的计算机上启用或禁用内容筛选器代理。 有效值包含:
- $true:已启用内容筛选器代理。 此值为默认值。
- $false:禁用内容筛选器代理。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ExternalMailEnabled
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
ExternalMailEnabled 参数指定是否由内容筛选器代理处理来自 Exchange 组织外部源的未经身份验证连接的所有邮件。 有效值包含:
- $true:来自未经身份验证的连接的消息由内容筛选器代理处理。 此值为默认值。
- $false:内容筛选器代理不会处理来自未经身份验证连接的消息。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-InternalMailEnabled
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
InternalMailEnabled 参数指定内容筛选器代理是否处理来自经过身份验证的连接和来自企业中权威域的所有消息。 有效值包含:
- $true:来自经过身份验证的连接的消息由内容筛选器代理处理。
- $false:内容筛选器代理不会处理来自经过身份验证的连接的消息。 此值为默认值。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-OutlookEmailPostmarkValidationEnabled
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
OutlookEmailPostmarkValidationEnabled 参数指定是否启用 Outlook Email Postmark 验证。
- 对于出站邮件,内容筛选器代理应用计算邮戳标头,以帮助目标电子邮件系统区分合法电子邮件和垃圾邮件。
- 对于入站消息,内容筛选器代理在邮件中查找计算邮戳标头。 存在有效的已解析计算邮戳标头表示生成邮件的客户端计算机解决了计算邮戳,因此内容筛选器代理可能会降低邮件的垃圾邮件置信度 (SCL) 评级。
有效值包含:
- $true:已启用 Outlook Email Postmark 验证。
- $false:禁用 Outlook Email Postmark 验证。 此值为默认值。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-QuarantineMailbox
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
QuarantineMailbox 参数指定要用作垃圾邮件隔离邮箱的 SMTP 地址。 将 SCLQuarantineEnabled 参数设置为 $true 时,需要垃圾邮件隔离邮箱。 满足或超过 SCLQuarantineThreshold 参数中设置的值的所有邮件都会发送到在此参数中设置的 SMTP 地址。
参数属性
| 类型: | SmtpAddress |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-RejectionResponse
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
RejectionResponse 参数指定要向其邮件达到或超过 SCLRejectThreshold 值的发件人发送的未送达报告 (NDR) 的邮件正文。 将 SCLRejectEnabled 参数设置为 $true 时,需要 RejectionResponse 参数。 RejectionResponse 参数接受字符串。 该参数不要超过 240 个字符。 传递参数时,如果短语包含空格,则必须将 RejectionResponse 参数放在引号 (") 内,如果短语包含空格,例如:"Message rejected"。 默认设置是 Message rejected due to content restrictions。
参数属性
| 类型: | AsciiString |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-SCLDeleteEnabled
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
SCLDeleteEnabled 参数指定是删除满足还是超过 SCLDeleteThreshold 参数中设置的值的所有消息。 有效值包含:
- $true:删除满足或超过 SCLDeleteThreshold 参数中设置的值的消息。
- $false:不会删除消息。 此值为默认值。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-SCLDeleteThreshold
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
SCLDeleteThreshold 参数指定从 1 到 9 的整数值。 此值表示特定邮件必须满足或超过此分级,内容筛选器代理才能删除邮件而不发送 NDR。 要启用此功能,必须将 SCLDeleteEnabled 参数设置为 $true。 默认设置为 9。
参数属性
| 类型: | Int32 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-SCLQuarantineEnabled
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
SCLQuarantineEnabled 参数指定是否将满足或超过 SCLQuarantineThreshold 参数中设置的值的所有邮件发送到 QuarantineMailbox 参数中指定的垃圾邮件隔离邮箱。 有效值包含:
- $true:满足或超过 SCLQuarantineThreshold 参数中设置的值的邮件将发送到 QuarantineMailbox 参数中指定的垃圾邮件隔离邮箱。
- $false:不会隔离邮件。 此值为默认值。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-SCLQuarantineThreshold
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
SCLQuarantineThreshold 参数指定从 1 到 9 的整数值。 此值表示内容筛选器代理隔离邮件必须满足或超过特定邮件的 SCL 分级。 要启用隔离功能,必须将 SCLQuarantineEnabled 参数设置为 $true,并在 QuarantineMailbox 参数中提供有效的 SMTP 地址。 默认设置为 9。
参数属性
| 类型: | Int32 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-SCLRejectEnabled
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
SCLRejectEnabled 参数指定在 NDR 中是否拒绝满足或超过 SCLRejectThreshold 参数中设置的值的所有邮件。 有效值包含:
- $true:在发送方 NDR 中拒绝满足或超过 SCLRejectThreshold 参数中设置的值的邮件。
- $false:不会拒绝消息。 此值为默认值。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-SCLRejectThreshold
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
SCLRejectThreshold 参数指定从 1 到 9 的整数值。 此值表示特定邮件必须满足或超过的 SCL 分级,内容筛选器代理才能拒绝邮件并向发件人发送 NDR。 要启用删除功能,必须将 SCLDeleteEnabled 参数设置为 $true。 此外,可以通过编辑 RejectionResponse 参数修改默认的 NDR 邮件。 默认设置为 7。
参数属性
| 类型: | Int32 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-WhatIf
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。
参数属性
| 类型: | SwitchParameter |
| 默认值: | 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。
输入
Input types
若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。