Test-WSMan (Microsoft.WSMan.Management)

Тест-WSMan

Модуль:

Microsoft.WSMan.Management

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

Синтаксис

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

Эта команда определяет, запущена ли служба WinRM на локальном или на удаленном компьютере.

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

Test-WSMan -ComputerName "server01"

Эта команда определяет, запущена ли служба WinRM на компьютере server01.

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

Test-WSMan -Authentication default

Эта команда проверяет, работает ли служба WS-Management (WinRM) на локальном компьютере, используя параметр аутентификации.

Использование параметра аутентификации позволяет Test-WSMan возвращать версию операционной системы.

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

Test-WSMan -ComputerName "server01" -Authentication default

Эта команда проверяет, работает ли служба WS-Management (WinRM) на компьютере с именем server01, используя параметр аутентификации.

Использование параметра аутентификации позволяет Test-WSMan возвращать версию операционной системы.

Параметры

-ApplicationName

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

<Transport>://<Server>:<Port>/<ApplicationName>

Например:

http://server01:8080/WSMAN

Службы IIS, на которых размещается сеанс, пересылают запросы с этой конечной точки указанному приложению. Эта настройка WSMAN по умолчанию подходит для большинства случаев использования. Этот параметр предназначен для использования, если несколько компьютеров устанавливают удаленные подключения к одному компьютеру под управлением Windows PowerShell. В этом случае для повышения эффективности в IIS размещаются веб-службы управления (WS-Management).

Тип :

String

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-Authentication

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

• Basic — Basic — это схема, в которой имя пользователя и пароль передаются на сервер или прокси в виде открытого текста.
• Default — использовать метод аутентификации, реализованный протоколом WS-Management. Это значение по умолчанию.
• 1. Дайджест — это схема запроса-ответа, в которой для запроса используется строка данных, указанная сервером.
• Kerberos — клиентский компьютер и сервер выполняют взаимную проверку подлинности с помощью сертификатов Kerberos.
• Negotiate — Negotiate — это схема запроса-ответа, которая согласовывает с сервером или прокси-сервером, чтобы определить схему, которая будет использоваться для аутентификации. Например, значение этого параметра позволяет путем согласования определить, используется ли протокол Kerberos или NTLM.
• CredSSP — используйте аутентификацию поставщика поддержки безопасности учетных данных (CredSSP), которая позволяет пользователю делегировать учетные данные. Этот параметр предназначен для команд, которые выполняются на одном удаленном компьютере, но собирают данные или запускают дополнительные команды на других удаленных компьютерах.

Тип :

AuthenticationMechanism

Псевдонимы:

auth, am

Принятые значения:

Нет, по умолчанию, дайджест, согласование, базовый, Kerberos, ClientCertificate, Credssp

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-CertificateThumbprint

Указывает сертификат цифрового открытого ключа (X509) учетной записи пользователя, у которого есть разрешение на выполнение этого действия. Введите отпечаток сертификата.

Сертификаты используются при проверке подлинности на основе сертификатов клиентов. Их можно сопоставить только с локальными учетными записями пользователей; они не работают с доменными учетными записями.

Чтобы получить отпечаток сертификата, используйте команду Get-Item или Get-ChildItem на диске Windows PowerShell Cert:.

Тип :

String

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-ComputerName

Указывает компьютер, на котором будет выполняться операция управления. Значением может быть полное доменное имя, имя NetBIOS или IP-адрес. Используйте имя локального компьютера, localhost или точку (.), чтобы указать локальный компьютер. Локальный компьютер используется по умолчанию. Если удаленный компьютер находится в домене, отличном от домена пользователя, необходимо использовать полное доменное имя. Вы можете передать значение этого параметра в командлет.

Тип :

String

Псевдонимы:

cn

Позиция:

0

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

True

Принимайте подстановочные знаки:

False

-Credential

Указывает учетную запись пользователя, имеющую разрешение на выполнение этого действия. По умолчанию используется текущий пользователь. Введите имя пользователя, например User01, Domain01\User01 или User@Domain.com. Или введите объект PSCredential, например тот, который возвращается командлетом Get-Credential. Когда вы вводите имя пользователя, этот командлет запрашивает пароль.

Тип :

PSCredential

Псевдонимы:

cred, c

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

True

Принимайте подстановочные знаки:

False

-Port

Указывает порт, который будет использоваться при подключении клиента к службе WinRM. Если транспортом является HTTP, порт по умолчанию — 80. Если транспортом является HTTPS, порт по умолчанию — 443.

Если вы используете HTTPS в качестве транспорта, значение параметра ComputerName должно соответствовать общему имени сертификата сервера (CN).

Тип :

Int32

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-UseSSL

Указывает, что для установления соединения с удаленным компьютером используется протокол Secure Sockets Layer (SSL). По умолчанию SSL не используется.

WS-Management шифрует все содержимое Windows PowerShell, передаваемое по сети. Параметр UseSSL позволяет указать дополнительную защиту HTTPS вместо HTTP. Если SSL недоступен на порту, который используется для подключения, и вы укажете этот параметр, команда завершится неудачей.

Тип :

SwitchParameter

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

Входы

Нет

Вы не можете передавать объекты в этот командлет.

Выходы

XmlElement

Этот командлет возвращает объект XmlElement, представляющий результат теста.

Примечания

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