Add-ContentFilterPhrase
適用版本： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
上次修改主題的時間： 2007-06-22
使用 Add-ContentFilterPhrase 指令程式可定義內容篩選器代理程式的自訂文字。「自訂文字」是系統管理員為內容篩選器代理程式設定的文字或詞彙，用於評估電子郵件訊息內容並套用適當的篩選處理。
語法
Add-ContentFilterPhrase -Phrase <String> -Influence <GoodWord | BadWord> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]
詳細描述
若要藉由識別核准及不核准的文字或詞彙，以自訂內容篩選器代理程式指派垃圾郵件信賴等級 (SCL) 分級的方式，您必須先定義自訂的字。
自訂之文字或詞彙的必要屬性為 Influence 參數。Influence 參數會採用下列兩個值中的其中一個值：GoodWord 或 BadWord。
包含自訂的文字或詞彙，並且其 Influence 值為 GoodWord 的郵件會自動指派 0 的 SCL 分級，因此會略過下游垃圾郵件處理。包含自訂的文字或詞彙，並且其 Influence 值為 BadWord 的郵件會自動指派 9 的 SCL 分級，因此會根據您在 Microsoft Exchange Server 2007 中設定的原則將此郵件視為垃圾郵件。
您可以任意的大小寫字母組合來輸入自訂的文字或詞彙。不過，內容篩選器代理程式在評估郵件內容時，會忽略大小寫。可建立的自訂文字或詞彙上限為 800 個。
如需如何修改內容篩選器代理程式的相關資訊，請參閱 Set-ContentFilterConfig。
若要執行 Add-ContentFilterPhrase 指令程式，您使用的帳戶必須已委派下列資格：
- Exchange Server 系統管理員角色和目標伺服器的本機 Administrators 群組
若要在已安裝 Edge Transport server role 的電腦上執行 Add-ContentFilterPhrase 指令程式，則必須使用該電腦之本機 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 參數。執行 Edge Transport server role 的電腦不支援 DomainController 參數。Edge Transport server role 只會讀取和寫入至本機 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