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

Синтаксис


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

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


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

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

Параметры

Параметр	Обязательный	Тип	Описание
Identity	Обязательный	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-адресов.
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.IPAllowListProvider	Параметр 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.
WhatIf	Необязательный	System.Management.Automation.SwitchParameter	При использовании параметра WhatIf команда имитирует действия над объектом, которые она будет выполнять. Параметр WhatIf позволяет узнать, какие изменения произойдут, не применяя их. Указывать значение параметра WhatIf не требуется.

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

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

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

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

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

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

Входные типы

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

Ошибки

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

Пример

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

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

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