Test-ActiveSyncConnectivity

Модуль:
Exchange PowerShell

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

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

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

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

Синтаксис

Default (По умолчанию) 

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 или к любому 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

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ClientAccessServer

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

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

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

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

Свойства параметров

Тип:ServerIdParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:1
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Confirm

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

  • Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
  • Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание параметра Confirm без значения приводит к паузе, которая вынуждает вас подтвердить команду перед продолжением.

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DomainController

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

Свойства параметров

Тип:Fqdn
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-LightMode

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

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

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

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-MailboxCredential

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

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

Свойства параметров

Тип:PSCredential
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-MailboxServer

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

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

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

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

Свойства параметров

Тип:ServerIdParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-MonitoringContext

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

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

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-MonitoringInstance

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ResetTestAccountCredentials

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

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

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Timeout

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

Свойства параметров

Тип:UInt32
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-TrustAnySSLCertificate

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

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

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-URL

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

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

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:1
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-UseAutodiscoverForClientAccessServer

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WhatIf

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.

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

Input types

Чтобы просмотреть типы входных данных, которые принимает этот командлет, см. Типы входных и выходных данных командлета. Если поле "Типы входных данных" для командлета пусто, командлет не принимает входные данные.

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

Output types

Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.