Командлет 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 — |
BitmaskMatch |
Дополнительно |
System.Net.IPAddress |
Если для параметра BitmaskMatch настроен IP-адрес, агент фильтра подключений обрабатывает только сообщения, которые соответствуют коду состояния IP-адреса, возвращенному службой поставщика списков заблокированных IP-адресов. |
DomainController |
Дополнительно |
Microsoft.Exchange.Data.Fqdn |
Чтобы указать полное доменное имя контроллера домена, записывающего это изменение конфигурации в службу каталогов Active Directory, включите в команду параметр DomainController. Параметр DomainController не поддерживается на компьютерах с установленной ролью пограничного транспортного сервера. Серверная роль «Граничный транспорт» записывает только локальный экземпляр ADAM. |
Включен |
Дополнительно |
System.Boolean |
Допустимое входное значение параметра Enabled — |
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 необходимо заключить в двойные кавычки, если фраза содержит пробелы, как в следующем примере: |
Типы входных данных
Типы возвращаемых данных
Ошибки
| Ошибка | Описание |
|---|---|
|
Пример
Следующие примеры фрагментов кода иллюстрируют выполнение двух команд Set-IPBlockListProvider.
В первом примере команда Set-IPBlockListProvider настраивает фильтр подключений таким образом, что служба поставщика списка блокируемых IP-адресов обрабатывает любое совпадение как действенное событие.
Во втором примере команда Set-IPBlockListProvider устанавливает приоритет существующей конфигурации равным 1.
Set-IPBlockListProvider -Identity Example.com -AnyMatch:$true
Set-IPBlockListProvider -Identity Example.com -Priority 1