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

Синтаксис

Add-IPAllowListEntry -IPRange <IPRange> [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ExpirationTime <DateTime>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
Add-IPAllowListEntry -IPAddress <IPAddress> [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ExpirationTime <DateTime>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

Параметры

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

IPAddress

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

System.Net.IPAddress

В список разрешенных IP-адресов можно добавить отдельный IP-адрес, как показано ниже: 192.168.0.1.

IPRange

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

Microsoft.Exchange.Data.IPRange

Можно добавить диапазон IP-адресов в список разрешенных IP-адресов, используя следующие форматы:

  • CIDR IP    Classless InterDomain Routing (бесклассовая междоменная маршрутизация). Например, 192.168.0.1/24.

  • IP Range   Например, 192.168.0.1-192.168.0.254

Comment

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

System.String

Этот параметр используется для создания примечаний администратора или напоминаний о данной конкретной записи. Значение параметра Comment необходимо заключить в прямые кавычки, например: "это примечание администратора".

Confirm

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

System.Management.Automation.SwitchParameter

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

ExpirationTime

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

System.DateTime

Можно задать день и время окончания действия создаваемого элемента списка разрешенных IP-адресов. Если задано только время, а дата не указана, предполагается текущий день. При вводе конкретной даты используйте краткий формат даты, определенный настроенными на локальном компьютере параметрами «Язык и региональные стандарты». Например, если для компьютера определено использование краткого формата даты мм/дд/гггг чч:мм:сс, то для того, чтобы задать в качестве срока окончания действия 11:00, 3 января 2007 года, введите следующие данные, заключенные в двойные кавычки: "1/3/2007 11:00".

Server

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

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

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

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

Если параметр IPAddress при запуске команды Add?IPAllowListEntry не указан, среда управления Exchange предложит ввести его. Обязательно использовать либо параметр IPAddress, либо параметр IPRange.

Примечание.
Если на компьютере с Windows Server 2008 установлен сервер Microsoft Exchange Server 2007 с пакетом обновления 1 (SP1), IP-адреса и диапазоны IP-адресов можно вводить в формате IP версии 4, IP версии 6 или в обоих форматах. Если система Windows Server 2008 установлена в конфигурации по умолчанию, поддержка протоколов IP версии 4 и IP версии 6 включена. Дополнительные сведения о поддержке адресов IP версии 6 в Exchange Server 2007 с пакетом обновления 1 (SP1) см. в разделе Поддержка протокола IP версии 6 в сервере Exchange Server 2007 с пакетом обновления 1 (SP1) и пакетом обновления 2 (SP2).

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

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

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

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

Входные типы

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

Ошибки

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

 

Пример

Первый пример кода показывает использование команды Add?IPAllowListEntry, добавляющей диапазон IP-адресов в список разрешенных IP-адресов для компьютера, на котором выполняется эта команда. Второй образец кода задает для этого же элемента списка IP-адресов срок окончания действия 23:59, 3 января 2007 г.

Копировать код
Add-IPAllowListEntry -IPRange:192.168.0.1/24 
Add-IPAllowListEntry -IPRange:192.168.0.1/24 -ExpirationTime "1/3/2007 23:59"