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

Синтаксис

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

Параметры

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

LookupDomain

Обязательный

Microsoft.Exchange.Data.SmtpDomain

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

Name

Обязательный

System.String

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

AnyMatch

Необязательный

System.Boolean

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

BitmaskMatch

Необязательный

System.Net.IPAddress

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

Confirm

Необязательный

System.Management.Automation.SwitchParameter

Параметр Confirm используется для приостановки команды и требует подтверждения ее выполнения. Значение параметра Confirm указывать не требуется.

DomainController

Необязательный

Microsoft.Exchange.Data.Fqdn

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

Enabled

Необязательный

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

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

WhatIf

Необязательный

System.Management.Automation.SwitchParameter

Параметр WhatIf заставляет команду имитировать действия, которые она будет выполнять над объектом. С помощью параметра WhatIf можно просматривать изменения, которые могли бы произойти, без применения этих изменений. Указывать значение параметра WhatIf не требуется.

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

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

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

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

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

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

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

Типы ввода

Возвращаемые типы

Ошибки

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

 

 

Пример

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

Копировать код
Add-IPAllowListProvider -Name:Example -LookupDomain:Example.com