Applies to: Exchange Server 2007
Topic Last Modified: 2007-06-17
Use the Add-ContentFilterPhrase cmdlet to define custom words for the Content Filter agent. A custom word is a word or phrase that the administrator sets for the Content Filter agent to evaluate the content of an e-mail message and apply appropriate filter processing.
Syntax
Add-ContentFilterPhrase -Phrase <String> -Influence
<GoodWord | BadWord> [-DomainController <Fqdn>]
|
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
Influence |
Required |
Microsoft.Exchange.Data.Directory.SystemConfiguration.Influence |
Valid values are |
|
Phrase |
Required |
System.String |
When you pass an argument, you must enclose the Phrase
parameter in quotation marks if the phrase contains spaces as
follows, for example: |
|
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
To specify the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to the Active Directory directory service, include the DomainController parameter on the command. The DomainController parameter is not supported on computers that run the Edge Transport server role. The Edge Transport server role reads and writes only to the local ADAM instance. |
Detailed Description
To customize how the Content Filter agent assigns spam confidence level (SCL) ratings by identifying approved and unapproved words or phrases, you must first define custom words.
A required property of a custom word or phrase is the
Influence parameter. The Influence parameter takes
one of two values: GoodWord or
BadWord.
A message that contains a custom word or phrase that
has an Influence value of GoodWord is
automatically assigned an SCL rating of 0 and
therefore bypasses downstream spam processing. A message that
contains a custom word or phrase that has an Influence value
of BadWord is automatically assigned an SCL rating of
9 and therefore is treated as spam according to the
policies that you have configured in
Microsoft Exchange Server 2007.
You can enter custom words or phrases in any combination of uppercase and lowercase letters. However, when the Content Filter agent evaluates message content, it ignores case. The maximum number of custom words or phrases that can be created is 800.
For more information about how to modify the Content Filter agent, see Set-ContentFilterConfig (RTM).
To run the Add-ContentFilterPhrase cmdlet, the account you use must be delegated the following:
- Exchange Server Administrator role and local Administrators
group for the target server
To run the Add-ContentFilterPhrase cmdlet on a computer that has the Edge Transport server role installed, you must log on by using an account that is a member of the local Administrators group on that computer.
For more information about permissions, delegating roles, and the rights that are required to administer Microsoft Exchange Server 2007, see Permission Considerations.
Input Types
Return Types
Errors
| Error | Description |
|---|---|
|
|
Example
The following code example shows an
Add-ContentFilterPhrase command that defines a custom word
that is the BadWord phrase, This is a bad phrase.
 Copy Code |
|
|---|---|
Add-ContentFilterPhrase -Phrase:"This is a bad phrase" -Influence:BadWord |
|