Update-SafeList

Ссылка

Модуль:: ExchangePowerShell

Применяется к:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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

Используйте командлет Update-SafeList для обновления статистических данных списка безопасности в Active Directory. Агрегированные данные списка безопасности используются во встроенной фильтрации нежелательной почты в Майкрософт Exchange. EdgeSync реплицирует данные объединения списка надежных отправителей на пограничные транспортные серверы в сети периметра.

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

Синтаксис

Update-SafeList
      [-Identity] <MailboxIdParameter>
      [-Confirm]
      [-DomainController <Fqdn>]
      [-EnsureJunkEmailRule]
      [-IncludeDomains]
      [-Type <UpdateType>]
      [-WhatIf]
      [<CommonParameters>]

Описание

Командлет Update-SafeList считывает данные агрегирования списка безопасности, хранящиеся в почтовом ящике пользователя Майкрософт Outlook, а затем хэширует и записывает данные в соответствующий объект пользователя в Active Directory. Команда сравнивает созданный двоичный атрибут со всеми значениями, сохраненными в атрибуте. Если два значения совпадают, команда не обновляет значение пользовательского атрибута с данными объединения списка надежных отправителей. Статистические данные списка безопасных списков содержат список надежных отправителей и список надежных получателей пользователя Outlook.

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

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

Примеры

Пример 1

Update-Safelist kim@contoso.com

В этом примере обновляются данные списка надежных отправителей для одного пользователя kim@contoso.com.

Пример 2

Set-AdServerSettings -ViewEntireForest $true

Get-Mailbox -ResultSize Unlimited -RecipientTypeDetails UserMailbox | Update-Safelist

В этом примере обновляются данные списка безопасности для всех почтовых ящиков пользователей в организации Exchange. По умолчанию командная консоль Exchange настроена для получения или изменения объектов, находящихся в домене, в котором находится сервер Exchange Server. Поэтому, чтобы получить все почтовые ящики в организации Exchange, необходимо сначала задать область действия командной консоли Exchange для всего леса с помощью командлета Set-AdServerSettings.

Параметры

-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.

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

-EnsureJunkEmailRule

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

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

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

-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

-IncludeDomains

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

По умолчанию указанные отправителями домены не включаются в списки надежных отправителей.

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

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

-Type

Параметр Type указывает, какой из созданных пользователем списков будет обновлен в объекте пользователя. Допустимые значения этого параметра — SafeSenders, SafeRecipients и Both. Значение по умолчанию: SafeSenders.

Функция объединения списков надежных отправителей не влияет на данные списка надежных получателей. Не рекомендуется использовать параметр Type со значениями SafeRecipients или Both.

Type:	UpdateType
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

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