Применимо к: Exchange Server 2010 SP1

Последнее изменение раздела: 2011-03-19

Командлет Test-PowerShellConnectivity используется для проверки правильной работы удаленной службы Windows PowerShell на целевом сервере клиентского доступа.

Синтаксис


Test-PowerShellConnectivity [-ClientAccessServer <ServerIdParameter>] [-Authentication <Default \| Basic \| Negotiate \| NegotiateWithImplicitCredential \| Credssp \| Digest \| Kerberos>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-MailboxServer <ServerIdParameter>] [-MonitoringContext <SwitchParameter>] [-ResetTestAccountCredentials <SwitchParameter>] [-TestType <Internal \| External>] [-TrustAnySSLCertificate <SwitchParameter>] [-VirtualDirectoryName <String>] [-WhatIf [<SwitchParameter>]]

Test-PowerShellConnectivity [-ClientAccessServer
<ServerIdParameter>] [-Authentication <Default | Basic |
Negotiate | NegotiateWithImplicitCredential | Credssp | Digest |
Kerberos>] [-Confirm [<SwitchParameter>]]
[-DomainController <Fqdn>] [-MailboxServer
<ServerIdParameter>] [-MonitoringContext
<SwitchParameter>] [-ResetTestAccountCredentials
<SwitchParameter>] [-TestType <Internal | External>]
[-TrustAnySSLCertificate <SwitchParameter>]
[-VirtualDirectoryName <String>] [-WhatIf
[<SwitchParameter>]]


`Test-PowerShellConnectivity -ConnectionUri <Uri> -TestCredential <PSCredential> [-Authentication <Default \| Basic \| Negotiate \| NegotiateWithImplicitCredential \| Credssp \| Digest \| Kerberos>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-MailboxServer <ServerIdParameter>] [-MonitoringContext <SwitchParameter>] [-ResetTestAccountCredentials <SwitchParameter>] [-TrustAnySSLCertificate <SwitchParameter>] [-WhatIf [<SwitchParameter>]]`

Test-PowerShellConnectivity -ConnectionUri <Uri>
-TestCredential <PSCredential> [-Authentication <Default |
Basic | Negotiate | NegotiateWithImplicitCredential | Credssp |
Digest | Kerberos>] [-Confirm [<SwitchParameter>]]
[-DomainController <Fqdn>] [-MailboxServer
<ServerIdParameter>] [-MonitoringContext
<SwitchParameter>] [-ResetTestAccountCredentials
<SwitchParameter>] [-TrustAnySSLCertificate
<SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Параметры

Параметр	Обязательность	Тип	Описание
ConnectionUri	Обязательный	System.Uri	Параметр ConnectionUri указывает код URI сервера клиентского доступа для проверки, например https://contoso.com/powershell. Если указан параметр ClientAccessServer, невозможно использовать параметр ConnectionUri.
TestCredential	Обязательный	System.Management.Automation.PSCredential	Параметр TestCredential указывает учетные данные, необходимые для подключения к серверу клиентского доступа. Этот параметр можно использовать, только если указан параметр ConnectionUri.
Authentication	Необязательный	System.Management.Automation.Runspaces.AuthenticationMechanism	Параметр Authentication указывает тип проверки подлинности, используемый при установке соединения. Можно использовать одно из следующих значений: `Default` `Basic` `Negotiate` `NegotiateWithImplicitCredential` `Credssp` `Digest` `Kerberos`
ClientAccessServer	Необязательный	Microsoft.Exchange.Configuration.Tasks.ServerIdParameter	Параметр ClientAccessServer указывает имя сервера клиентского доступа для проверки. Если указан параметр ConnectionUri, невозможно использовать параметр ClientAccessServer.
Confirm	Необязательный	System.Management.Automation.SwitchParameter
DomainController	Необязательный	Microsoft.Exchange.Data.Fqdn
MailboxServer	Необязательный	Microsoft.Exchange.Configuration.Tasks.ServerIdParameter	Параметр MailboxServer указывает имя проверяемого сервера почтовых ящиков. Если параметр не указан, проверяются все серверы почтовых ящиков на локальном сайте Служба каталогов Active Directory.
MonitoringContext	Необязательный	System.Management.Automation.SwitchParameter	Переключатель MonitoringContext указывает, запущена ли команда диспетчером Microsoft System Center Operations Manager 2007. Запуск команды с этим параметром без System Center Operations Manager 2007 приведет к сбою команды. При отсутствии этого параметра задачу необходимо выполнять в интерактивном режиме.
ResetTestAccountCredentials	Необязательный	System.Management.Automation.SwitchParameter	Параметр ResetTestAccountCredentials выполняет сброс учетных данных тестовой учетной записи, используемых этой командой.
TestType	Необязательный	Microsoft.Exchange.Monitoring.OwaConnectivityTestType	Параметр TestType указывает, необходимо ли команде выполнять проверку внутреннего или внешнего URL-адреса виртуального каталога. Этот параметр может использоваться только с параметром ClientAccessServer. Допустимые значения для этого параметра — «Внутренний» и «Внешний». По умолчанию установлено значение «Внутренний».
TrustAnySSLCertificate	Необязательный	System.Management.Automation.SwitchParameter	Параметр TrustAnySSLCertificate указывает, включены ли в отчет ошибки проверки сертификата SSL (Secure Sockets Layer). Этот параметр позволяет команде проверять возможность подключения службы Windows PowerShell без отображения сообщения об ошибке, когда сертификат не соответствует URL-адресу сервера клиентского доступа.
VirtualDirectoryName	Необязательный	System.String	Параметр VirtualDirectoryName указывает виртуальный каталог на сервере клиентского доступа для проверки. Параметр VirutalDirectoryName может использоваться только с параметром ClientAccessServer. Если параметр VirutalDirectoryName не указан, будет выполнена проверка всех виртуальных каталогов на сервере клиентского доступа.
WhatIf	Необязательный	System.Management.Automation.SwitchParameter

Подробное описание

Командлет Test-PowerShellConnectivity позволяет подключиться к серверу клиентского доступа для проверки правильной работы удаленной службы Windows PowerShell и возможности сервера клиентского доступа выполнять команды на удаленном сервере почтовых ящиков.

При запуске командлета Test-PowerShellConnectivity необходимо указать полное доменное имя (FQDN) сервера клиентского доступа для подключения с помощью параметра ClientAccessServer или универсальный код ресурса (URI) сервера клиентского доступа с помощью параметра ConnectionUri. Невозможно использовать оба параметра ClientAccessServer и ConnectionUri в одной команде.

При первом использовании командлета Test-PowerShellConnectivity с параметром ClientAccessServer, возможно, потребуется создать нового тестового пользователя. Чтобы создать нового тестового пользователя, используйте сценарий New-TestCasConnectivityUser.ps1.

Запись «Виртуальные каталоги PowerShell» в разделе Разрешения инфраструктуры Exchange и командной консоли.

Типы входных данных

Типы возвращаемых данных

Ошибки

Ошибка	Описание

Примеры

ПРИМЕР 1

В этом примере выполняется проверка виртуального каталога PowerShell (веб-сайт по умолчанию) на сервере CAS2. Переключатель TrustAnySSLCertificate используется для пропуска проверки сертификата при подключении. Может потребоваться использовать сценарий New-TestCasConnectivityUser.ps1 для создания тестового пользователя, которого команда может использовать для проверки виртуального каталога Windows PowerShell.

	Скопировать код
Test-PowerShellConnectivity -ClientAccessServer CAS2 -VirtualDirectoryName "PowerShell (Default Web Site)" -TrustAnySSLCertificate

ПРИМЕР 2

В этом примере выполняется проверка удаленного виртуального каталога Windows PowerShell с URI https://contoso.com/powershell. Так как SSL-сертификат должен быть допустим, переключатель TrustAnySSLCertificate не используется. Удаленный сервер использует проверку подлинности Basic, поэтому для параметра Authentication используется значение «Basic».

Перед началом проверки необходимо получить учетные данные для подключения к удаленному виртуальному каталогу Windows PowerShell. Следующая команда получает учетные данные от пользователя, выполняющего проверку, с помощью командлета Get-Credential и сохраняет их в переменной $UserCredentials.

	Скопировать код
$UserCredentials = Get-Credential

Затем запускается проверка с помощью командлета Test-PowerShellConnectivity с описанными выше параметрами.

	Скопировать код
Test-PowerShellConnectivity -ConnectionUri https://contoso.com/powershell -TestCredential $UserCredentials -Authentication Basic