Set-ContentFilterConfig

Этот командлет доступен только в локальной среде Exchange.

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

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Set-ContentFilterConfig
   [-BypassedRecipients <MultiValuedProperty>]
   [-BypassedSenderDomains <MultiValuedProperty>]
   [-BypassedSenders <MultiValuedProperty>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-ExternalMailEnabled <Boolean>]
   [-InternalMailEnabled <Boolean>]
   [-OutlookEmailPostmarkValidationEnabled <Boolean>]
   [-QuarantineMailbox <SmtpAddress>]
   [-RejectionResponse <AsciiString>]
   [-SCLDeleteEnabled <Boolean>]
   [-SCLDeleteThreshold <Int32>]
   [-SCLQuarantineEnabled <Boolean>]
   [-SCLQuarantineThreshold <Int32>]
   [-SCLRejectEnabled <Boolean>]
   [-SCLRejectThreshold <Int32>]
   [-WhatIf]
   [<CommonParameters>]

Описание

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

Set-ContentFilterConfig -BypassedSenderDomains woodgrovebank.com

В этом примере домен отправителя woodgrovebank.com указывается в качестве домена, не проходящего проверку. Сообщения, отправляемые с этого домена, пропускаются агентом фильтра содержимого.

Пример 2

Set-ContentFilterConfig -SCLQuarantineEnabled $true -SCLRejectEnabled $true -SCLDeleteEnabled $true -SCLQuarantineThreshold 5 -SCLRejectThreshold 6 -SCLDeleteThreshold 8 -QuarantineMailbox SpamQuarantineMailbox@contoso.com -RejectionResponse "Message rejected due to content restrictions" -BypassedRecipients user1@contoso.com,user2@contoso.com

В этом примере производятся следующие изменения в конфигурации агента фильтра содержимого:

Он включает и настраивает пороговые функции SCL, которые помещают в карантин, отклоняют и удаляют сообщения до 5, 6 и 8 соответственно.

Он указывает в качестве почтового ящика карантина нежелательной почты SpamQuarantineMailbox@contoso.com .

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

Параметры

-BypassedRecipients

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

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-BypassedSenderDomains

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

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-BypassedSenders

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

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Confirm

Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.

  • Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
  • Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

Параметр DomainController не поддерживается пограничными транспортными серверами. Пограничный транспортный сервер использует локальный экземпляр службы Active Directory облегченного доступа к каталогам (AD LDS) для чтения и записи данных.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Enabled

Параметр Enabled включает или отключает агент фильтра содержимого на компьютере, на котором выполняется команда. Допустимым значением параметра Enabled может быть $true или $false. Значение по умолчанию — $true.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExternalMailEnabled

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-InternalMailEnabled

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-OutlookEmailPostmarkValidationEnabled

Параметр OutlookEmailPostmarkValidationEnabled указывает, отправляет ли агент фильтра содержимого вычислительную головоломку в систему отправителя для обработки. Допустимым значением параметра OutlookEmailPostmarkValidationEnabled может быть $true или $false. Если для параметра OutlookEmailPostmarkValidationEnabled задано значение $true, агент фильтра содержимого отправляет вычислительную головоломку в систему отправителя для обработки. Результаты проверки задачи факторизуются в общей вероятности нежелательной почты. Эта функция предоставляется пользователю Майкрософт Outlook в качестве проверки почтовой почты Outlook. Параметр по умолчанию — $false.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-QuarantineMailbox

Параметр QuarantineMailbox указывает SMTP-адрес для использования в качестве почтового ящика карантина нежелательной почты. Почтовый ящик карантина нежелательной почты требуется, когда для параметра SCLQuarantineEnabled установлено значение $true. Все сообщения, которые соответствуют значению, заданному в параметре SCLQuarantineThreshold, отправляются на SMTP-адрес, заданный в этом параметре.

Type:SmtpAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-RejectionResponse

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

Type:AsciiString
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SCLDeleteEnabled

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SCLDeleteThreshold

Параметр SCLDeleteThreshold указывает целое значение от 1 до 9. Это значение представляет оценку SCL, которую должно соответствовать или превышать определенное сообщение, чтобы агент фильтра содержимого удалил сообщение и не отправлял NDR. Чтобы включить эту функцию, необходимо для параметра SCLDeleteEnabled установить значение $true. Значение по умолчанию: 9.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SCLQuarantineEnabled

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SCLQuarantineThreshold

Параметр SCLQuarantineThreshold указывает целое значение от 1 до 9. Это значение представляет оценку SCL, которую должно соответствовать или превышать определенное сообщение, чтобы агент фильтра содержимого помещает сообщение в карантин. Чтобы включить функцию карантина, для параметра SCLQuarantineEnabled необходимо установить значение $true, а в параметре QuarantineMailbox указать действительный SMTP-адрес. Значение по умолчанию: 9.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SCLRejectEnabled

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SCLRejectThreshold

Параметр SCLRejectThreshold указывает целое значение от 1 до 9. Это значение представляет оценку SCL, которую должно соответствовать или превышать определенное сообщение, чтобы агент фильтра содержимого отклонил сообщение и отправил отправителю отчет о недоставках. Чтобы включить функцию удаления, необходимо для параметра SCLDeleteEnabled установить значение $true. Также можно изменить сообщение с отчетом о недоставке, изменив параметр RejectionResponse. Значение по умолчанию — 7.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Входные данные

Input types

Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.

Выходные данные

Output types

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.