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

Test-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
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Authentication

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

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

Осторожность

CredSSP делегирует учетные данные пользователя с локального компьютера на удаленный компьютер. Эта практика повышает риск безопасности удаленной операции. Если удаленный компьютер скомпрометирован, при передаче учетных данных в него учетные данные можно использовать для управления сетевым сеансом.

Важный

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

Тип:AuthenticationMechanism
Aliases:auth, am
Допустимые значения:None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-CertificateThumbprint

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

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

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ComputerName

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

Тип:String
Aliases:cn
Position:0
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Credential

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

Тип:PSCredential
Aliases:cred, c
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Port

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

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

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-UseSSL

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

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

None

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

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

XmlElement

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

Примечания

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