Test-PowerShellConnectivity

Модуль:
Exchange PowerShell

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

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

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

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

Синтаксис

URL 

Test-PowerShellConnectivity
    -ConnectionUri <Uri>
    -TestCredential <PSCredential>
    [-Authentication <AuthenticationMethod>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-MailboxServer <ServerIdParameter>]
    [-MonitoringContext]
    [-ResetTestAccountCredentials]
    [-TrustAnySSLCertificate]
    [-WhatIf]
    [<CommonParameters>]

Identity 

Test-PowerShellConnectivity
    [[-ClientAccessServer] <ServerIdParameter>]
    [-TestType <OwaConnectivityTestType>]
    [-VirtualDirectoryName <String>]
    [-Authentication <AuthenticationMethod>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-MailboxServer <ServerIdParameter>]
    [-MonitoringContext]
    [-ResetTestAccountCredentials]
    [-TrustAnySSLCertificate]
    [-WhatIf]
    [<CommonParameters>]

Описание

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

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

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

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

  • CasServer — сервер Exchange, к которому подключен клиент.
  • LocalSite — имя локального сайта Active Directory.
  • Scenario — проверяемые действия. Значения: Logon User.
  • Result — возвращаемые результаты. Обычно это Success (Успешно), Skipped (Пропущено) или Failure (Сбой).
  • Latency(MS) — время, необходимое для выполнения проверки (в миллисекундах).
  • Error — любые появившиеся сообщения об ошибках.

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

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

Примеры

Пример 1

Test-PowerShellConnectivity -ClientAccessServer MBX2 -VirtualDirectoryName "PowerShell (Default Web Site)" -TrustAnySSLCertificate

В этом примере выполняется проверка виртуального каталога PowerShell (веб-сайт по умолчанию) на сервере MBX2. Переключатель TrustAnySSLCertificate используется для пропуска проверки сертификата при подключении.

Пример 2

$UserCredentials = Get-Credential

Test-PowerShellConnectivity -ConnectionUri https://contoso.com/powershell -TestCredential $UserCredentials -Authentication Basic

В этом примере проверяется удаленный виртуальный каталог PowerShell, доступный по адресу https://contoso.com/powershell. Недопустимое несоответствие между сертификатом TLS и URL-адресом, поэтому коммутатор TrustAnySSLCertificate не используется. Виртуальный каталог настроен для использования базовой проверки подлинности.

Учетные данные, используемые для подключения к виртуальному каталогу, хранятся в переменной $UserCredentials. Затем запускается проверка, как описано выше.

Параметры

-Authentication

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

Параметр Authentication определяет тип проверки пользователя, используемый для подключения. Допустимые значения:

  • По умолчанию
  • Обычный
  • Credssp
  • Дайджест
  • Kerberos;
  • Вести переговоры

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

Тип:AuthenticationMethod
Значение по умолчанию: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

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

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

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

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

Identity
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

-ConnectionUri

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

Параметр ConnectionUri указывает URL-адрес удаленного виртуального каталога PowerShell для тестирования, например, https://contoso.com/powershell.

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

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

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

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

URL
Position:Named
Обязательно:True
Значение из конвейера: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

-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

-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

-TestCredential

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

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

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

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

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

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

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

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

-TestType

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

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

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

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

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

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

Identity
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

-VirtualDirectoryName

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

Параметр VirtualDirectoryName определяет имя удаленного виртуального каталога PowerShell, который необходимо проверить. Значения, содержащие пробелы, должны быть заключены в кавычки (").

Этот параметр может использоваться только с параметром ClientAccessServer. Если вы не используете этот параметр, все доступные удаленные виртуальные каталоги PowerShell на сервере проверяются.

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

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

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

Identity
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

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