Test-WSMan

Ссылка

Модуль:: Microsoft.WsMan.Management

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

Синтаксис

Test-WSMan
    [[-ComputerName] <String>]
    [-Authentication <AuthenticationMechanism>]
    [-Port <Int32>]
    [-UseSSL]
    [-ApplicationName <String>]
    [-Credential <PSCredential>]
    [-CertificateThumbprint <String>]
    [<CommonParameters>]

Описание

Командлет Test-WSMan отправляет запрос на идентификацию, который определяет, запущена ли служба WinRM на локальном или удаленном компьютере. Если на проверенном компьютере эта служба выполняется, командлет отображает схему удостоверений WS-Management, версию протокола, поставщика продукта и версию продукта протестированной службы.

Примеры

Пример 1. Определение состояния службы WinRM

PS C:\> 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

Эта команда определяет, выполняется ли служба удаленного управления Windows на локальном или удаленном компьютере.

Пример 2. Определение состояния службы WinRM на удаленном компьютере

PS C:\> 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. Определение состояния службы WinRM и версии операционной системы

PS C:\> 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. Определение состояния службы WinRM и версии операционной системы на удаленном компьютере

PS C:\> 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 возвращать версию операционной системы.

Параметры

-ApplicationName

Указывает имя приложения в соединении. Значение по умолчанию параметра ApplicationName — WSMAN. Полный идентификатор для удаленной конечной точки имеет следующий формат:

Пример: 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

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

Обычные. схема, в которой имя пользователя и пароль отправляются на сервер или прокси-сервер в виде открытого текста.
По умолчанию. использование метода аутентификации, реализованного протоколом WS-Management. Это значение по умолчанию.
Дайджест. это схема запроса и ответа, использующая указанную сервером строку данных в качестве запроса.
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.

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:	Localhost
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

Этот командлет не принимает никаких входных данных.

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

None

Этот командлет не формирует никакого выходного объекта.

Примечания

По умолчанию командлет Test-WSMan запрашивает службу WinRM без проверки подлинности и не возвращает сведений, относящихся к версии операционной системы. Вместо этого отображаются значения NULL для версии операционной системы и уровня пакета обновления (ОС: 0.0.0 SP: 0.0).

Поделиться через

Test-WSMan

Синтаксис

Описание

Примеры

Пример 1. Определение состояния службы WinRM

Пример 2. Определение состояния службы WinRM на удаленном компьютере

Пример 3. Определение состояния службы WinRM и версии операционной системы

Пример 4. Определение состояния службы WinRM и версии операционной системы на удаленном компьютере

Параметры

-ApplicationName

-Authentication

-CertificateThumbprint

-ComputerName

-Credential

-Port

-UseSSL

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

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

Примечания

Дополнительные ресурсы

Поделиться через

Test-WSMan

Синтаксис

Описание

Примеры

Пример 1. Определение состояния службы WinRM

Пример 2. Определение состояния службы WinRM на удаленном компьютере

Пример 3. Определение состояния службы WinRM и версии операционной системы

Пример 4. Определение состояния службы WinRM и версии операционной системы на удаленном компьютере

Параметры

-ApplicationName

-Authentication

-CertificateThumbprint

-ComputerName

-Credential

-Port

-UseSSL

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

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

Примечания

Связанные ссылки

Дополнительные ресурсы