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

Синтаксис

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

Параметры

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

Identity

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

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-адресов.

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-адресов.

Instance

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.IPBlockListProvider

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

IPAddressesMatch

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

Microsoft.Exchange.Data.MultiValuedProperty

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

LookupDomain

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

Microsoft.Exchange.Data.SmtpDomain

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

Name

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

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".

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

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

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

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

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

Типы ввода

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

Ошибки

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

 

Пример

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

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

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

Копировать код
Set-IPBlockListProvider -Identity Example.com -AnyMatch:$true 
Set-IPBlockListProvider -Identity Example.com -Priority 1