Командлет 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-адрес, как показано ниже: |
IPRange |
Обязательный |
Microsoft.Exchange.Data.IPRange |
Можно добавить диапазон IP-адресов в список разрешенных IP-адресов, используя следующие форматы:
|
Comment |
Необязательный |
System.String |
Этот параметр используется для создания примечаний администратора или напоминаний о данной конкретной записи. Значение параметра Comment необходимо заключить в прямые кавычки, например: "это примечание администратора". |
Confirm |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр Confirm используется для приостановки команды и требует подтверждения выполняемого ею действия. Указывать значение параметра Confirm не требуется. |
ExpirationTime |
Необязательный |
System.DateTime |
Можно задать день и время окончания действия создаваемого
элемента списка разрешенных IP-адресов. Если задано только время, а
дата не указана, предполагается текущий день. При вводе конкретной
даты используйте краткий формат даты, определенный настроенными на
локальном компьютере параметрами «Язык и региональные стандарты».
Например, если для компьютера определено использование краткого
формата даты мм/дд/гггг чч:мм:сс, то для того, чтобы задать
в качестве срока окончания действия 11:00, 3 января 2007 года,
введите следующие данные, заключенные в двойные кавычки:
|
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" |