Поделиться через


Командлет Set-ContentFilterConfig (окончательная первоначальная версия)

 

Применимо к: Exchange Server 2007

Последнее изменение раздела: 2007-08-27

Командлет Set-ContentFilterConfig используется для изменения конфигурации фильтра содержимого на компьютере с установленной ролью пограничного транспортного сервера или транспортного сервера-концентратора.

Синтаксис

Set-ContentFilterConfig [-BypassedRecipients <MultiValuedProperty>] [-BypassedSenderDomains <MultiValuedProperty>] [-BypassedSenders <MultiValuedProperty>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-ExternalMailEnabled <$true | $false>] [-Instance <ContentFilterConfig>] [-InternalMailEnabled <$true | $false>] [-OutlookEmailPostmarkValidationEnabled <$true | $false>] [-QuarantineMailbox <Nullable>] [-RejectionResponse <AsciiString>] [-SCLDeleteEnabled <$true | $false>] [-SCLDeleteThreshold <Int32>] [-SCLQuarantineEnabled <$true | $false>] [-SCLQuarantineThreshold <Int32>] [-SCLRejectEnabled <$true | $false>] [-SCLRejectThreshold <Int32>]

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

Эта команда служит для изменения конфигурации фильтра содержимого.

Для выполнения командлета Set-ContentFilterConfig используемой учетной записи необходимо делегировать следующее:

  • роль администратора сервера Exchange Server и членство в локальной группе администраторов на целевом сервере.

Чтобы выполнить командлет Set-ContentFilterPhrase на компьютере, на котором установлена роль пограничного транспортного сервера, необходимо войти в систему, используя учетную запись, которая является членом локальной группы «Администраторы» на этом компьютере.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.

Параметры

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

BypassedRecipients

Дополнительно

Microsoft.Exchange.Data.MultiValuedProperty

Этот параметр получает значения адресов SMTP получателей в организации. Агент фильтра содержимого не выполняет фильтрацию содержимого для сообщений, которые связаны с адресами, перечисленными в этом параметре. Можно ввести несколько адресов SMTP, разделяя их запятыми следующим образом, например: recipient1@contoso.com, recipient2@contoso.com

Максимальное число вводимых получателей равно 100.

BypassedSenderDomains

Дополнительно

Microsoft.Exchange.Data.MultiValuedProperty

Этот параметр получает значения доменных имен отправляющих доменов. Агент фильтра содержимого не выполняет фильтрацию содержимого для сообщений, которые получены из доменов, перечисленных в этом параметре. Можно ввести несколько доменов, разделяя их запятыми следующим образом, например: contoso.com, example.com. Можно использовать символ подстановки (*) для указания всех дочерних доменов, например: *.contoso.com. Максимальное число доменов, которые можно ввести, равно 100.

BypassedSenders

Дополнительно

Microsoft.Exchange.Data.MultiValuedProperty

Этот параметр получает значения адресов SMTP отправителей. Агент фильтра содержимого не выполняет фильтрацию содержимого для сообщений, которые получены с адресов, перечисленных в этом параметре. Можно ввести несколько адресов SMTP, разделяя их запятыми следующим образом, например: sender1@contoso.com, sender2@example.com

Максимальное число адресов SMTP, которые можно ввести, равно 100.

DomainController

Дополнительно

Microsoft.Exchange.Data.Fqdn

Чтобы указать полное доменное имя (FQDN) контроллера домена, записывающего это изменение конфигурации в службу каталогов Active Directory, включите в команду параметр DomainController. Параметр DomainController не поддерживается компьютерами, на которых установлена серверная роль «Граничный транспорт». Серверная роль «Граничный транспорт» записывает только локальный экземпляр ADAM.

Включен

Дополнительно

System.Boolean

Допустимое входное значение параметра Enabled$true или $false. Настройка по умолчанию — $true. Когда для параметра Enabled установлено значение $true, агент фильтра содержимого включен на компьютере, на котором выполняется команда Set-ContentFilterConfig.

ExternalMailEnabled

Дополнительно

System.Boolean

Допустимое входное значение параметра ExternalMailEnabled$true или $false. Настройка по умолчанию — $true. Когда для параметра ExternalMailEnabled установлено значение $true, все сообщения с соединений, которые не прошли проверку подлинности, проходят через агент фильтра содержимого для обработки.

Instance

Дополнительно

Microsoft.Exchange.Data.Directory.SystemConfiguration.ContentFilterConfig

Параметр Instance позволяет передавать весь объект в команду для обработки. Главным образом он используется в сценариях, в которых в команду должен быть передан весь объект.

InternalMailEnabled

Дополнительно

System.Boolean

Допустимое входное значение параметра InternalMailEnabled$true или $false. Настройка по умолчанию — $false. Когда для параметра InternalMailEnabled установлено значение $true, все сообщения с прошедших проверку подлинности соединений и с удостоверяющих доменов в организации проходят через агент фильтра содержимого для обработки.

OutlookEmailPostmarkValidationEnabled

Дополнительно

System.Boolean

Допустимым значением параметра OutlookEmailPostmarkValidationEnabled может быть $true или $false. Когда для параметра OutlookEmailPostmarkValidationEnabled установлено значение $true, агент фильтра содержимого отправляет расчетную задачу в систему электронной почты отправителя для обработки. Результаты проверки задачи факторизуются в общей вероятности нежелательной почты. Данная возможность доступна пользователю Microsoft Outlook как функция проверки почтовой марки Office Outlook 2007. Настройка по умолчанию — $false.

QuarantineMailbox

Дополнительно

System.Nullable

Допустимое значение ввода параметра QuarantineMailbox — это адрес SMTP. Карантинный почтовый ящик нежелательной почты требуется, когда для параметра SCLQuarantineEnabled установлено значение True. Все сообщения, которые превышают значение, заданное параметром SCLQuarantineThreshold, отправляются на адрес SMTP, который задан в этом параметре.

RejectionResponse

Дополнительно

Microsoft.Exchange.Data.AsciiString

Этот параметр требуется, если для параметра SCLRejectEnabled установлено значение True. Параметр RejectionResponse принимает строку. Введите текст сообщения, которое необходимо доставить в отчете о недоставке отправителям, сообщения которых соответствуют или превышают значение SCLRejectThreshold. В этом аргументе не должно быть более 240 символов. При передаче аргумента параметр RejectionResponse необходимо заключить в двойные кавычки, если фраза содержит пробелы, как в следующем примере: "Message rejected". Значение по умолчанию — Message rejected due to content restrictions.

SCLDeleteEnabled

Дополнительно

System.Boolean

Допустимое значение ввода параметра SCLDeleteEnabled — это $true или $false. Настройка по умолчанию — $false. Когда для параметра SCLDeleteEnabled установлено значение $true, все сообщения, которые превышают значение, заданное параметром SCLDeleteThreshold, удаляются.

SCLDeleteThreshold

Дополнительно

System.Int32

Этот параметр принимает целое значение от 1 до 9. Это значение соответствует рейтингу вероятности нежелательной почты, который конкретное сообщение должно превысить, чтобы агент фильтра содержимого удалил сообщение и не отправлял отчет о недоставке. Чтобы включить эту функцию, необходимо для параметра SCLDeleteEnabled установить значение True. Настройка по умолчанию — 9.

SCLQuarantineEnabled

Дополнительно

System.Boolean

Допустимое значение ввода параметра SCLQuarantineEnabled — это $true или $false. Настройка по умолчанию — $false. Когда для параметра SCLQuarantineEnabled установлено значение $true, все сообщения, которые превышают значение, заданное параметром SCLQuarantineThreshold, отправляются в карантинный почтовый ящик нежелательной почты, который указан в параметре QuarantineMailbox.

SCLQuarantineThreshold

Дополнительно

System.Int32

Этот параметр принимает целое значение от 1 до 9. Это значение соответствует рейтингу вероятности нежелательной почты, который конкретное сообщение должно превысить, чтобы агент фильтра содержимого поместил сообщение в карантин. Чтобы включить функцию карантина, необходимо установить для параметра SCLQuarantineEnabled значение True и указать действительный адрес SMTP в параметре QuarantineMailbox. Настройка по умолчанию — 9.

SCLRejectEnabled

Дополнительно

System.Boolean

Допустимое значение ввода параметра SCLRejectEnabled — это $true или $false. Настройка по умолчанию — $false. Когда для параметра SCLRejectEnabled установлено значение $true, все сообщения, которые превышают значение, заданное параметром SCLRejectThreshold, отклоняются и отправителю посылается отчет о недоставке.

SCLRejectThreshold

Дополнительно

System.Int32

Этот параметр принимает целое значение от 1 до 9. Это значение соответствует рейтингу вероятности нежелательной почты, который конкретное сообщение должно превысить, чтобы агент фильтра содержимого отклонил сообщение и отправил отчет о недоставке отправителю. Чтобы включить функцию удаления, необходимо для параметра SCLDeleteEnabled установить значение True. Также можно изменить сообщение с отчетом о недоставке, изменив параметр RejectionResponse. Настройка по умолчанию — 9.

Типы входных данных

Типы возвращаемых данных

Ошибки

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

 

Пример

В первом примере программы показывается, как с помощью команды Set-ContentFilterConfig внести в конфигурацию фильтра содержимого указанные ниже изменения.

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

  • Назначение адреса spamQ@contoso.com карантинным почтовым ящиком для нежелательной почты.

  • Задает действие фильтра содержимого по отклонению всех сообщений, которые превышают порог вероятности нежелательной почты.

  • Задается ответ на отклонение.

  • Для параметра AuthenticatedMessageBypassEnabled устанавливается значение $true.

  • Включение функции проверки задачи.

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

Во втором примере программного кода показывается, как с помощью команды Set-ContentFilterConfig задать домен отправителя (woodgrovebank.com), для входящей почты которого не будет выполняться фильтрация содержимого.

Set-ContentFilterConfig -SclQuarantineEnabled:$true -SclRejectEnabled:$true -SclDeleteEnabled:$true -SclQuarantineThreshold 5 -SclRejectThreshold 6 -SclDeleteThreshold 8  -QuarantineMailbox spamQ@contoso.com -RejectionResponse "Message rejected due to content restrictions" -AuthenticatedMessageBypassEnabled:$true -PuzzleValidationEnabled:$true -BypassedRecipients user1@contoso.com, user2@contoso.com 
Set-ContentFilterConfig -BypassedSenderDomains woodgrovebank.com