Add-IPBlockListProvider
Этот командлет доступен или действует только на пограничных транспортных серверах в локальной среде Exchange.
Командлет Add-IPBlockListProvider позволяет создать поставщиков списков заблокированных IP-адресов, которые использует агент фильтра подключений на пограничных транспортных серверах.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (По умолчанию)
Add-IPBlockListProvider
[-Name] <String>
-LookupDomain <SmtpDomain>
[-AnyMatch <Boolean>]
[-BitmaskMatch <IPAddress>]
[-Confirm]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-IPAddressesMatch <MultiValuedProperty>]
[-Priority <Int32>]
[-RejectionResponse <AsciiString>]
[-WhatIf]
[<CommonParameters>]
Описание
На пограничных транспортных серверах для запуска этого командлета необходимо быть членом группы локальных администраторов.
Примеры
Пример 1
Add-IPBlockListProvider -Name "Contoso.com Block List" -LookupDomain blocklist.contoso.com -RejectionResponse "Source IP address is listed at the Contoso.com block list provider"
В этом примере добавляется поставщик списка заблокированных IP-адресов, а также настраивается ответ отклонения. Поставщик списка заблокированных IP-адресов предоставляет значение параметра LookupDomain.
Пример 2
Add-IPBlockListProvider -Name "Fabrikam.com Block List" -LookupDomain blocklist.fabrikam.com -BitmaskMatch 127.1.0.1
В этом примере добавляется поставщик списка заблокированных IP-адресов, а также настраивается возвращаемое поставщиком значение битовой маски. Поставщик списка заблокированных IP-адресов предоставляет значения параметров LookupDomain и BitmaskMatch.
Параметры
-AnyMatch
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр AnyMatch указывает, рассматривается ли в качестве соответствия какой-либо ответ поставщика списка заблокированных IP-адресов. Для этого параметра допускаются значения $true и $false. Значение по умолчанию — $false. Если для этого параметра задано значение $true, а при фильтрации подключений IP-адрес подключающегося SMTP-сервера отправляется поставщику списка заблокированных IP-адресов, то при возврате любого кода ответа поставщиком списка заблокированных IP-адресов фильтрация подключений блокирует сообщения из этого источника.
Свойства параметров
| Тип: | Boolean |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-BitmaskMatch
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр BitmaskMatch указывает код состояния битовой маски, возвращаемый поставщиком списка заблокированных адресов. Используйте этот параметр, если поставщик списка заблокированных адресов возвращает ответы битовой маски. Допустимым значением ввода для этого параметра является отдельный IP-адрес в формате 127.0.0.1.
Свойства параметров
| Тип: | IPAddress |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. То, как этот переключатель влияет на командлет, зависит от того, требует ли командлет подтверждения перед продолжением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание параметра Confirm без значения приводит к паузе, которая вынуждает вас подтвердить команду перед продолжением.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DomainController
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.
Параметр DomainController не поддерживается пограничными транспортными серверами. Пограничный транспортный сервер использует локальный экземпляр службы Active Directory облегченного доступа к каталогам (AD LDS) для чтения и записи данных.
Свойства параметров
| Тип: | Fqdn |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Enabled
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр Enabled указывает, используется ли при фильтрации подключений этот поставщик списка заблокированных IP-адресов. Для этого параметра допускаются значения $true и $false. Значение по умолчанию — $true. По умолчанию при фильтрации подключений используются новые созданные поставщики списков заблокированных IP-адресов.
Свойства параметров
| Тип: | Boolean |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IPAddressesMatch
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр IPAddressesMatch указывает коды состояния IP-адресов, которые возвращаются поставщиком списка блокировок. Используйте этот параметр, если поставщик списка блокировки возвращает ответы IP-адреса или записи A. Допустимые входные данные для этого параметра: один или несколько IP-адресов в формате 127.0.0.1. Вы можете ввести несколько IP-адресов, разделенных запятыми.
Свойства параметров
| Тип: | MultiValuedProperty |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-LookupDomain
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр LookupDomain указывает имя узла, необходимое для использования поставщика списка заблокированных IP-адресов. При фильтрации подключений IP-адрес подключающегося SMTP-сервера отправляется указанному значению имени узла. Пример значения — blocklist.spamservice.com. Поставщик списка заблокированных IP-адресов предоставляет необходимое фактическое значение.
Свойства параметров
| Тип: | SmtpDomain |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Name
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр Name указывает описательное имя поставщика списка заблокированных IP-адресов.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Priority
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр Priority указывает порядок, в котором агент фильтра подключений отправляет запросы поставщикам списков заблокированных IP-адресов. Целое значение с меньшим приоритетом соответствует более высокому приоритету. По умолчанию при каждом добавлении нового поставщика списка заблокированных IP-адресов записи назначается приоритет N+1, где N — количество настроенных служб поставщика списка заблокированных IP-адресов.
Если задать для параметра Priority значение, которое совпадает со значением приоритета другой службы поставщика списка заблокированных IP-адресов, то приоритет поставщика списка заблокированных IP-адресов, добавленный первым, увеличится на 1.
Свойства параметров
| Тип: | Int32 |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-RejectionResponse
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр RejectionResponse указывает текст, который необходимо включить в ответ отклонения SMTP, если при фильтрации подключений блокируются сообщения. Аргумент не должен превышать 240 знаков. Если значение содержит пробелы, его необходимо заключить в кавычки (").
В ответе всегда следует указывать поставщика списка заблокированных IP-адресов, чтобы доверенные отправители могли получить у него указания по удалению. Например, "Source IP address is listed at the Contoso.com block list provider".
Свойства параметров
| Тип: | AsciiString |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Переключатель 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
Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.