Командлет Add?IPBlockListProvider используется для создания новой конфигурации поставщика списка запрещенных IP-адресов на компьютере, на котором установлена роль транспортного сервера-концентратора или пограничного транспортного сервера.
Синтаксис
Add-IPBlockListProvider -Name <String> -LookupDomain <SmtpDomain> [-AnyMatch <$true | $false>] [-BitmaskMatch <IPAddress>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-IPAddressesMatch <MultiValuedProperty>] [-Priority <Int32>] [-RejectionResponse <AsciiString>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]] |
Параметры
Параметр | Обязательный | Тип | Описание |
---|---|---|---|
LookupDomain |
Обязательный |
Microsoft.Exchange.Data.SmtpDomain |
Имя домена, которое запрашивает агент фильтра подключений для обновленных данных списка заблокированных IP-адресов. |
Name |
Обязательный |
System.String |
Имя службы поставщика списка заблокированных IP-адресов. |
AnyMatch |
Необязательный |
System.Boolean |
Допустимое входное значение параметра Enabled —
|
BitmaskMatch |
Необязательный |
System.Net.IPAddress |
При конфигурировании параметра BitmaskMatch для использования IP-адреса агент фильтра подключений действует только в отношении сообщений, которые соответствуют коду состояния IP-адреса, возвращаемому службой поставщика списка заблокированных IP-адресов. |
Confirm |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр Confirm используется для приостановки команды и требует подтверждения ее выполнения. Указывать значение параметра Confirm не требуется. |
DomainController |
Необязательный |
Microsoft.Exchange.Data.Fqdn |
Чтобы указать полное доменное имя (FQDN) контроллера домена, записывающего это изменение конфигурации в службу каталогов Active Directory, включите в команду параметр DomainController. Параметр DomainController не поддерживается компьютерами, на которых установлена серверная роль «Граничный транспорт». Серверная роль «Граничный транспорт» записывает только локальный экземпляр ADAM. |
Enabled |
Необязательный |
System.Boolean |
Допустимое входное значение параметра Enabled —
|
IPAddressesMatch |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Когда параметр IPAddressesMatch сконфигурирован для использования IP-адреса, агент фильтра подключений действует только в отношении сообщений, соответствующих тому же коду состояния IP-адреса, который возвращается службой поставщика списка заблокированных IP-адресов. |
Priority |
Необязательный |
System.Int32 |
Установите параметр Priority, чтобы настроить порядок, в котором агент фильтра подключений запрашивает настроенные службы поставщика списка заблокированных IP-адресов. По умолчанию при каждом добавлении нового поставщика списка заблокированных IP-адресов записи назначается приоритет N+1, где N — количество настроенных служб поставщика списка заблокированных IP-адресов. Если установить параметр Priority в значение, которое совпадает со значением приоритета другой службы поставщика списка заблокированных IP-адресов, приоритет поставщика списка заблокированных IP-адресов, добавленный первым, увеличится на 1. |
RejectionResponse |
Необязательный |
Microsoft.Exchange.Data.AsciiString |
Параметр RejectionResponse принимает строку. Введите
текст сообщения, который требуется доставить в SMTP-сеансе
отправителям, чьи сообщения блокируются агентом фильтра
подключений, если служба поставщика списка заблокированных
IP-адресов соответствует IP-адресу отправителя. Рекомендуется
указать в ответе службу поставщика списка заблокированных
IP-адресов, чтобы легальные отправители могли связаться со службой
поставщика списка заблокированных IP-адресов. Аргумент не должен
превышать 240 знаков. При передаче аргумента параметр
RejectionResponse необходимо заключить в двойные кавычки,
если фраза содержит пробелы, как в следующем примере:
|
TemplateInstance |
Необязательный |
System.Management.Automation.PSObject |
Когда в этот параметр передается существующий объект, команда использует конфигурацию объекта для создания точной копии этого объекта на локальном или целевом сервере. |
WhatIf |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр WhatIf заставляет команду имитировать действия, которые она будет выполнять над объектом. С помощью параметра WhatIf можно просматривать изменения, которые могли бы произойти, без применения этих изменений. Указывать значение параметра WhatIf не требуется. |
Подробное описание
Конфигурация поставщика списка заблокированных IP-адресов используется агентом фильтра подключений.
Параметр Name и параметр LookupDomain являются обязательными. Если не передать обязательные параметры, среда управления Exchange выведет запрос на ввод этих параметров.
Для выполнения командлета Add-IPBlockListProvider используемой учетной записи необходимо делегировать следующую роль:
- роль администратора сервера Exchange Server и членство в
локальной группе администраторов на целевом сервере.
Чтобы выполнить командлет Add?IPBlockListProvider на компьютере, на котором установлена серверная роль пограничного транспортного сервера, необходимо войти в систему под учетной записью, принадлежащей локальной группе администраторов на этом компьютере.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования сервера Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.
Типы входных данных
Типы возвращаемых данных
Ошибки
Ошибка | Описание |
---|---|
|
Пример
В первом примере кода показана команда Add-IPBlockListProvider, которая имеет обязательные параметры. В примере также показано, как добавить нового поставщика списка заблокированных IP-адресов и установить ответ с отказом.
Во втором примере кода показана команда Add-IPBlockListProvider, имеющая обязательные параметры, и показано, как настроить значение битовой маски, возвращаемое от поставщика.
Копировать код | |
---|---|
Add-IPBlockListProvider -Name:Example -LookupDomain:Example.com -RejectionResponse "Originating IP addressed matched to Example.com's IP Block List provider service" Add-IPBlockListProvider -Name:Example -LookupDomain:Example.com -BitmaskMatch 127.1.0.1 |