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
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.