Búsqueda de sitios web

Conectar-WSMan (Microsoft.WSMan.Management)

Conectar-WSMan

Módulo:
Microsoft.WSMan.Management

Se conecta al servicio WinRM en una computadora remota.

Sintaxis

Connect-WSMan
       [-ApplicationName <String>]
       [[-ComputerName] <String>]
       [-OptionSet <Hashtable>]
       [-Port <Int32>]
       [-SessionOption <SessionOption>]
       [-UseSSL]
       [-Credential <PSCredential>]
       [-Authentication <AuthenticationMechanism>]
       [-CertificateThumbprint <String>]
       [<CommonParameters>]
Connect-WSMan
       [-ConnectionURI <Uri>]
       [-OptionSet <Hashtable>]
       [-Port <Int32>]
       [-SessionOption <SessionOption>]
       [-Credential <PSCredential>]
       [-Authentication <AuthenticationMechanism>]
       [-CertificateThumbprint <String>]
       [<CommonParameters>]

Descripción

Este cmdlet solo está disponible en la plataforma Windows.

El cmdlet Connect-WSMan se conecta al servicio WinRM en una computadora remota y establece una conexión persistente con la computadora remota. Puede usar este cmdlet en el contexto del proveedor WSMan para conectarse al servicio WinRM en una computadora remota. Sin embargo, también puede usar este cmdlet para conectarse al servicio WinRM en una computadora remota antes de cambiar al proveedor WSMan. La computadora remota aparece en el directorio raíz del proveedor WSMan.

Se requieren credenciales explícitas cuando las computadoras cliente y servidor están en dominios o grupos de trabajo diferentes.

Para obtener información sobre cómo desconectarse del servicio WinRM en una computadora remota, consulte el cmdlet Disconnect-WSMan.

Ejemplos

Ejemplo 1: conectarse a una computadora remota

PS C:\> Connect-WSMan -ComputerName "server01"
PS C:\> cd wsman:
PS WSMan:\>
PS WSMan:\> dir

WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan

ComputerName                                  Type
------------                                  ----
localhost                                     Container
server01                                      Container

Este comando crea una conexión a la computadora server01 remota.

El cmdlet Connect-WSMan generalmente se usa en el contexto del proveedor WSMan para conectarse a una computadora remota, en este caso la computadora server01. Sin embargo, puede usar el cmdlet para establecer conexiones a computadoras remotas antes de cambiar al proveedor WSMan. Esas conexiones aparecen en la lista ComputerName.

Ejemplo 2: conectarse a una computadora remota usando credenciales de administrador

PS C:\> $cred = Get-Credential Administrator
PS C:\> Connect-WSMan -ComputerName "server01" -Credential $cred
PS C:\> cd wsman:
PS WSMan:\>
PS WSMan:\> dir

WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan

ComputerName                                  Type
------------                                  ----
localhost                                     Container
server01                                      Container

Este comando crea una conexión con el sistema remoto server01 utilizando las credenciales de la cuenta de administrador.

El primer comando utiliza el cmdlet Get-Credential para obtener las credenciales de administrador y luego las almacena en la variable $cred. Get-Credential le solicita una contraseña de nombre de usuario y contraseña a través de un cuadro de diálogo o en la línea de comando, dependiendo de la configuración del registro del sistema.

El segundo comando utiliza el parámetro Credential para pasar las credenciales almacenadas en $cred a Connect-WSMan. Connect-WSMan luego se conecta al sistema remoto server01 utilizando las credenciales de administrador.

Ejemplo 3: conectarse a una computadora remota a través de un puerto específico

PS C:\> Connect-WSMan -ComputerName "server01" -Port 80
PS C:\> cd wsman:
PS WSMan:\>
PS WSMan:\> dir

WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan
ComputerName                                  Type
------------                                  ----
localhost                                     Container
server01                                      Container

Este comando crea una conexión a la computadora server01 remota a través del puerto 80.

Ejemplo 4: conectarse a una computadora remota mediante opciones de conexión

PS C:\> $a = New-WSManSessionOption -OperationTimeout 30000
PS C:\> Connect-WSMan -ComputerName "server01" -SessionOption $a
PS C:\> cd wsman:
PS WSMan:\> dir

WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan
ComputerName                                  Type
------------                                  ----
localhost                                     Container
server01                                      Container

Este ejemplo crea una conexión al equipo server01 remoto utilizando las opciones de conexión definidas en el comando New-WSManSessionOption.

El primer comando usa New-WSManSessionOption para almacenar un conjunto de opciones de configuración de conexión en la variable $a. En este caso, las opciones de sesión establecen un tiempo de conexión de 30 segundos (30.000 milisegundos).

El segundo comando utiliza el parámetro SessionOption para pasar las credenciales almacenadas en la variable $a a Connect-WSMan. Luego, Connect-WSMan se conecta a la computadora server01 remota usando las opciones de sesión especificadas.

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 del punto final remoto tiene el siguiente formato:

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

Por ejemplo:

http://server01:8080/WSMAN

Internet Information Services (IIS), que aloja la sesión, reenvía las solicitudes con este punto final a la aplicación especificada. Esta configuración predeterminada de WSMAN es apropiada para la mayoría de los usos. Este parámetro está diseñado para usarse si muchas computadoras establecen conexiones remotas a una computadora que ejecuta Windows PowerShell. En este caso, IIS aloja Web Services for Management (WS-Management) para mayor eficiencia.

Tipo :

String

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-Authentication

Especifica el mecanismo de autenticación que se utilizará en el servidor. Los valores aceptables para este parámetro son:

  • Básico: Básico es un esquema en el que el nombre de usuario y la contraseña se envían en texto claro al servidor o proxy.
  • Predeterminado: utilice el método de autenticación implementado por el protocolo WS-Management. Este es el valor predeterminado.
  • Resumen: el resumen es un esquema de desafío-respuesta que utiliza 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: Negociar es un esquema de desafío-respuesta que negocia con el servidor o proxy para determinar el esquema a utilizar para la autenticación. Por ejemplo, este valor de parámetro permite la negociación para determinar si se utiliza el protocolo Kerberos o NTLM.
  • CredSSP: utilice la autenticación del proveedor de soporte de seguridad de credenciales (CredSSP), que permite al usuario delegar credenciales. Esta opción está diseñada para comandos que se ejecutan en una computadora remota pero recopilan datos o ejecutan comandos adicionales en otras computadoras remotas.

Precaución

CredSSP delega las credenciales de usuario de la computadora local a una computadora remota. Esta práctica aumenta el riesgo de seguridad de la operación remota. Si la computadora remota está comprometida, cuando se le pasan las credenciales, las credenciales se pueden usar para controlar la sesión de red.

Tipo :

AuthenticationMechanism

Alias:

auth, am

Valores aceptados:

Ninguno, Predeterminado, Resumen, Negociar, Básico, Kerberos, ClientCertificate, Credssp

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-CertificateThumbprint

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

Los certificados se utilizan en la autenticación basada en certificados de cliente. Sólo se pueden asignar a cuentas de usuarios locales; no funcionan con cuentas de dominio.

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

Tipo :

String

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-ComputerName

Especifica la computadora en la que se ejecutará la operación de administración. El valor puede ser un nombre de dominio completo, un nombre NetBIOS o una dirección IP. Utilice el nombre de la computadora local, use localhost o use un punto (.) para especificar la computadora local. La computadora local es la predeterminada. Cuando la computadora remota está en un dominio diferente al del usuario, debe usar un nombre de dominio completo. Puede canalizar un valor para este parámetro al cmdlet.

Tipo :

String

Alias:

cn

Posición:

0

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-ConnectionURI

Especifica el punto final de la conexión. El formato de esta cadena es el siguiente:

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

La siguiente cadena es un valor formateado correctamente para este parámetro:

http://Server01:8080/WSMAN

El URI debe estar completamente calificado.

Tipo :

uri

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-Credential

Especifica una cuenta de usuario que tiene permiso para realizar esta acción. El valor predeterminado es el usuario actual. Escriba un nombre de usuario, como Usuario01, Dominio01\Usuario01 o Usuario@Dominio.com. O bien, introduzca un objeto PSCredential, como el que devuelve el cmdlet Get-Credential. Cuando escribe un nombre de usuario, este cmdlet le solicita una contraseña.

Tipo :

PSCredencial

Alias:

cred, c

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-OptionSet

Especifica un conjunto de cambios a un servicio para modificar o refinar la naturaleza de la solicitud. Estos se parecen a los modificadores utilizados en los shells de la línea de comandos porque son específicos del servicio. Se puede especificar cualquier número de opciones.

El siguiente ejemplo demuestra la sintaxis que pasa los valores 1, 2 y 3 para los parámetros a, b y c:

-OptionSet @{a=1;b=2;c=3}
Tipo :

tabla hash

Alias:

os

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-Port

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

Cuando utiliza HTTPS como transporte, el valor del parámetro ComputerName debe coincidir con el nombre común del certificado (CN) del servidor. Sin embargo, si el parámetro SkipCNCheck se especifica como parte del parámetro SessionOption, el nombre común del certificado del servidor no tiene que coincidir con el nombre de host del servidor. El parámetro SkipCNCheck debe usarse solo para computadoras confiables.

Tipo :

Int32

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-SessionOption

Especifica opciones extendidas para la sesión de WS-Management. Introduzca un objeto SessionOption que cree mediante el cmdlet New-WSManSessionOption. Para obtener más información sobre las opciones disponibles, escriba Get-Help New-WSManSessionOption.

Tipo :

SessionOption

Alias:

so

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-UseSSL

Especifica que se utiliza el protocolo Secure Sockets Layer (SSL) para establecer una conexión con la computadora remota. De forma predeterminada, no se utiliza SSL.

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

Tipo :

SwitchParameter

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

Entradas

Ninguno

No puede canalizar objetos a este cmdlet.

Salidas

Ninguno

Este cmdlet no devuelve ningún resultado.

Notas

Puede ejecutar comandos de administración o consultar datos de administración en una computadora remota sin crear una sesión de WS-Management. Puede hacerlo utilizando los parámetros ComputerName de Invoke-WSManAction y Get-WSManInstance. Cuando usa el parámetro ComputerName, Windows PowerShell crea una conexión temporal que se usa para el comando único. Después de ejecutar el comando, la conexión se cierra.

Artículos relacionados