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

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

  • Статья

 

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

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

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

Синтаксис

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

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

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

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

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

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

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

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

Параметры

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

Идентификатор

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

Microsoft.Exchange.Configuration.Tasks.IPAllowListProviderIdParameter

Параметр Identity может принимать строковое значение, которое является значением Name или идентификатором GUID.

AnyMatch

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

System.Boolean

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

BitmaskMatch

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

System.Net.IPAddress

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

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

Включен

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

System.Boolean

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

Instance

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.IPAllowListProvider

Параметр Instance позволяет передавать весь объект в команду для обработки. Главным образом он используется в сценариях, в которых в команду должен быть передан весь объект.

IPAddressesMatch

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

Microsoft.Exchange.Data.MultiValuedProperty

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

LookupDomain

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

Microsoft.Exchange.Data.SmtpDomain

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

Имя

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

System.String

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

Priority

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

System.Int32

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

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

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

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

Ошибки

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

 

Пример

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

Во втором примере кода показана команда Set-IPAllowListProvider, устанавливающая приоритет существующей конфигурации равным 1.

Set-IPAllowListProvider -Identity Example.com -AnyMatch:$true 
Set-IPAllowListProvider -Identity Example.com -Priority 1