Add-ContentFilterPhrase
适用于： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
上一次修改主题： 2007-06-22
使用 Add-ContentFilterPhrase cmdlet，可为内容筛选器代理定义自定义单词。自定义单词是管理员为内容筛选器代理设置的单词或短语，用于评估电子邮件的内容和应用合适的筛选处理。
语法
Add-ContentFilterPhrase -Phrase <String> -Influence <GoodWord | BadWord> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]
详细说明
若要通过标识已批准和未批准的单词或短语来自定义内容筛选器代理如何分配垃圾邮件可信度 (SCL) 分级，必须首先定义自定义单词。
自定义单词或短语的一个必需属性是 Influence 参数。Influence 参数接受两个值之一：GoodWord 或 BadWord。
对于包含 Influence 值为 GoodWord 的自定义单词或短语的邮件，会自动将其 SCL 分级指派为 0，因此会绕过下游垃圾邮件处理。对于包含 Influence 值为 BadWord 的自定义单词或短语的邮件，会自动将其 SCL 分级指派为 9，因此根据 Microsoft Exchange Server 2007 中配置的策略，该邮件会被视为垃圾邮件。
可以以大写和小写字母的任何组合输入自定义单词或短语。但是，在内容筛选器代理评估邮件内容时，它将忽略大小写。可以创建的自定义单词或短语的最大个数是 800。
有关如何修改内容筛选器代理的详细信息，请参阅 Set-ContentFilterConfig。
若要运行 Add-ContentFilterPhrase cmdlet，必须为您使用的帐户委派下列角色：
- Exchange Server 管理员角色和目标服务器的本地 Administrators 组
若要在安装了边缘传输服务器角色的计算机上运行 Add-ContentFilterPhrase cmdlet，必须使用作为该计算机上的本地 Administrators 组成员的帐户进行登录。
有关管理 Exchange Server 2007 所需的权限、角色委派以及权利的详细信息，请参阅权限注意事项。
参数
| 参数 | 必需 | 类型 | 说明 |
|---|---|---|---|
Influence |
必需 |
Microsoft.Exchange.Data.Directory.SystemConfiguration.Influence |
有效值是 |
Phrase |
必需 |
System.String |
传递参数时，如果短语包含空格，则必须将 Phrase 参数放在引号内，如下所示： |
Confirm |
可选 |
System.Management.Automation.SwitchParameter |
Confirm 参数将导致命令暂停处理，并且需要您在继续处理之前确认该命令将执行的操作。您不必使用 Confirm 参数指定值。 |
DomainController |
可选 |
Microsoft.Exchange.Data.Fqdn |
若要指定将此配置更改写入 Active Directory 目录服务的域控制器的完全限定的域名 (FQDN)，请在命令中包含 DomainController 参数。运行边缘传输服务器角色的计算机不支持 DomainController 参数。边缘传输服务器角色只对本地 ADAM 实例进行读取和写入。 |
WhatIf |
可选 |
System.Management.Automation.SwitchParameter |
WhatIf 参数指示命令模拟针对对象执行的操作。通过使用 WhatIf 参数，您可以查看要发生的更改，而不必应用任何这些更改。您不必使用 WhatIf 参数指定值。 |
输入类型
返回类型
错误
| 错误 | 说明 |
|---|---|
|
示例
下列代码示例显示 Add-ContentFilterPhrase 命令，该命令定义的自定义单词是 BadWord 短语 This is a bad phrase。
Add-ContentFilterPhrase -Phrase:"This is a bad phrase" -Influence:BadWord