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

Синтаксис


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


Add-IPBlockListEntry -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-адреса следующих форматов. IP-адрес CIDR (Classless InterDomain Routing — бесклассовая междоменная маршрутизация). Например, `192.168.0.1/24` IP-диапазон Например, `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-IPBlockListEntry, включите в команду параметр Server . Если параметр Server не указан, команда выполняется на локальном сервере. Использовать этот командлет для удаленной настройки других пограничных транспортных серверов нельзя.
WhatIf	Необязательный	System.Management.Automation.SwitchParameter	Параметр WhatIf заставляет команду имитировать действия, которые она будет выполнять над объектом. С помощью параметра WhatIf можно просматривать изменения, которые могли бы произойти, без применения этих изменений. Указывать значение параметра WhatIf не требуется.

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

Если параметр IPAddress не указан при запуске командлета Add-IPBlockListEntry, командная консоль 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 2007 с пакетом обновления 1 см. в разделе Поддержка протокола IP версии 6 в сервере Exchange Server 2007 с пакетом обновления 1 (SP1) и пакетом обновления 2 (SP2).

Примечание.

Если на компьютере с 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 2007 с пакетом обновления 1 см. в разделе Поддержка протокола IP версии 6 в сервере Exchange Server 2007 с пакетом обновления 1 (SP1) и пакетом обновления 2 (SP2).

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

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

Для запуска командлета Add-IPBlockListEntry на компьютере, на котором установлена роль пограничного транспортного сервера, необходимо войти в систему с использованием учетной записи, входящей в локальную группу «Администраторы» на том же компьютере.

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

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

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

Ошибки

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

Пример

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

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