Командлет 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