Set-HostedConnectionFilterPolicy
Этот командлет доступен только в облачной службе.
Командлет Set-HostedConnectionFilterPolicy используется для изменения параметров политик фильтров подключений в облачной организации.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
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
Параметр AdminDisplayName указывает описание политики. Если значение содержит пробелы, его необходимо заключить в кавычки ("). Максимальная длина: 255 символов.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-ConfigurationXmlRaw
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-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 Online, Exchange Online Protection |
-EnableSafeList
Параметр EnableSafeList разрешает или запрещает использование списка надежных отправителей. Список надежных отправителей — это динамический список разрешений в центре обработки данных Майкрософт, не требующий настройки пользователем. Допустимые значения:
$true. Используйте список безопасности, чтобы пропустить фильтрацию нежелательной почты по сообщениям от доверенных отправителей, определяемых различными сторонними источниками, на которые подписана корпорация Майкрософт.
$false: не используйте безопасный список. Это значение используется по умолчанию.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Identity
Параметр Identity указывает политику фильтра подключений, которую требуется изменить. Вы можете использовать любое уникальное значение, определяющее политику. Например:
- имя;
- различающееся имя (DN);
- GUID
Как правило, у вас есть только одна политика фильтра подключений: политика по умолчанию с именем Default.
| Type: | HostedConnectionFilterPolicyIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-IPAllowList
Параметр 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 не поддерживаются.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-IPBlockList
Параметр 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 не поддерживаются.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-MakeDefault
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-WhatIf
Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
Входные данные
Input types
Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.
Выходные данные
Output types
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по