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

Синтаксис

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

Параметры

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

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

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

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 не указан, команда выполняется на локальном сервере, где выполняется задача.

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

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

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

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

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

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

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

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

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

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