Test-WSMan
Проверяет, запущена ли служба удаленного управления Windows на локальном или удаленном компьютере.
Синтаксис
Test-WSMan
[[-ComputerName] <String>]
[-Authentication <AuthenticationMechanism>]
[-Port <Int32>]
[-UseSSL]
[-ApplicationName <String>]
[-Credential <PSCredential>]
[-CertificateThumbprint <String>]
[<CommonParameters>]
Описание
Этот командлет доступен только на платформе Windows.
Командлет Test-WSMan
отправляет запрос на идентификацию, который определяет, запущена ли служба WinRM на локальном или удаленном компьютере. Если на проверенном компьютере эта служба выполняется, командлет отображает схему удостоверений WS-Management, версию протокола, поставщика продукта и версию продукта протестированной службы.
Примеры
Пример 1. Определение состояния службы WinRM
Test-WSMan
Эта команда определяет, выполняется ли служба удаленного управления Windows на локальном или удаленном компьютере.
Пример 2. Определение состояния службы WinRM на удаленном компьютере
Test-WSMan -ComputerName "server01"
Эта команда определяет, запущена ли служба WinRM на компьютере server01.
Пример 3. Определение состояния службы WinRM и версии операционной системы
Test-WSMan -Authentication default
Эта команда проверяет, запущена ли служба WS-Management (WinRM) на локальном компьютере с помощью параметра проверки подлинности.
Использование параметра authentication позволяет Test-WSMan
вернуть версию операционной системы.
Пример 4. Определение состояния службы WinRM и версии ОС на удаленном компьютере
Test-WSMan -ComputerName "server01" -Authentication default
Эта команда проверяет, запущена ли служба WS-Management (WinRM) на компьютере с именем server01 с использованием параметра проверки подлинности.
Использование параметра authentication позволяет Test-WSMan
вернуть версию операционной системы.
Параметры
-ApplicationName
Указывает имя приложения в соединении. Значение по умолчанию параметра ApplicationName — WSMAN. Полный идентификатор для удаленной конечной точки имеет следующий формат:
<Transport>://<Server>:<Port>/<ApplicationName>
Пример: http://server01:8080/WSMAN
Службы IIS, где размещен сеанс, перенаправляют запросы с этой конечной точки в заданное приложение. Значение по умолчанию (WSMAN) подходит для большинства задач. Он предназначен для использования в ситуации, когда много компьютеров устанавливают удаленное подключение к одному компьютеру, на котором выполняется Windows PowerShell. В данном случае для повышения эффективности в службах IIS размещены веб-службы для управления (WS-Management).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Authentication
Задает способ проверки подлинности, используемый на сервере. Допустимые значения для этого параметра:
Basic
— Базовый — это схема, в которой имя пользователя и пароль отправляются на сервер или прокси-сервер в виде ясного текста.Default
— Используйте метод проверки подлинности, реализованный протоколом WS-Management. Это значение по умолчанию.- 1 — дайджест — это схема запроса и ответа, которая использует указанную сервером строку данных для запроса.
Kerberos
— Клиентский компьютер и сервер проходят взаимную проверку подлинности с помощью сертификатов Kerberos.Negotiate
— Согласование — это схема ответа на запрос, которая согласовывает с сервером или прокси-сервером, чтобы определить схему, используемую для проверки подлинности. Например, значение этого параметра позволяет согласованию определить, используется ли протокол Kerberos или NTLM.CredSSP
— Используйте проверку подлинности поставщика поддержки безопасности учетных данных (CredSSP), которая позволяет пользователю делегировать учетные данные. Этот параметр предназначен для команд, которые выполняются на одном удаленном компьютере, но собирают данные или выполняют дополнительные команды на других удаленных компьютерах.
Внимание!
CredSSP делегирует учетные данные пользователя с локального компьютера на удаленный компьютер. Это повышает угрозу безопасности при работе в удаленном режиме. Если удаленный компьютер скомпрометирован, то передаваемые на него учетные данные могут быть использованы для управления сетевым сеансом.
Важно!
Если параметр Authentication не указан, Test-WSMan
запрос отправляется на удаленный компьютер анонимно без использования проверки подлинности. Если запрос выполняется анонимно, он не возвращает сведений, относящихся к версии операционной системы. Вместо этого этот командлет отображает значения NULL для версии операционной системы и уровня пакета обновления (ОС: 0.0.0 SP: 0.0).
Type: | AuthenticationMechanism |
Aliases: | auth, am |
Accepted values: | None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CertificateThumbprint
Задает цифровой сертификат с открытым ключом (X509) учетной записи пользователя, который располагает разрешением для выполнения этого действия. Введите отпечаток сертификата.
Сертификаты используются при проверке подлинности на основе сертификата клиента. Они могут сопоставляться только с учетными записями локальных пользователей и не работают с учетными записями доменов.
Чтобы получить отпечаток сертификата, используйте Get-Item или Get-ChildItem
команду на диске Windows PowerShell Cert: .
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputerName
Задает имя компьютера, для которого требуется выполнить операцию управления. Значение может быть полным доменным именем, NetBIOS-именем или IP-адресом. Используйте имя локального компьютера, localhost или точку (.
), чтобы указать локальный компьютер. Локальный компьютер используется по умолчанию. Если удаленный компьютер находится в другом домене по отношению к пользователю, необходимо использовать полное имя домена. Можно передать значение этого параметра в командлет.
Type: | String |
Aliases: | cn |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Credential
Указывает учетную запись пользователя с разрешением на выполнение этого действия. По умолчанию используется текущий пользователь. Введите имя пользователя, например User01, Domain01\User01 или User@Domain.com. Или введите объект PSCredential , например объект, возвращенный командлетом Get-Credential
. При вводе имени пользователя этот командлет запрашивает пароль.
Type: | PSCredential |
Aliases: | cred, c |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Port
Указывает порт, используемый при подключении клиента к службе удаленного управления Windows. Если транспортом является HTTP, порт по умолчанию равен 80. Если транспортом является HTTPS, порт по умолчанию равен 443.
При использовании HTTPS в качестве транспорта значение параметра ComputerName должно соответствовать общему имени сертификата сервера (CN).
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseSSL
Указывает, что для подключения к удаленному компьютеру используется протокол SSL. По умолчанию SSL не используется.
WS-Management шифрует все содержимое Windows PowerShell, передаваемое по сети. Параметр UseSSL позволяет указать дополнительную защиту HTTPS вместо HTTP. Если протокол SSL недоступен в порту, используемом для установки соединения, и вы указываете этот параметр, команда завершается с ошибкой.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
None
Вы не можете передавать объекты в этот командлет.
Выходные данные
Этот командлет возвращает объект XmlElement , представляющий результат теста.
Примечания
По умолчанию Test-WSMan
командлет запрашивает службу WinRM без использования проверки подлинности и не возвращает никаких сведений, относящихся к версии операционной системы. Вместо этого отображаются значения NULL для версии операционной системы и уровня пакета обновления (ОС: 0.0.0 SP: 0.0).