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>]]
Подробное описание
Чтобы определить, как агент фильтра содержимого будет назначать оценки вероятности нежелательной почты, определяя допустимые и недопустимые слова или фразы, необходимо сначала определить пользовательские слова.
Обязательным свойством пользовательского слова или фразы является параметр Influence. Параметр Influence может принимать одно из двух значений: GoodWord или BadWord.
Сообщению, содержащему пользовательское слово или фразу, для которого значение параметра Influence установлено равным GoodWord, автоматически присваивается оценка вероятности нежелательной почты 0, и оно, таким образом, обходит дальнейшую обработку нежелательной почты. Сообщению, содержащему пользовательское слово или фразу, для которого значение параметра Influence равно BadWord, автоматически присваивается оценка вероятности нежелательной почты 9, и оно, таким образом, рассматривается как нежелательная почта в соответствии с политиками, настроенными в Microsoft Exchange Server 2007.
Пользовательские слова и фразы можно вводить в любом сочетании строчных и заглавных букв. Но при проверке содержимого сообщения агент фильтра содержимого игнорирует регистр. Максимальное количество создаваемых пользовательских слов или фраз равно 800.
Дополнительные сведения об изменении агента фильтра содержимого см. в разделе Set-ContentFilterConfig.
Для выполнения командлета Add-ContentFilterPhrase используемой учетной записи необходимо делегировать следующую роль:
- роль администратора сервера Exchange Server и членство в локальной группе администраторов на целевом сервере.
Чтобы выполнить командлет Add-ContentFilterPhrase на компьютере с установленной ролью пограничного транспортного сервера, необходимо войти в систему, используя учетную запись, являющуюся членом локальной группы администраторов данного компьютера.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования сервера 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, включите в команду параметр 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