Применимо к: Exchange Server 2010 SP1

Последнее изменение раздела: 2011-04-23

Командлет Test-OwaConnectivity используется для проверки работоспособности приложения Microsoft Office Outlook Web App. Командлет Test-OwaConnectivity можно использовать для проверки возможности подключения к приложению Outlook Web App для всех виртуальных каталогов Microsoft Exchange Server 2010 на указанном сервере клиентского доступа для всех почтовых ящиков на серверах Exchange на том же сайте Служба каталогов Active Directory. Командлет Test-OwaConnectivity также можно применять для проверки возможности подключения к отдельному URL-адресу Exchange Outlook Web App.

Синтаксис


Test-OwaConnectivity [-ClientAccessServer <ServerIdParameter>] [-AllowUnsecureAccess <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-LightMode <SwitchParameter>] [-MailboxServer <ServerIdParameter>] [-MonitoringContext <SwitchParameter>] [-ResetTestAccountCredentials <SwitchParameter>] [-RSTEndpoint <String>] [-TestType <Internal \| External>] [-Timeout <UInt32>] [-TrustAnySSLCertificate <SwitchParameter>] [-VirtualDirectoryName <String>] [-WhatIf [<SwitchParameter>]]

Test-OwaConnectivity [-ClientAccessServer
<ServerIdParameter>] [-AllowUnsecureAccess
<SwitchParameter>] [-Confirm [<SwitchParameter>]]
[-DomainController <Fqdn>] [-LightMode
<SwitchParameter>] [-MailboxServer <ServerIdParameter>]
[-MonitoringContext <SwitchParameter>]
[-ResetTestAccountCredentials <SwitchParameter>]
[-RSTEndpoint <String>] [-TestType <Internal |
External>] [-Timeout <UInt32>] [-TrustAnySSLCertificate
<SwitchParameter>] [-VirtualDirectoryName <String>]
[-WhatIf [<SwitchParameter>]]


`Test-OwaConnectivity -URL <String> -MailboxCredential <PSCredential> [-AllowUnsecureAccess <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-LightMode <SwitchParameter>] [-ResetTestAccountCredentials <SwitchParameter>] [-Timeout <UInt32>] [-TrustAnySSLCertificate <SwitchParameter>] [-WhatIf [<SwitchParameter>]]`

Параметры

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

MailboxCredential

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

System.Management.Automation.PSCredential

Параметр MailboxCredential указывает учетные данные почтового ящика для единичной проверки URL-адреса.

Параметр MailboxCredential необходим только при использовании параметра URL.

URL

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

System.String

Параметр URL указывает проверяемый URL-адрес. Этот параметр требуется, только если необходимо проверить единичный URL-адрес Outlook Web App.

При использовании этого параметра также необходимо указать параметр MailboxCredential.

Параметр URL нельзя использовать вместе с параметрами TestType или ClientAccessServer.

AllowUnsecureAccess

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

System.Management.Automation.SwitchParameter

Параметр AllowUnsecureAccess указывает, проверяются ли виртуальные каталоги, не требующие протокола SSL. Если параметр AllowUnsecureAccess указан, разрешена проверка виртуальных каталогов, не требующих SSL. Если этот параметр не указан, команда пропускает виртуальные каталоги, не требующие протокола SSL, и создается ошибка.

ClientAccessServer

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

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Параметр ClientAccessServer указывает имя сервера клиентского доступа для проверки. Если этот параметр указан, все виртуальные каталоги Exchange Outlook Web App на сервере клиентского доступа будут проверяться для всех серверов почтовых ящиков Exchange на локальном сайте Служба каталогов Active Directory.

Нельзя использовать этот параметр с параметром URL.

Confirm

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

System.Management.Automation.SwitchParameter

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

Параметр DomainController указывает имя FQDN контроллера домена, получающего данные из Служба каталогов Active Directory.

LightMode

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

System.Management.Automation.SwitchParameter

Параметр LightMode не реализован для этой команды диагностики. Использование этого параметра не влияет на работу команды.

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

MailboxServer

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

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Параметр MailboxServer указывает имя проверяемого сервера почтовых ящиков. Если параметр не указан, проверяются все серверы почтовых ящиков на локальном сайте Служба каталогов Active Directory.

MonitoringContext

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

System.Management.Automation.SwitchParameter

Параметр MonitoringContext отображает сведения, возвращенные в System Center Operations Manager 2007. При выполнении диспетчером Operations Manager 2007 командлета Test-OwaConnectivity требуется возвращение дополнительных сведений. Установив для этого параметра значение $true, можно просмотреть точные сведения, которые будут возвращены в Operations Manager 2007. Этот параметр используется только в информационных целях и не влияет на работу Operations Manager 2007.

ResetTestAccountCredentials

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

System.Management.Automation.SwitchParameter

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

RSTEndpoint

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

System.String

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

TestType

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

Microsoft.Exchange.Monitoring.OwaConnectivityTestType

Параметр TestType указывает, будет ли команда проверять внутренние или внешние URL-адреса. Значения параметра: Internal и External. Этот параметр нельзя использовать вместе с параметром URL. Если не указан ни параметр TestType, ни параметр URL, по умолчанию используется значение TestType:Internal

Timeout

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

System.UInt32

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

TrustAnySSLCertificate

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

System.Management.Automation.SwitchParameter

Параметр TrustAnySSLCertificate указывает, нужно ли проверять внутренний URL-адрес без создания сообщения об ошибке проверки сертификата SSL. Параметр TrustAnySSLCertificate не создает отчет об ошибках проверки сертификата SSL. Это полезно при проверке внутренних URL-адресов, так как службы IIS не поддерживают назначение нескольких сертификатов одному виртуальному каталогу. Если у каталога разные адреса для внутреннего и внешнего доступа и имеется сертификат, то этот сертификат обычно относится к внешнему URL-адресу. Этот параметр обеспечивает проверку внутреннего URL-адреса без возникновения ошибки в случае несоответствия сертификата URL-адресу.

VirtualDirectoryName

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

System.String

Параметр VirtualDirectoryName задает имя проверяемого виртуального каталога на конкретном сервере клиентского доступа. Если этот параметр не указан, будут проверены все виртуальные каталоги Exchange Outlook Web App, которые поддерживают почтовые ящики Exchange.

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

Командлет Test-OwaConnectivity используется для проверки возможности подключения всех виртуальных каталогов Exchange Outlook Web App на сервере клиентского доступа или для проверки возможности подключения отдельного URL-адреса Exchange Outlook Web App.

Для проверки всех виртуальных каталогов Exchange Outlook Web App на сервере клиентского доступа требуется тестовая учетная запись Служба каталогов Active Directory. На каждом сайте Служба каталогов Active Directory с размещенными почтовыми ящиками также должен находиться тестовый почтовый ящик, к которому можно получить доступ через проверяемые виртуальные каталоги. Если при установке сервера почтовых ящиков не была создана тестовая среда, то при выполнении командлета Test-OwaConnectivity отобразится запрос на запуск сценария, который создает тестовые почтовые ящики и тестовых пользователей.

Если сервер, на котором размещен тестовый почтовый ящик, недоступен, командлет Test-OwaConnectivity возвращает ошибку, по которой в некоторых случаях нельзя четко определить проблему. Чтобы избежать этого, перед выполнением командлета Test-OwaConnectivity убедитесь, что сервер, на котором размещен тестовый почтовый ящик, запущен, а почтовый ящик доступен. Для этого используется командлетTest-MapiConnectivity.

Если для командлета Test-OwaConnectivity на сервере клиентского доступа не указаны параметры ClientAccessServer или URL, командлет проверяет сервер, на котором он выполняется. Для проверки конкретного сервера клиентского доступа необходимо использовать параметр ClientAccessServer.

Чтобы проверить отдельный URL-адрес, запустите командлет Test-OwaConnectivity, используя параметр URL и учетные данные существующего почтового ящика Exchange. Если URL-адрес находится за подсистемой балансировки нагрузки, невозможно предсказать, какой сервер клиентского доступа будет проверяться командой. Поскольку при использовании параметра URL необходимо указывать учетные данные, для выполнения командлета Test-OwaConnectivity с параметром URL можно использовать любую учетную запись.

Если командлет обнаружит виртуальный каталог, для которого не требуется протокол SSL, этот каталог пропускается, если не задан параметр AllowUnsecureAccess. Если указан параметр AllowUnsecureAccess, при тестировании данные между серверами передаются в виде открытого текста.

Предусмотрена возможность выполнения командлета Test-OwaConnectivity в качестве однократной интерактивной задачи или в качестве запланированной задачи под управлением Microsoft System Center Operations Manager 2007. Для выполнения командлета Test-OwaConnectivity в качестве задачи System Center Operations Manager 2007 требуется наличие тестового почтового ящика клиентского доступа на всех проверяемых командлетом серверах почтовых ящиков.

Для запуска этого командлета необходимы соответствующие разрешения. В этом разделе перечислены все параметры командлета, однако некоторые из них могут быть недоступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях см. в разделе Запись «Виртуальные каталоги Outlook Web App» в разделе Разрешения клиентского доступа.

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

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

Ошибки

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

Исключения

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

Примеры

ПРИМЕР 1

В этом примере проверяется возможность подключения для URL-адреса https://mail.contoso.com/owa с использованием учетных данных пользователя contoso\kweku.

	Скопировать код
Test-OwaConnectivity -URL:https://mail.contoso.com/owa -MailboxCredential:(get-credential contoso\kweku)

ПРИМЕР 2

В этом примере выполняется проверка возможности подключения определенного сервера клиентского доступа Contoso12 и проверка всех виртуальных каталогов Exchange Outlook Web App, поддерживающих почтовые ящики Exchange. Проверка включает виртуальные каталоги, не требующие протокола SSL.

	Скопировать код
Test-OwaConnectivity -ClientAccessServer:Contoso12 -AllowUnsecureAccess