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

Синтаксис

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

Параметры

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

Identity

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

Microsoft.Exchange.Configuration.Tasks.IPAllowListProviderIdParameter

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

IPAddress

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

System.Net.IPAddress

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

Confirm

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

System.Management.Automation.SwitchParameter

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

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

Server

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

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

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

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

Чтобы выполнить командлет 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