Test-WebServicesConnectivity

 

Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Последнее изменение раздела: 2010-08-18

Командлет Test-WebServicesConnectivity выполняет базовые операции проверки функциональности веб-служб Exchange на компьютере Microsoft Exchange Server 2007 с установленной ролью сервера клиентского доступа.

Синтаксис

Test-WebServicesConnectivity [-ClientAccessServer <ServerIdParameter>] [-AllowUnsecureAccess <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-LightMode <SwitchParameter>] [-MailboxCredential <PSCredential>] [-MailboxServer <ServerIdParameter>] [-MonitoringContext <SwitchParameter>] [-ResetTestAccountCredentials <SwitchParameter>] [-Site <AdSiteIdParameter>] [-Timeout <UInt32>] [-TrustAnySSLCertificate <SwitchParameter>] [-UseAutodiscoverForClientAccessServer <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

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

Командлет Test-WebServicesConnectivity используется для проверки функциональности веб-служб Exchange. В случае сбоя проверки в командной консоли Exchange выводится соответствующее сообщение.

Для выполнения командлета Test-WebServicesConnectivity используемой учетной записи необходимо делегировать роль администратора сервера Exchange и членство в локальной группе администраторов на целевом сервере.

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

Параметры

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

AllowUnsecureAccess

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

System.Management.Automation.SwitchParameter

Этот параметр позволяет командлету Test-WebServicesConnectivity продолжить выполнение по небезопасному каналу, не требующему протокола SSL.

ClientAccessServer

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

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Этот параметр указывает сервер клиентского доступа, используемый при выполнении командлета Test-WebServicesConnectivity.

Confirm

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

System.Management.Automation.SwitchParameter

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

Параметр DomainController указывает контроллер домена, используемый для записи данных изменений конфигурации в службу каталогов Active Directory. Укажите полное доменное имя необходимого контроллера домена.

LightMode

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

System.Management.Automation.SwitchParameter

Этот параметр для диагностического командлета Test-PopConnectivity не реализован. Использование этого параметра не влияет на работу командлета.

Примечание. Этот параметр реализован для других диагностических командлетов Exchange 2007. В частности, он используется в тех случаях, когда необходимо выполнить версию командлета, менее требовательную к ресурсам.

MailboxCredential

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

System.Management.Automation.PSCredential

Этот параметр указывает почтовый ящик, используемый при выполнении командлета Test-WebServicesConnectivity.

MailboxServer

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

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Этот параметр указывает идентификатор сервера почтовых ящиков Exchange 2007, на котором выполняется проверка.

MonitoringContext

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

System.Management.Automation.SwitchParameter

Этот параметр указывает, передаются ли результаты проверки Microsoft Operations Manager (MOM). Если для этого параметра задано значение $true, результаты передаются MOM. Если для этого параметра задано значение $false, результаты проверки отображаются только в командной строке.

ResetTestAccountCredentials

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

System.Management.Automation.SwitchParameter

Параметр ResetTestAccountCredentials сбрасывает пароль для тестовой учетной записи, используемой для выполнения этой команды. Пароль для тестовой учетной записи обычно сбрасывается каждые семь дней, если для управления средой Exchange используется средство Microsoft System Center Operations Manager. Установка этого флажка приводит к принудительному сбросу пароля в любой момент, когда это потребуется по причинам, связанным с безопасностью.

Site

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

Microsoft.Exchange.Configuration.Tasks.AdSiteIdParameter

Параметр Site указывает сайт Active Directory.

Timeout

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

System.UInt32

Параметр Timeout указывает время ожидания завершения операции тестирования в секундах. По умолчанию значение параметра Timeout составляет 300 секунд. Значение времени ожидания должно быть больше 0 секунд. Рекомендуется всегда устанавливать для данного параметра значение не менее 5 секунд.

TrustAnySSLCertificate

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

System.Management.Automation.SwitchParameter

Этот параметр позволяет использовать любой доступный сертификат SSL для выполнения проверки.

UseAutodiscoverForClientAccessServer

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

System.Management.Automation.SwitchParameter

Этот параметр указывает, следует ли при проверке использовать службу автообнаружения для поиска сервера клиентского доступа.

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

Ошибки

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

 

 

Исключения

Исключения Описание

 

 

Пример

В приведенном ниже примере кода выполняется проверка веб-служб Exchange на локальном сервере клиентского доступа. Этот код позволяет выполнять проверку с помощью небезопасного подключения, не требующего использования протокола SSL. Будет использована тестовая учетная запись по умолчанию.

Test-WebServicesConnectivity -AllowUnsecureAccess