Set-HostedConnectionFilterPolicy

Модуль:
Exchange PowerShell

Этот командлет доступен только в облачной службе.

Командлет Set-HostedConnectionFilterPolicy используется для изменения параметров политик фильтров подключений в облачной организации.

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

Синтаксис

Default (По умолчанию) 

Set-HostedConnectionFilterPolicy
    [-Identity] <HostedConnectionFilterPolicyIdParameter>
    [-AdminDisplayName <String>]
    [-ConfigurationXmlRaw <String>]
    [-Confirm]
    [-EnableSafeList <Boolean>]
    [-IPAllowList <MultiValuedProperty>]
    [-IPBlockList <MultiValuedProperty>]
    [-MakeDefault]
    [-WhatIf]
    [<CommonParameters>]

Описание

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

Примеры

Пример 1

Set-HostedConnectionFilterPolicy "Default" -IPAllowList 192.168.1.10,192.168.1.23 -IPBlockList 10.10.10.0/25,172.17.17.0/24

В этом примере изменяется политика фильтрации подключений с именем Default на следующие параметры:

  • Сообщения от 192.168.1.10 и 192.168.1.23 никогда не помечаются как нежелательная почта.
  • Сообщения от версий 10.10.10.0/25 и 172.17.17.0/24 всегда определяются как спам.

Пример 2

Set-HostedConnectionFilterPolicy "Default" -IPAllowList @{Add="192.168.2.10","192.169.3.0/24","192.168.4.1-192.168.4.5"; Remove="192.168.1.10"}

В этом примере изменяется политика фильтрации подключений с именем Default на следующие параметры:

  • К существующим значениям в списке разрешенных IP-адресов добавляются следующие IP-адреса: 192.168.2.10, 192.169.3.0/24 и 192.168.4.1-192.168.4.5.
  • IP-адрес 192.168.1.10 удаляется из существующих значений в списке разрешенных IP-адресов.

Параметры

-AdminDisplayName

Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков

Параметр AdminDisplayName определяет описание политики. Если значение содержит пробелы, его необходимо заключить в кавычки ("). Максимальная длина: 255 символов.

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ConfigurationXmlRaw

Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков

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

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Confirm

Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков

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

  • Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
  • Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание параметра Confirm без значения приводит к паузе, которая вынуждает вас подтвердить команду перед продолжением.

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-EnableSafeList

Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков

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

Свойства параметров

Тип:Boolean
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Identity

Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков

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

  • имя;
  • различающееся имя (DN);
  • GUID

Как правило, существует только одна политика фильтрации подключений: политика по умолчанию с именем Default.

Свойства параметров

Тип:HostedConnectionFilterPolicyIdParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:1
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-IPAllowList

Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков

Параметр IPAllowList указывает IP-адреса, сообщения от которых всегда разрешены. Сообщения с указанных вами IP-адресов не определяются как спам, несмотря на наличие других характеристик спама для сообщений. Допустимые значения:

  • Один IP-адрес, пример: 192.168.1.1.
  • Диапазон IP-адресов: можно использовать диапазон IP-адресов, например 192.168.0.1-192.168.0.254. Максимальное количество адресов в диапазоне — 256.
  • Диапазон IP-адресов CIDR, пример: 192.168.0.1/25. Допустимые значения маски подсети: от /24 до /32.

Можно указать несколько IP-адресов одного типа, разделив их запятыми. Например, SingleIP1, SingleIP2,...SingleIPN или CIDRIP1,CIDRIP2,...CIDRIPN. Чтобы указать одновременно несколько IP-адресов разных типов, необходимо использовать следующий синтаксис многозначного свойства: @{Add="SingleIP1","IPRange1","CIDRIP1",...}.

Примечание. Диапазоны IPv6 не поддерживаются.

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-IPBlockList

Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков

Параметр IPBlockList указывает IP-адреса, сообщения от которых всегда запрещены. Сообщения от указанных IP-адресов блокируются без дальнейшей проверки на предмет нежелательной почты. Допустимые значения:

  • Один IP-адрес, пример: 192.168.1.1.
  • Диапазон IP-адресов: можно использовать диапазон IP-адресов, например 192.168.0.1-192.168.0.254. Максимальное количество адресов в диапазоне — 256.
  • Диапазон IP-адресов CIDR, пример: 192.168.0.1/25. Допустимые значения маски подсети: от /24 до /32.

Можно указать несколько IP-адресов одного типа, разделив их запятыми. Например, SingleIP1, SingleIP2,...SingleIPN или CIDRIP1,CIDRIP2,...CIDRIPN. Чтобы указать одновременно несколько IP-адресов разных типов, необходимо использовать следующий синтаксис многозначного свойства: @{Add="SingleIP1","IPRange1","CIDRIP1",...}.

Примечание. Диапазоны IPv6 не поддерживаются.

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-MakeDefault

Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков

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

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WhatIf

Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков

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

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.

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

Input types

Чтобы просмотреть типы входных данных, которые принимает этот командлет, см. Типы входных и выходных данных командлета. Если поле "Типы входных данных" для командлета пусто, командлет не принимает входные данные.

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

Output types

Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.