Командлет Add-ContentFilterPhrase используется, чтобы определить пользовательские слова для агента фильтра содержимого. Пользовательское слово — это слово или фраза, определяемые администратором для агента фильтра содержимого, чтобы фильтр мог оценить содержимое сообщения электронной почты и применить соответствующую обработку.

Синтаксис

Add-ContentFilterPhrase -Phrase <String> -Influence <GoodWord | BadWord> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

Параметры

Параметр Обязательный Тип Описание

Influence

Обязательный

Microsoft.Exchange.Data.Directory.SystemConfiguration.Influence

Допустимыми являются значения GoodWord и BadWord.

Phrase

Обязательный

System.String

Если фраза содержит пробелы, при передаче аргумента параметр Phrase необходимо заключить в кавычки, например: "This is a bad phrase". Длина пользовательских фраз должна быть меньше 257 знаков.

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 не требуется.

Подробное описание

Чтобы определить, как агент фильтра содержимого будет назначать оценки вероятности нежелательной почты, определяя допустимые и недопустимые слова или фразы, необходимо сначала определить пользовательские слова.

Обязательным свойством пользовательского слова или фразы является параметр 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, см. в разделе Вопросы, связанные с разрешениями.

Входные типы

Возвращаемые типы

Ошибки

Ошибка Описание

  

Пример

В следующем примере кода показана команда Add-ContentFilterPhrase, определяющая пользовательское слово, являющееся «плохой» фразой типа BadWord, This is a bad phrase.

Копировать код
Add-ContentFilterPhrase -Phrase:"This is a bad phrase" -Influence:BadWord