Test-OwaConnectivity

Этот командлет доступен только в Exchange Server 2010 г.

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

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Test-OwaConnectivity
    [-URL] <String>
    -MailboxCredential <PSCredential>
    [-AllowUnsecureAccess]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-LightMode]
    [-ResetTestAccountCredentials]
    [-Timeout <UInt32>]
    [-TrustAnySSLCertificate]
    [-WhatIf]
    [<CommonParameters>]
Test-OwaConnectivity
    [[-ClientAccessServer] <ServerIdParameter>]
    [-MailboxServer <ServerIdParameter>]
    [-MonitoringContext]
    [-RSTEndpoint <String>]
    [-TestType <OwaConnectivityTestType>]
    [-VirtualDirectoryName <String>]
    [-AllowUnsecureAccess]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-LightMode]
    [-ResetTestAccountCredentials]
    [-Timeout <UInt32>]
    [-TrustAnySSLCertificate]
    [-WhatIf]
    [<CommonParameters>]

Описание

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

Чтобы протестировать все виртуальные каталоги 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-адреса, при использовании параметра URL можно использовать любую учетную запись для выполнения командлета Test-OwaConnectivity.

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

Командлет Test-OwaConnectivity можно запустить как одноразовую интерактивную задачу или как запланированную задачу в Майкрософт элемента управления System Center Operations Manager 2007. Чтобы выполнить командлет Test-OwaConnectivity в качестве задачи System Center Operations Manager 2007, тестовый почтовый ящик клиентского доступа должен быть доступен на серверах почтовых ящиков, с которыми тестирует командлет.

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

Test-OwaConnectivity -URL:https://mail.contoso.com/owa -MailboxCredential:(get-credential contoso\kweku)

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

Пример 2

Test-OwaConnectivity -ClientAccessServer:Contoso12 -AllowUnsecureAccess

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

Параметры

-AllowUnsecureAccess

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-ClientAccessServer

Этот параметр доступен только в Exchange Server 2010 г.

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

Не используйте этот параметр с параметром URL-адреса.

Type:ServerIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Confirm

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

  • Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
  • Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-DomainController

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-LightMode

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-MailboxCredential

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

Для значения этого параметра требуется командлет Get-Credential. Чтобы приостановить эту команду и получить приглашение для ввода учетных данных, используйте значение (Get-Credential). Или перед выполнением этой команды сохраните учетные данные в переменной (например,$cred = Get-Credential), а затем используйте имя переменной ($cred) для этого параметра. Для получения дополнительной информации см. Get-Credential.

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

Type:PSCredential
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-MailboxServer

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

Type:ServerIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-MonitoringContext

Параметр MonitoringContext включает в результаты связанные события мониторинга и данные счетчиков производительности. Для этого переключателя не требуется указывать значение.

Обычно события мониторинга и счетчики производительности включаются в результаты при передаче выходных данных в Microsoft System Center Operations Manager (SCOM).

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-ResetTestAccountCredentials

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-RSTEndpoint

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-TestType

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

Type:OwaConnectivityTestType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Timeout

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

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-TrustAnySSLCertificate

Параметр TrustAnySSLCertificate дает возможность системе Exchange принимать сертификаты из недоверенных центров сертификации (ЦС). Для этого переключателя не требуется указывать значение.

Параметр TrustAnySSLCertificate указывает, следует ли игнорировать сбои проверки SSL-сертификатов. Указывать значение для этого параметра необязательно.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-URL

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

Если этот параметр используется, также требуется параметр MailboxCredential.

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

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-VirtualDirectoryName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

Входные данные

Input types

Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.

Выходные данные

Output types

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.