Командлет 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 может быть |
BitmaskMatch |
Дополнительно |
System.Net.IPAddress |
Если для параметра IPAddressesMatch настроен IP-адрес, агент фильтра подключений обрабатывает только сообщения, которые соответствуют коду состояния IP-адреса, возвращенному службой поставщика списков разрешенных IP-адресов. |
DomainController |
Дополнительно |
Microsoft.Exchange.Data.Fqdn |
Чтобы определить, какой контроллер домена записывает данное изменение конфигурации для данных настройки фильтрации подключений в Active Directory службу каталогов, включите в команду параметр DomainController. Если эта команда выполняется на компьютере, на котором установлена роль сервера «Граничный транспорт», параметр DomainController не поддерживается. Сервер «Граничный транспорт» выполняет запись только в локальный экземпляр ADAM. |
Включен |
Дополнительно |
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. |
TemplateInstance |
Дополнительно |
System.Management.Automation.PSObject |
Когда этому параметру передается существующий объект, команда использует настройку объекта для создания точной копии этого объекта на локальном или целевом сервере. |
Типы входных данных
Типы возвращаемых данных
Ошибки
| Ошибка | Описание |
|---|---|
|
|
Пример
В следующем примере кода показана команда Add-IPAllowListProvider с необходимыми параметрами: LookupDomain и Name.
Add-IPAllowListProvider -Name:Example -LookupDomain:Example.com