Поделиться через


Командлет Test-IPAllowListProvider (окончательная первоначальная версия)

 

Применимо к: Exchange Server 2007

Последнее изменение раздела: 2007-06-06

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

Синтаксис

Test-IPAllowListProvider -Identity <IPAllowListProviderIdParameter> -IPAddress <IPAddress> [-DomainController <Fqdn>] [-Server <ServerIdParameter>]

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

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

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

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

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

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

Параметры

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

Идентификатор

Обязательность

Microsoft.Exchange.Configuration.Tasks.IPAllowListProviderIdParameter

В качестве значения этого параметра введите имя поставщика списков разрешенных IP-адресов. Значение параметра Identity должно соответствовать значению либо параметра Name, либо параметра Identity (GUID) для тестируемого поставщика списков разрешения IP-адресов.

IPAddress

Обязательность

System.Net.IPAddress

Параметр IPAddress используется для проверки и тестирования настроенных поставщиков списков разрешения IP-адресов.

DomainController

Дополнительно

Microsoft.Exchange.Data.Fqdn

Чтобы указать полное доменное имя (FQDN) контроллера домена, записывающего это изменение конфигурации в службу каталогов Active Directory, включите в команду параметр DomainController. Параметр DomainController не поддерживается компьютерами, на которых установлена серверная роль «Граничный транспорт». Серверная роль «Граничный транспорт» записывает только локальный экземпляр ADAM.

Server (сервер)

Дополнительно

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

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

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

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

Выход Описание

Allow List Provider

Allow List Provider возвращает объект поставщика списков разрешенных IP-адресов, хранящийся в локальном каталоге ADAM или в службе каталогов Active Directory.

Connected

Connected возвращает следующие значения: True или False.

  • True —  тест возможности доступа проходит успешно.

  • False — тест возможности доступа не проходит.

Matched

Matched возвращает следующие значения: True или False.

  • True. Параметр IPAddress, переданный с командой Test‑IPAllowListProvider, соответствует IP-адресу поставщика списка разрешенных IP-адресов.

  • False. Параметр IPAddress, переданный с командой Test-IPAllowListProvider, не соответствует IP-адресу поставщика списка разрешенных IP-адресов.

ProviderResult

ProviderResult возвращает IP-адрес, отражающий, по данным поставщика списков разрешенных IP-адресов, состояние параметра IPAddress, переданного в команде Test‑IPAllowListProvider. Чтобы определить значение возвращенного IP-адреса, обратитесь к своему поставщику списков разрешенных IP-адресов.

Ошибки

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

Недостаточные разрешения.

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

Не удается подключиться к ADAM.

Если эта задача выполняется с компьютера, на котором установлена роль сервера «Граничный транспорт», убедитесь, что на локальном компьютере работает служба ADAM (MsExchangeAdam). Если эта задача выполняется с компьютера, на котором установлена роль сервера «Узловой транспорт», убедитесь, что компьютер может подключиться к Active Directory.

Невозможно подключиться к поставщику списков разрешенных IP-адресов

Обратитесь к своему поставщику списков разрешенных IP-адресов.

Пример

В следующем примере кода показано использование команды Test‑IPAllowListProvider с обязательными параметрами. Эта команда проверяет возможность подключения к вымышленному поставщику списков разрешенных IP-адресов с именем, а затем отправляет этому поставщику запрос поиска.

Test-IPAllowListProvider -IPAddress 192.168.0.1 -Provider ExampleProviderName