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


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

 

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

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

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

Синтаксис

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

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

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

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

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

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

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

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

Параметры

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

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

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

Microsoft.Exchange.Configuration.Tasks.IPBlockListProviderIdParameter

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

AnyMatch

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

System.Boolean

Допустимое входное значение параметра Enabled$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.IPBlockListProvider

Параметр 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.

RejectionResponse

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

Microsoft.Exchange.Data.AsciiString

Параметр RejectionResponse принимает строку. Введите текст сообщения, который требуется доставить в SMTP-сеансе отправителям, чьи сообщения блокируются агентом фильтра подключений, если служба поставщика списка заблокированных IP-адресов соответствует IP-адресу отправителя. Рекомендуется указать в ответе службу поставщика списков заблокированных IP-адресов, чтобы доверенные отправители могли обратиться к службе поставщика. Аргумент не должен превышать 240 знаков. При передаче аргумента параметр RejectionResponse необходимо заключить в двойные кавычки, если фраза содержит пробелы, как в следующем примере: "Originating IP addresses matched to Example.com's IP Block List Provider service".

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

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

Ошибки

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

 

Пример

Следующие примеры фрагментов кода иллюстрируют выполнение двух команд Set-IPBlockListProvider.

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

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

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