Test-WSMan

  • Referencia
Módulo:
Microsoft.WSMan.Management

Comprueba si el servicio WinRM se ejecuta en un equipo local o remoto.

Syntax

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

Description

El Test-WSMan cmdlet envía una solicitud de identificación que determina si el servicio WinRM se ejecuta en un equipo local o remoto. Si el equipo comprobado está ejecutando el servicio, el cmdlet muestra el esquema de la identidad de WS-Management, la versión del protocolo, el proveedor del producto y la versión del producto del servicio probado.

Ejemplos

Ejemplo 1: Determinar el estado del servicio WinRM

Test-WSMan

Este comando determina si el servicio WinRM se está ejecutando en el equipo local o en un equipo remoto.

Ejemplo 2: Determinar el estado del servicio WinRM en un equipo remoto

Test-WSMan -ComputerName "server01"

Este comando determina si el servicio WinRM se ejecuta en el equipo server01.

Ejemplo 3: Determinar el estado del servicio WinRM y la versión del sistema operativo

Test-WSMan -Authentication default

Este comando comprueba si el servicio WS-Management (WinRM) se ejecuta en el equipo local mediante el parámetro de autenticación.

El uso del parámetro de autenticación permite Test-WSMan devolver la versión del sistema operativo.

Ejemplo 4: Determinar el estado del servicio WinRM y la versión del sistema operativo en un equipo remoto

Test-WSMan -ComputerName "server01" -Authentication default

Este comando comprueba si el servicio WS-Management (WinRM) se ejecuta en el equipo denominado server01 mediante el parámetro de autenticación.

El uso del parámetro de autenticación permite Test-WSMan devolver la versión del sistema operativo.

Parámetros

-ApplicationName

Especifica el nombre de la aplicación en la conexión. El valor predeterminado del parámetro ApplicationName es WSMAN. El identificador completo para el extremo remoto está en el formato siguiente:

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

Por ejemplo: http://server01:8080/WSMAN

Internet Information Services (IIS), que hospeda la sesión, reenvía las solicitudes con este extremo a la aplicación especificada. Esta configuración predeterminada de WSMAN es adecuada para la mayoría de los usos. Este parámetro está diseñado para usarse si muchos equipos establecen conexiones remotas a un equipo que ejecuta Windows PowerShell. En este caso, IIS hospeda servicios web para administración (WS-Management) para mejorar la eficacia.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Authentication

Especifica el mecanismo de autenticación que se va a usar en el servidor. Los valores permitidos para este parámetro son los siguientes:

  • Basic - Básico es un esquema en el que el nombre de usuario y la contraseña se envían en texto no cifrado al servidor o proxy.
  • Default - Use el método de autenticación implementado por el protocolo WS-Management. Este es el valor predeterminado.
  • 1 - Resumen es un esquema de desafío-respuesta que usa una cadena de datos especificada por el servidor para el desafío.
  • Kerberos - El equipo cliente y el servidor se autentican mutuamente mediante certificados Kerberos.
  • Negotiate - Negotiate es un esquema de desafío-respuesta que negocia con el servidor o proxy para determinar el esquema que se va a usar para la autenticación. Por ejemplo, este valor de parámetro permite que la negociación determine si se usa el protocolo Kerberos o NTLM.
  • CredSSP - Use la autenticación del proveedor de soporte técnico de seguridad de credenciales (CredSSP), que permite al usuario delegar las credenciales. Esta opción está diseñada para comandos que se ejecuten en un equipo remoto pero que recopilen datos o ejecuten comandos adicionales en otros equipos remotos.

Precaución

CredSSP delega las credenciales de usuario del equipo local a un equipo remoto. Este procedimiento aumenta el riesgo de seguridad de la operación remota. Si el equipo remoto ve su seguridad comprometida, al pasar al equipo las credenciales, estas pueden utilizarse para controlar la sesión de red.

Importante

Si no especifica el parámetro Authentication , la Test-WSMan solicitud se envía al equipo remoto de forma anónima, sin usar la autenticación. Si la solicitud se realiza de forma anónima, no devuelve información específica de la versión del sistema operativo. En su lugar, este cmdlet muestra valores NULL para la versión del sistema operativo y el nivel de Service Pack (SO: 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

Especifica el certificado de clave pública digital (X509) de una cuenta de usuario que tiene permiso para realizar esta acción. Escriba la huella digital del certificado.

Los certificados se usan para la autenticación basada en certificados de cliente. Solo se pueden asignar a cuentas de usuario locales y no funcionan con cuentas de dominio.

Para obtener una huella digital de certificado, use el comando Get-Item o Get-ChildItem en la unidad Cert: de Windows PowerShell.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ComputerName

Especifica el equipo en el que se va a ejecutar la operación de administración. El valor puede ser un nombre de dominio completo, un nombre NetBIOS o una dirección IP. Use el nombre del equipo local, use localhost o use un punto (.) para especificar el equipo local. El valor predeterminado es el equipo local. Si el equipo remoto está en un dominio distinto al del usuario, se deberá usar el nombre de dominio completo. Se puede canalizar un valor para este parámetro al cmdlet.

Type:String
Aliases:cn
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Credential

Especifica una cuenta de usuario con permiso para realizar esta acción. El valor predeterminado es el usuario actual. Escriba un nombre de usuario, como User01, Domain01\User01 o User@Domain.com. O bien, escriba un objeto PSCredential , como uno devuelto por el Get-Credential cmdlet . Al escribir un nombre de usuario, este cmdlet le pedirá una contraseña.

Type:PSCredential
Aliases:cred, c
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Port

Especifica el puerto que se utilizará cuando el cliente se conecte al servicio WinRM. Si el transporte es HTTP, el puerto predeterminado es 80. Si el transporte es HTTPS, el puerto predeterminado es 443.

Cuando se usa HTTPS como transporte, el valor del parámetro ComputerName debe coincidir con el nombre común (CN) del certificado del servidor.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseSSL

Especifica que el protocolo Capa de sockets seguros (SSL) se usa para establecer una conexión con el equipo remoto. De forma predeterminada, no se usa SSL.

WS-Management cifra todo el contenido de Windows PowerShell que se transmite a través de la red. El parámetro UseSSL permite especificar la protección adicional de HTTPS en lugar de HTTP. Si SSL no está disponible en el puerto que se usa para la conexión y especifica este parámetro, se produce un error en el comando.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

None

No se pueden canalizar objetos a este cmdlet.

Salidas

None

Este cmdlet no devuelve ningún resultado.

Notas

De forma predeterminada, el Test-WSMan cmdlet consulta el servicio WinRM sin usar la autenticación y no devuelve información específica de la versión del sistema operativo. En su lugar, muestra valores NULL para la versión del sistema operativo y el nivel de Service Pack (SO: 0.0.0 SP: 0.0).