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

Синтаксис

Remove-IPAllowListEntry -Identity <IPListEntryIdentity> [-Confirm [<SwitchParameter>]] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

Параметры

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

Identity

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

Microsoft.Exchange.Configuration.Tasks.IPListEntryIdentity

Необходимо указать параметр Identity удаляемого IP-адреса. При добавлении IP-адреса в список разрешенных IP-адресов параметр Identity автоматически увеличивается.

Confirm

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

System.Management.Automation.SwitchParameter

Параметр Confirm используется для приостановки команды и требует подтверждения ее выполнения. Указывать значение параметра Confirm не требуется.

Server

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

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

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

Использовать этот командлет для удаленной настройки других пограничных транспортных серверов нельзя.

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

Если не указать параметр Identity при запуске команды Remove-IPAllowListEntry, среда управления Exchange выведет запрос на ввод этого параметра.

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

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

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

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

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

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

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

Ошибки

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

 

Пример

В приведенных ниже примерах кода показана команда Remove-IPAllowListEntry, которая удаляет IP-адрес или диапазон IP-адресов из списка разрешенных IP-адресов для компьютера, на котором выполняется команда.

Пример 1

Следующий пример удаляет из списка разрешенных IP-адресов IP-адрес 192.168.0.100.

Копировать код 
Get-IPAllowListEntry | Where {$_.IPRange -eq '192.168.0.100'} | Remove-IPAllowListEntry
Пример 2

Следующий пример удаляет из списка разрешенных IP-адресов диапазон IP-адресов 192.168.0.0/24.

Копировать код 
Get-IPAllowListEntry | Where {$_.IPRange -eq '192.168.0.0/24'} | Remove-IPAllowListEntry
Примечание.
При использовании команды Remove-IPAllowListEntry необходимо указать атрибут Identity записи списка разрешенных IP-адресов. Атрибут Identity — целое значение, автоматически назначаемое при первом создании записи в списке разрешенных IP-адресов. Чтобы удалить определенный IP-адрес или диапазон адресов из списка разрешенных IP-адресов, можно воспользоваться выходными данными, возвращаемыми командой Get-IPAllowListEntry.
Копировать код 
Remove-IPAllowListEntry -Identity <Integer>