Командлет 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. Использование этого параметра не влияет на работу командлета.
|
||
|
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 |
|