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

Синтаксис

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

Параметры

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

AllowUnsecureAccess

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

System.Management.Automation.SwitchParameter

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

ClientAccessServer

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

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Этот параметр задает имя сервера клиентского доступа для проверки. Если параметр указан, все виртуальные каталоги Exchange 2007 Outlook Web Access на сервере клиентского доступа будут проверяться для всех серверов почтовых ящиков Exchange 2007 в локальном сайте Active Directory. Виртуальные каталоги Microsoft Exchange 2000 Server и Microsoft Exchange Server 2003 проверяться не будут. Почтовые ящики, не находящиеся на серверах почтовых ящиков Exchange 2007, не проверяются. Не допускается совместное использование этого параметра с параметром URL.

Confirm

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

System.Management.Automation.SwitchParameter

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

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

LightMode

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

System.Management.Automation.SwitchParameter

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

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

MailboxCredential

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

System.Management.Automation.PSCredential

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

MailboxServer

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

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

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

MonitoringContext

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

System.Management.Automation.SwitchParameter

При использовании этого параметра задача запускается в рамках расписания MOM. Задача, запущенная с этим параметром без MOM, завершится сбоем. При отсутствии этого параметра задача должна выполняться администратором в интерактивном режиме.

ResetTestAccountCredentials

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

System.Management.Automation.SwitchParameter

Этот параметр сбрасывает пароль для тестовой учетной записи, используемой для выполнения командлета. Пароль для тестовой учетной записи, как правило, сбрасывается каждые 7 дней. Используйте этот параметр для принудительного сброса пароля в любое время, когда это требуется по соображениям безопасности.

Site

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

Microsoft.Exchange.Configuration.Tasks.AdSiteIdParameter

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

TestType

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

Microsoft.Exchange.Monitoring.OwaConnectivityTestType

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

Timeout

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

System.UInt32

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

TrustAnySSLCertificate

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

System.Management.Automation.SwitchParameter

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

URL

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

System.String

Этот параметр задает URL-адрес Outlook Web Access для проверки. При использовании этого параметра проверяется только указанный URL-адрес. Не используйте параметр URL с параметром ClientAccessServer. Параметр URL нельзя использовать с параметром TestType.

VirtualDirectoryName

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

System.String

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

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

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

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

Для выполнения командлета Test-OwaConnectivity для проверки возможности подключения Outlook Web Access для всех виртуальных каталогов Exchange 2007 на сервере клиентского доступа, используемой учетной записи необходимо делегировать роль администратора сервера Exchange и членство в локальной группе администраторов на целевом сервере.

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

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

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

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

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

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

Ошибки

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

 

 

Исключения

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

 

 

Пример

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

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

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