Set-ContentFilterConfig
此 cmdlet 仅适用于本地 Exchange。
使用 Set-ContentFilterConfig cmdlet 可修改邮箱服务器或边缘传输服务器上的内容筛选器配置。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
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
BypassedRecipients 参数指定组织中收件人的 SMTP 地址值。 内容筛选器代理不会对发往该参数所列地址的邮件进行任何内容筛选处理。 若要输入多个 SMTP 地址,请使用逗号分隔地址,例如,recipient1@contoso.comrecipient2@contoso.com。 可以输入的最大收件人数为 100。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-BypassedSenderDomains
BypassedSenderDomains 参数指定发送域的域名值。 内容筛选器代理不会对来自该参数所列域的邮件进行任何内容筛选处理。 若要输入多个域,请使用逗号分隔地址,例如:contoso.com, example.com。 可以使用通配符 (*) 指定所有子域,例如:*.contoso.com。 可以输入的最大域数为 100。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-BypassedSenders
BypassedSenders 参数指定发件人的 SMTP 地址值。 内容筛选器代理不会对来自该参数所列地址的邮件进行任何内容筛选处理。 若要输入多个 SMTP 地址,请使用逗号分隔地址,例如: sender1@contoso.com、 sender2@example.com。 可以输入的最大 SMTP 地址数为 100。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Confirm
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。
- 破坏性 cmdlet (例如,Remove-* cmdlet) 具有内置的暂停,该暂停会强制你在继续操作之前确认命令。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:
-Confirm:$false
。 - 大多数其他 cmdlet (例如,New-* 和 Set-* cmdlet) 没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如,dc01.contoso.com。
边缘传输服务器上不支持 DomainController 参数。 边缘传输服务器使用活动目录轻型目录服务 (AD LDS) 的本地实例来读取和写入数据。
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Enabled
Enabled 参数指定在运行此命令的计算机上启用或禁用内容筛选器代理。 Enabled 参数的有效输入是 $true 或 $false。 默认设置是 $true。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ExternalMailEnabled
ExternalMailEnabled 参数指定是否通过内容筛选器代理处理来自 Exchange 组织外部源的未经身份验证连接的所有邮件。 ExternalMailEnabled 参数的有效输入是 $true 或 $false。 默认设置是 $true。 ExternalMailEnabled 参数设置为 $true 时,未通过身份验证的连接所发送的所有邮件均将经过内容筛选器代理的处理。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-InternalMailEnabled
InternalMailEnabled 参数指定来自已通过身份验证的连接或来自企业中权威域的所有邮件是否均由内容筛选器代理进行处理。 InternalMailEnabled 参数的有效输入是 $true 或 $false。 默认设置是 $false。 InternalMailEnabled 参数设置为 $true 时,来自已通过身份验证的连接或来自企业中权威域的所有邮件均将经过内容筛选器代理的处理。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-OutlookEmailPostmarkValidationEnabled
OutlookEmailPostmarkValidationEnabled 参数指定内容筛选器代理是否将计算谜题发送到发件人的系统进行处理。 OutlookEmailPostmarkValidationEnabled 参数的有效输入是 $true 或 $false。 当 OutlookEmailPostmarkValidationEnabled 参数设置为 $true 时,内容筛选器代理会将计算谜题发送到发件人的系统进行处理。 问题验证结果将计入整体垃圾邮件可信度 (SCL)。 此功能作为 Outlook 电子邮件邮戳验证向Microsoft Outlook 用户公开。 默认设置是 $false。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-QuarantineMailbox
QuarantineMailbox 参数指定要用作垃圾邮件隔离邮箱的 SMTP 地址。 将 SCLQuarantineEnabled 参数设置为 $true 时,需要垃圾邮件隔离邮箱。 满足或超过 SCLQuarantineThreshold 参数中设置的值的所有邮件都会发送到在此参数中设置的 SMTP 地址。
Type: | SmtpAddress |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-RejectionResponse
RejectionResponse 参数指定要向其邮件达到或超过 SCLRejectThreshold 值的发件人发送的未送达报告 (NDR) 的邮件正文。 将 SCLRejectEnabled 参数设置为 $true 时,需要 RejectionResponse 参数。 RejectionResponse 参数接受字符串。 该参数不要超过 240 个字符。 传递参数时,如果短语包含空格,则必须将 RejectionResponse 参数放在引号 (") 内,如果短语包含空格,例如:"Message rejected"。 默认设置是 Message rejected due to content restrictions。
Type: | AsciiString |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SCLDeleteEnabled
SCLDeleteEnabled 参数指定是删除满足还是超过 SCLDeleteThreshold 参数中设置的值的所有消息。 SCLDeleteEnabled 参数的有效输入是 $true 或 $false。 默认设置是 $false。 当 SCLDeleteEnabled 参数设置为 $true 时,将删除满足或超过 SCLDeleteThreshold 参数中设置的值的所有消息。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SCLDeleteThreshold
SCLDeleteThreshold 参数指定从 1 到 9 的整数值。 此值表示特定邮件必须满足或超过此分级,内容筛选器代理才能删除邮件而不发送 NDR。 要启用此功能,必须将 SCLDeleteEnabled 参数设置为 $true。 默认设置为 9。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SCLQuarantineEnabled
SCLQuarantineEnabled 参数指定是否将满足或超过 SCLQuarantineThreshold 参数中设置的值的所有邮件发送到 QuarantineMailbox 参数中指定的垃圾邮件隔离邮箱。 SCLQuarantineEnabled 参数的有效输入是 $true 或 $false。 默认设置是 $false。 当 SCLQuarantineEnabled 参数设置为 $true 时,满足或超过 SCLQuarantineThreshold 参数中设置的值的所有邮件都会发送到 QuarantineMailbox 参数中指定的垃圾邮件隔离邮箱。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SCLQuarantineThreshold
SCLQuarantineThreshold 参数指定从 1 到 9 的整数值。 此值表示内容筛选器代理隔离邮件必须满足或超过特定邮件的 SCL 分级。 要启用隔离功能,必须将 SCLQuarantineEnabled 参数设置为 $true,并在 QuarantineMailbox 参数中提供有效的 SMTP 地址。 默认设置为 9。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SCLRejectEnabled
SCLRejectEnabled 参数指定是否拒绝满足或超过 SCLRejectThreshold 参数中设置的值的所有消息,并向发送方发送 NDR。 SCLRejectEnabled 参数的有效输入是 $true 或 $false。 默认设置是 $false。 当 SCLRejectEnabled 参数设置为 $true 时,将拒绝满足或超过 SCLRejectThreshold 参数中设置的值的所有消息,并将 NDR 发送给发件人。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SCLRejectThreshold
SCLRejectThreshold 参数指定从 1 到 9 的整数值。 此值表示特定邮件必须满足或超过的 SCL 分级,内容筛选器代理才能拒绝邮件并向发件人发送 NDR。 要启用删除功能,必须将 SCLDeleteEnabled 参数设置为 $true。 此外,可以通过编辑 RejectionResponse 参数修改默认的 NDR 邮件。 默认设置为 7。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WhatIf
WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
输入
Input types
若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。