Командлет 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 может быть
|
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 может быть
|
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 в двойные кавычки. Например:
|
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 |