Проверяет, запущена ли служба WinRM на локальном или удаленном компьютере.
Синтаксис
Test-WSMan [[-ComputerName] <string>] [-Authentication <Authentication>] [-Credential <PSCredential>] [<CommonParameters>]
Описание
Командлет Test-WSMan отправляет идентификационный запрос для проверки того, запущена ли служба WinRM на локальном или удаленном компьютере. Если служба на проверяемом компьютере запущена, командлет отображает схему удостоверений WS-Management, версию протокола, и поставщика и версию проверяемой службы.
Параметры
-Authentication <Authentication>
Задает механизм проверки подлинности, используемый на сервере. Возможные значения:
- Basic: при использовании схемы Basic имя пользователя и пароль передаются серверу или прокси-серверу открытым текстом.
- Default: использовать метод проверки подлинности, реализованный протоколом WS-Management.
- Digest: при использовании схемы Digest проверка подлинности проводится по принципу "запрос-ответ". В качестве запроса поступает строка данных, указанная сервером.
- Kerberos: выполняется взаимная проверка подлинности компьютера и сервера с использованием сертификатов Kerberos.
- Negotiate: при использовании схемы Negotiate между компьютером и сервером или прокси происходит обмен данными по принципу "запрос-ответ", в ходе которого определяется схема, используемая для проверки подлинности. Например, это значение параметра разрешает согласование одного из двух методов проверки подлинности: Kerberos или NTLM.
- CredSSP: использовать проверку подлинности CredSSP (Credential Security Service Provider), при которой пользователю разрешается делегировать учетные данные. Этот вариант предназначен для команд, которые запускаются на одном удаленном компьютере, но собирают данные с других удаленных компьютеров или выполняют на них дополнительные команды.
Внимание! При проверке подлинности CredSSP учетные данные пользователя делегируются с локального компьютера на удаленный компьютер. Такой подход повышает угрозы безопасности удаленных операций. Если безопасность удаленного компьютера нарушена, при передаче на него учетных данных эти данные могут быть использованы для управления сетевым сеансом.
Важно: если параметр проверки подлинности не указан, запрос командлета Test-WSMan будет отправлен на удаленный компьютер анонимно (без проверки подлинности). Анонимные запросы Test-WSMan не возвращают никаких сведений, относящихся к версии операционной системы, т. е. Test-WSMan отображает нулевые значения вместо версий операционной системы и пакета обновления (OS: 0.0.0 SP: 0.0).
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-ComputerName <string>
Задает компьютер, к которому требуется применить операцию управления. Значение может быть полным доменным именем, именем NetBIOS или IP-адресом. Чтобы задать локальный компьютер, введите имя компьютера, "localhost" или точку (.). Локальный компьютер используется по умолчанию. Если пользователь и удаленный компьютер находятся в разных доменах, необходимо использовать полное доменное имя.
|
Обязательно? |
false |
|
Позиция? |
1 |
|
Значение по умолчанию |
localhost |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Credential <PSCredential>
Задает учетную запись пользователя, который располагает разрешением для выполнения этого действия. По умолчанию используется значение "Текущий пользователь". Введите имя пользователя, например "User01", "Domain01\User01" или "User@Domain.com". Или укажите объект PSCredential, например возвращенный командлетом Get-Credential. При вводе имени пользователя появится приглашение ввести пароль.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
<CommonParameters>
Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.
Ввод и вывод
Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.
|
Входные данные |
Нет Этот командлет не принимает никаких входных данных. |
|
Выходные данные |
Нет Этот командлет не формирует никаких выходных объектов. |
Примечания
По умолчанию командлет Test-WSMan отправляет запрос службе WinRM без проверки подлинности и не возвращает никаких сведений, относящихся к версии операционной системы, т. е. отображает нулевые значения вместо версий операционной системы и пакета обновления (OS: 0.0.0 SP: 0.0).
Пример 1
C:\PS>test-wsman wsmid : http://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd ProtocolVersion : http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd ProductVendor : Microsoft Corporation ProductVersion : OS: 0.0.0 SP: 0.0 Stack: 2.0 Описание ----------- Эта команда определяет, запущена ли служба WinRM на локальном компьютере или на удаленном компьютере.
Пример 2
C:\PS>test-wsman -computername server01 wsmid : http://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd ProtocolVersion : http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd ProductVendor : Microsoft Corporation ProductVersion : OS: 0.0.0 SP: 0.0 Stack: 2.0 Описание ----------- Эта команда определяет, запущена ли служба WinRM на компьютере с именем "server01".
Пример 3
C:\PS>test-wsman -authentication default wsmid : http://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd ProtocolVersion : http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd ProductVendor : Microsoft Corporation ProductVersion : OS: 6.0.6001 SP: 1.0 Stack: 2.0 Описание ----------- Эта команда проверяет, запущена ли служба WS-Management (WinRM) на локальном компьютере, с использованием параметра проверки подлинности. Использование параметра проверки подлинности позволяет командлету Test-WSMan возвратить версию операционной системы.
Пример 4
C:\PS>test-wsman -computername server01 -authentication default wsmid : http://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd ProtocolVersion : http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd ProductVendor : Microsoft Corporation ProductVersion : OS: 6.1.7021 SP: 0.0 Stack: 2.0 Описание ----------- Эта команда проверяет, запущена ли служба WS-Management (WinRM) на локальном компьютере с именем "server01", с использованием параметра проверки подлинности. Использование параметра проверки подлинности позволяет командлету Test-WSMan возвратить версию операционной системы.