Set-MailboxJunkEmailConfiguration

Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.

Командлет Set-MailboxJunkEmailConfiguration используется для настройки параметров спама в почтовых ящиках.

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

Синтаксис

Set-MailboxJunkEmailConfiguration
   [-Identity] <MailboxIdParameter>
   [-BlockedSendersAndDomains <MultiValuedProperty>]
   [-Confirm]
   [-ContactsTrusted <Boolean>]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-IgnoreDefaultScope]
   [-TrustedListsOnly <Boolean>]
   [-TrustedRecipientsAndDomains <MultiValuedProperty>]
   [-TrustedSendersAndDomains <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

Описание

Этот командлет управляет следующими параметрами спама для почтового ящика:

  • Включение или отключение правила нежелательной почты. В локальной среде Exchange правило нежелательной почты (скрытое правило папки "Входящие" с именем "Правило нежелательной почты") управляет доставкой сообщений в папку "Нежелательная Email" или папку "Входящие" на основе порогового значения папки нежелательной Email SCL (для организации или почтового ящика) и коллекции списка безопасности в почтовом ящике.

    В облачной службе правило нежелательной почты не влияет на поток обработки почты. Exchange Online Protection доставляет сообщения в папку "Нежелательная Email" на основе действий, заданных в политиках защиты от нежелательной почты. Правило нежелательной почты в почтовом ящике по-прежнему определяет, что происходит с сообщениями после доставки на основе коллекции списка безопасности почтового ящика.

    Пользователи могут включить или отключить правило нежелательной почты в своем почтовом ящике с помощью Outlook в Интернете.

  • Настройка коллекции списков безопасности. Коллекция списков безопасности — это список надежных отправителей, список надежных получателей и список заблокированных отправителей. Пользователи могут настроить коллекцию списков безопасности в своем почтовом ящике с помощью Microsoft Outlook или Outlook в Интернете.

Дополнительные сведения см. в статье Configure Exchange antispam settings on mailboxes.

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

Примеры

Пример 1

Set-MailboxJunkEmailConfiguration "David Pelton" -Enabled $false

В этом примере отключается правило нежелательной почты для пользователя с именем Дэвид Пелтон. В локальной среде Exchange сообщения больше не перемещаются между папкой "Входящие" и папкой "Нежелательная Email" на основе порогового значения папки нежелательной Email SCL (организация или почтовый ящик) или коллекции списка безопасности почтового ящика. В Exchange Online коллекция списка безопасности почтового ящика не может перемещать сообщения между папкой "Входящие" и папкой "Нежелательная Email". Сообщения по-прежнему доставляются в папку "Нежелательная Email" на основе вердикта и соответствующего действия политик защиты от нежелательной почты.

Пример 2

Set-MailboxJunkEmailConfiguration "Michele Martin" -TrustedSendersAndDomains @{Add="contoso.com","fabrikam.com"} -BlockedSendersAndDomains @{Add="jane@fourthcoffee.com"}

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

  • домены contoso.com и fabrikam.com добавляются в список надежных отправителей без изменения других имеющихся записей;
  • Добавляет jane@fourthcoffee.com в список заблокированных отправителей, не затрагивая другие существующие записи.

Пример 3

Get-MailboxJunkEmailConfiguration * | Where {$_.ContactsTrusted -eq $true} | Set-MailboxJunkEmailConfiguration -ContactsTrusted $false

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

Параметры

-BlockedSendersAndDomains

Параметр BlockedSendersAndDomains задает список заблокированных отправителей — электронных адресов и доменов, сообщения с которых автоматически отправляются в папку нежелательной почты. Этот параметр соответствует параметру Outlook в Интернете: Перемещение электронной почты из этих отправителей или доменов в папку "Нежелательная Email".

Чтобы ввести несколько значений и перезаписать все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".

Чтобы добавить или удалить одно или несколько значений, не затрагивая существующие записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

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, Exchange Online

-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, Exchange Online, Exchange Online Protection

-ContactsTrusted

Параметр ContactsTrusted указывает, считаются ли контакты в папке "Контакты" надежными отправителями. Этот параметр соответствует параметру Outlook в Интернете: Доверять электронной почте из моих контактов. Допустимые значения:

  • $true. Сообщения от контактов в папке Контакты, которые попадают в почтовый ящик, никогда не доставляются в папку "Нежелательная Email", независимо от содержимого.
  • $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, Exchange Online

-DomainController

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

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

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 включает или отключает правило нежелательной почты для почтового ящика (скрытое правило для папки "Входящие" с именем "Правило нежелательной почты"). Допустимые значения:

  • $true: в почтовом ящике включено правило нежелательной почты. В Outlook в Интернете этому значению соответствует параметр Автоматически фильтровать нежелательную почту. Это значение используется по умолчанию.

    В локальной среде Exchange коллекция списка безопасности почтового ящика (список надежных отправителей, список надежных получателей и список заблокированных отправителей) и пороговое значение папки нежелательной Email SCL (для организации или почтового ящика) доставляют сообщения в папку "Входящие" или папку "Нежелательная Email".

    В облачной службе коллекция списка безопасности почтового ящика перемещает доставленные сообщения между папкой "Входящие" или папкой "Нежелательная Email". Сообщения доставляются в папку "Нежелательная Email" только на основе вердикта и соответствующего действия политик защиты от нежелательной почты.

  • $false. Правило нежелательной почты отключено в почтовом ящике. В Outlook в Интернете этому значению соответствует параметр Не перемещать сообщения в папку "Нежелательная почта".

    В локальной среде Exchange коллекция списка безопасности почтового ящика или пороговое значение папки нежелательной Email SCL не могут доставить сообщения в папку "Входящие" или папку "Нежелательная Email".

    В облачной службе коллекция списков безопасности почтового ящика не может перемещать доставленные сообщения между папкой "Входящие" или папкой "Нежелательная Email". Сообщения по-прежнему доставляются в папку "Нежелательная Email" на основе вердикта и соответствующего действия политик защиты от нежелательной почты.

Вы можете просмотреть состояние правила нежелательной почты, выполнив любую из следующих команд, чтобы определить значение свойства Enabled:

  • Get-MailboxJunkEmailConfiguration -Identity <MailboxIdentity>
  • Только в локальной среде Exchange: Get-InboxRule "Junk E-mail Rule" -Mailbox <MailboxIdentity> -IncludeHidden

Состояние правила нежелательной почты в почтовом ящике не влияет на параметры нежелательной почты на стороне клиента, доступные в фильтре нежелательной Email Outlook. Даже если правило нежелательной почты отключено в почтовом ящике, Outlook по-прежнему может перемещать сообщения в папку "Нежелательная Email". Например, если Outlook определяет, что сообщение является спамом или отправитель определен в списке Заблокированные отправители, Outlook может переместить сообщение в папку Нежелательная Email. Дополнительные сведения см. в статье Обзор фильтра Email нежелательной почты.

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, Exchange Online

-Identity

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

  • Имя
  • Псевдоним
  • различающееся имя (DN);
  • различающееся имя (DN);
  • Домен\Имя пользователя
  • Адрес электронной почты
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • Идентификатор пользователя или имя участника-пользователя
Type:MailboxIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-IgnoreDefaultScope

Параметр IgnoreDefaultScope указывает команде игнорировать параметр получателя область по умолчанию для сеанса Exchange PowerShell и использовать весь лес в качестве область. Указывать значение для этого параметра необязательно.

Этот параметр позволяет команде получать доступ к объектам Active Directory, которые в настоящее время недоступны в область по умолчанию, но также вводит следующие ограничения:

  • При этом параметр DomainController использовать нельзя. Команда автоматически использует соответствующий сервер глобального каталога.
  • При этом параметр DomainController использовать нельзя. Команда автоматически использует соответствующий сервер глобального каталога.
Type:SwitchParameter
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, Exchange Online

-TrustedListsOnly

Параметр TrustedListsOnly указывает, что в папку "Входящие" доставляются только сообщения от адресов из списка надежных отправителей. Все остальные сообщения рассматриваются как спам. Этот параметр соответствует параметру Outlook в Интернете: не доверяйте электронной почте, если она не поступает от кого-либо из списка надежных отправителей и получателей. Допустимые значения:

  • $true. В папку "Входящие" доставляются только сообщения с адреса электронной почты или записей домена в списке Надежные отправители и надежные получатели. Все остальные сообщения автоматически доставляются в папку нежелательной почты.
  • $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, Exchange Online

-TrustedRecipientsAndDomains

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

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

-TrustedSendersAndDomains

Параметр TrustedSendersAndDomains указывает списки надежных отправителей и получателей, состоящие из электронных адресов и доменов. Сообщения от этих отправителей, достигающие почтового ящика, никогда не доставляются в папку нежелательной почты независимо от их содержимого. Этот параметр соответствует параметру Outlook в Интернете: не перемещайте электронную почту из этих отправителей или доменов в папку "Нежелательная Email".

Чтобы ввести несколько значений и перезаписать все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".

Чтобы добавить или удалить одно или несколько значений, не затрагивая существующие записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Чтобы очистить список электронных адресов и доменов, используйте значение $null.

Примечания.

  • Нельзя добавить адреса электронной почты отправителя из того же домена, что и адрес электронной почты получателя. Все почтовые ящики в глобальном списке адресов (GAL) автоматически считаются доверенными отправителями.
  • С помощью этого командлета невозможно изменить список надежных получателей напрямую. Сначала необходимо изменить список надежных отправителей с помощью этого параметра, после чего электронные адреса и домены будут синхронизированы со списком надежных получателей.
  • В автономном EOP с синхронизацией каталогов записи домена не синхронизируются по умолчанию, но вы можете включить синхронизацию для доменов. Дополнительные сведения см. в статье Configure Content Filtering to Use Safe Domain Data.
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, Exchange Online

-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, Exchange Online, Exchange Online Protection

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

Input types

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

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

Output types

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