Set-IPAllowListProvider
Этот командлет доступен или действует только на пограничных транспортных серверах в локальной среде Exchange.
Командлет Set-IPAllowListProvider используется для изменения конфигурации поставщика списков разрешенных IP-адресов, которая используется агентом фильтрации подключений на пограничном транспортном сервере.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Set-IPAllowListProvider
[-Identity] <IPAllowListProviderIdParameter>
[-AnyMatch <Boolean>]
[-BitmaskMatch <IPAddress>]
[-Confirm]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-IPAddressesMatch <MultiValuedProperty>]
[-LookupDomain <SmtpDomain>]
[-Name <String>]
[-Priority <Int32>]
[-WhatIf]
[<CommonParameters>] Описание
На пограничных транспортных серверах для запуска этого командлета необходимо быть членом группы локальных администраторов.
Примеры
Пример 1
Set-IPAllowListProvider Contoso.com -AnyMatch $trueВ этом примере поставщик списков разрешенных IP-адресов под названием Contoso.com настраивается таким образом, чтобы разрешить подключение с IP-адреса, если возвращаются коды его состояния.
Пример 2
Set-IPAllowListProvider Contoso.com -Priority 1В этом примере задается приоритет 1 для существующего поставщика списка разрешенных IP-адресов Contoso.com.
Параметры
-AnyMatch
Параметр AnyMatch указывает, рассматривается ли в качестве соответствия какой-либо ответ поставщика списка разрешенных адресов. Для этого параметра допускаются значения $true и $false. Значение по умолчанию — $false. Если для этого параметра задано значение $true, а при фильтрации подключений IP-адрес подключающегося SMTP-сервера отправляется поставщику списка разрешенных IP-адресов, то при возврате любого кода ответа поставщиком списка разрешенных IP-адресов фильтрация подключений разрешает сообщения из этого источника.
| 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 |
-BitmaskMatch
Параметр BitmaskMatch указывает код состояния битовой маски, возвращаемый поставщиком списка разрешенных адресов. Используйте этот параметр, если поставщик списка разрешенных адресов возвращает ответы битовой маски. Допустимым значением ввода для этого параметра является отдельный IP-адрес в формате 127.0.0.1.
| Type: | IPAddress |
| 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 |
-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.
Параметр DomainController не поддерживается пограничными транспортными серверами. Пограничный транспортный сервер использует локальный экземпляр службы Active Directory облегченного доступа к каталогам (AD LDS) для чтения и записи данных.
| 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 указывает, выполняет ли агент фильтра подключений запрос к службе поставщика списков разрешенных IP-адресов согласно приоритету, установленному для этой конфигурации поставщика списков разрешенных IP-адресов. Для этого параметра допускаются значения $true и $false. Значение по умолчанию — $true. По умолчанию агент фильтра подключений по умолчанию выполняет запросы к службе поставщика списков разрешенных IP-адресов согласно приоритету, установленному для данной конфигурации поставщика списков разрешенных IP-адресов.
| 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 |
-Identity
Параметр Identity указывает поставщика списков разрешенных IP-адресов, которого требуется изменить. Можно использовать любое уникальное значение, определяющее поставщика белых списков IP-адресов. Например:
- имя;
- различающееся имя (DN);
- GUID
| Type: | IPAllowListProviderIdParameter |
| 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 |
-IPAddressesMatch
Параметр IPAddressesMatch указывает коды состояния IP-адресов, возвращаемые поставщиком списка разрешений. Используйте этот параметр, если поставщик списка разрешенных возвращает IP-адрес или ответы записи A. Допустимые входные данные для этого параметра один или несколько IP-адресов в формате 127.0.0.1.
Чтобы ввести несколько значений и перезаписать все существующие записи, используйте следующий синтаксис: 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 |
-LookupDomain
Параметр LookupDomain указывает имя узла, необходимое для использования поставщика списка разрешенных адресов. При фильтрации подключений IP-адрес подключающегося SMTP-сервера отправляется указанному значению имени узла. Пример значения — allowlist.spamservice.com. Поставщик списка разрешенных адресов предоставляет необходимое фактическое значение.
| Type: | SmtpDomain |
| 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 |
-Name
Параметр Name указывает описательное имя поставщика списка разрешенных IP-адресов.
| Type: | String |
| 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 |
-Priority
Параметр Priority указывает порядок выполнения агентом фильтра подключений запросов к ранее настроенным поставщикам списков разрешенных IP-адресов. По умолчанию при добавлении каждой новой службы поставщика списков разрешенных IP-адресов элементу назначается приоритет N+1, где N — это число настроенных поставщиков списков разрешенных IP-адресов.
Если присвоить параметру Priority то же значение, что и у другого поставщика списков разрешенных IP-адресов, приоритет поставщика списков разрешенных IP-адресов, добавленного первым, получает приращение на 1.
| Type: | Int32 |
| 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
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.