Поделиться через


Командлет Add-IPAllowListProvider (окончательная первоначальная версия)

 

Применимо к: Exchange Server 2007

Последнее изменение раздела: 2007-06-06

Чтобы создать новую конфигурацию поставщика списков разрешенных IP-адресов на компьютере с установленной ролью пограничного транспортного сервера или транспортного сервера-концентратора передачи, используется командлет Add-IPAllowListProvider.

Синтаксис

Add-IPAllowListProvider -Name <String> -LookupDomain <SmtpDomain> [-AnyMatch <$true | $false>] [-BitmaskMatch <IPAddress>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-IPAddressesMatch <MultiValuedProperty>] [-Priority <Int32>] [-TemplateInstance <PSObject>]

Подробное описание

Конфигурация поставщика списков разрешенных IP-адресов используется агентом фильтра подключений.

Параметр Name и параметр LookupDomain являются обязательными. Если не передать обязательные параметры, среда управления Exchange выведет запрос на ввод этих параметров.

Для выполнения командлета Add-IPAllowListProvider используемой учетной записи необходимо делегировать следующие полномочия:

  • роль администратора сервера Exchange Server и членство в локальной группе администраторов на целевом сервере.

Чтобы выполнить командлет Add-IPAllowListProvider на компьютере с установленной ролью пограничного транспортного сервера, необходимо войти в систему с помощью учетной записи, являющейся членом локальной группы «Администраторы» данного компьютера.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования сервера Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.

Параметры

Параметр Обязательность Тип Описание

LookupDomain

Обязательность

Microsoft.Exchange.Data.SmtpDomain

Имя домена, которое агент фильтра подключений отбирает для обновления данных списка разрешенных IP-адресов.

Имя

Обязательность

System.String

Имя службы поставщика списков разрешенных IP-адресов.

AnyMatch

Дополнительно

System.Boolean

Допустимым значением параметра AnyMatch может быть $true или $false. Настройка по умолчанию — $false. Если для параметра AnyMatch установлено значение $true, агент фильтра подключений обрабатывает любой код состояния IP-адреса, возвращенный службой поставщика списков разрешенных IP-адресов, как совпадающий.

BitmaskMatch

Дополнительно

System.Net.IPAddress

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

DomainController

Дополнительно

Microsoft.Exchange.Data.Fqdn

Чтобы определить, какой контроллер домена записывает данное изменение конфигурации для данных настройки фильтрации подключений в Active Directory службу каталогов, включите в команду параметр DomainController. Если эта команда выполняется на компьютере, на котором установлена роль сервера «Граничный транспорт», параметр DomainController не поддерживается. Сервер «Граничный транспорт» выполняет запись только в локальный экземпляр ADAM.

Включен

Дополнительно

System.Boolean

Допустимое входное значение параметра Enabled$true или $false. Настройка по умолчанию — $true. Если для параметра Enabled установлено значение $true, агент фильтра подключений выполняет запрос в службе поставщика списков разрешенных IP-адресов согласно приоритету, установленному для данной конфигурации поставщика списков разрешенных IP-адресов.

IPAddressesMatch

Дополнительно

Microsoft.Exchange.Data.MultiValuedProperty

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

Priority

Дополнительно

System.Int32

Параметр Priority служит для настройки порядка выполнения запроса агентом фильтра подключений в ранее настроенных службах поставщика списков разрешенных IP-адресов. По умолчанию при каждом добавлении новой службы поставщика списков разрешенных IP-адресов операции назначается приоритет N+1, где N — число настроенных служб поставщика списков разрешенных IP-адресов.

Если параметру Priority присвоить такое же значение, как у другой службы поставщика списков разрешенных IP-адресов, приоритет службы поставщика списков разрешенных IP-адресов, добавленной первой, получает приращение на 1.

TemplateInstance

Дополнительно

System.Management.Automation.PSObject

Когда этому параметру передается существующий объект, команда использует настройку объекта для создания точной копии этого объекта на локальном или целевом сервере.

Типы входных данных

Типы возвращаемых данных

Ошибки

Ошибка Описание

 

 

Пример

В следующем примере кода показана команда Add-IPAllowListProvider с необходимыми параметрами: LookupDomain и Name.

Add-IPAllowListProvider -Name:Example -LookupDomain:Example.com