Поделиться через

Test-ActiveSyncConnectivity

  • Ссылка
Модуль:
ExchangePowerShell
Применяется к:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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

Используйте командлет Test-ActiveSyncConnectivity для проверки подключения к виртуальным каталогам Microsoft Exchange ActiveSync.

Примечание: этот командлет оптимальным образом работает с Exchange 2010. В более поздних версиях Exchange функциональность этого командлета была заменена управляемой доступностью. Для получения наилучших результатов используйте командлет Invoke-MonitoringProbe и укажите соответствующий активный зонд мониторинга вместо использования этого командлета.

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

Синтаксис

Test-ActiveSyncConnectivity
    [[-ClientAccessServer] <ServerIdParameter>]
    [[-URL] <String>]
    [-AllowUnsecureAccess]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-LightMode]
    [-MailboxCredential <PSCredential>]
    [-MailboxServer <ServerIdParameter>]
    [-MonitoringContext]
    [-MonitoringInstance <String>]
    [-ResetTestAccountCredentials]
    [-Timeout <UInt32>]
    [-TrustAnySSLCertificate]
    [-UseAutodiscoverForClientAccessServer]
    [-WhatIf]
    [<CommonParameters>]

Описание

Командлет Test-ActiveSyncConnectivity проверяет подключение Exchange ActiveSync путем подключения к указанному виртуальному каталогу Exchange ActiveSync, ко всем виртуальным каталогам Exchange ActiveSync на указанном сервере Exchange Server или к любому Exchange ActiveSync виртуальные каталоги, доступные на локальном сайте Active Directory.

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

& $env:ExchangeInstallPath\Scripts\New-TestCasConnectivityUser.ps1

Результаты проверки отображаются на экране. Командлет вернет следующую информацию:

  • CasServer — сервер Exchange, к которому подключен клиент.
  • LocalSite — имя локального сайта Active Directory.
  • Scenario — проверяемые действия. Значения: Options, FolderSync, First Sync, GetItemEstimate, Sync Data, Ping и Sync Test Item.
  • Результат. Возвращаемые значения обычно: Успешно, Пропущено или Сбой.
  • Latency(MS) — время, необходимое для выполнения проверки (в миллисекундах).
  • Error — любые появившиеся сообщения об ошибках.

Результаты можно записать в файл, перенаписав выходные данные в ConvertTo-Html и Set-Content. Пример: Test-ActiveSyncConnectivity -ClientAccessServer MBX01 | ConvertTo-Html | Set-Content -Path "C:\My Documents\EAS Test.html".

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

Примеры

Пример 1

Test-ActiveSyncConnectivity -ClientAccessServer MBX01

В этом примере проверяется Exchange ActiveSync клиентское подключение для сервера с именем MBX01.

Пример 2

Test-ActiveSyncConnectivity -UseAutodiscoverForClientAccessServer $true -URL "https://contoso.com/mail" -MailboxCredential (Get-Credential pauls@contoso.com)

В этом примере проверяется подключение Exchange ActiveSync для почтового ящика PaulS с помощью URL-адреса автообнаружения.

Параметры

-AllowUnsecureAccess

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

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

-ClientAccessServer

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

Можно использовать любое значение, однозначно определяющее сервер. Примеры:

  • имя;
  • различающееся имя (DN);
  • ExchangeLegacyDN
  • GUID

Этот параметр не может использоваться вместе с параметром Url.

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

-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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-LightMode

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

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

Если этот параметр не используется, выполняются также тесты Первая синхронизация, GetItemEstimate, Синхронизация данных, Ping и Синхронизировать тестовый элемент.

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

-MailboxCredential

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

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

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

-MailboxServer

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

Параметр MailboxServer указывает сервер почтовых ящиков exExchange2k16 или exExchange2k13, который необходимо протестировать. Примеры:

  • имя;
  • различающееся имя (DN);
  • ExchangeLegacyDN
  • GUID

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

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

-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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MonitoringInstance

Параметр MonitoringInstance задает идентификатор для этой задачи при выполнении теста из Microsoft System Center Operations Manager (SCOM). Этот параметр играет важную роль, так как SCOM может выполнять одновременно несколько экземпляров теста на одном сервере.

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

-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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Timeout

Параметр Timeout указывает время ожидания ответа команды (в секундах).

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

-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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-URL

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

Этот параметр не может использоваться вместе с параметром ClientAccessServer.

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

-UseAutodiscoverForClientAccessServer

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

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

-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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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

Input types

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

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

Output types

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