Share via

winrs

  • Artículo

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2 y Windows Server 2012.

El uso del comando winrs en Administración remota de Windows permite administrar y ejecutar programas de forma remota.

Sintaxis

winrs [/<parameter>[:<value>]] <command>

Parámetros

Parámetro Descripción
/remote:<endpoint> Especifica el punto de conexión de destino mediante un nombre NetBIOS o la conexión estándar:

- <url>: [<transport>://]<target>[:<port>]

Si no se especifica, se usa /r:localhost.
/unencrypted Especifica que los mensajes que se envían al shell remoto no se cifran. Este parámetro resulta útil para solucionar problemas o cuando el tráfico de red ya está cifrado mediante ipsec o cuando se aplica la seguridad física.

De forma predeterminada, los mensajes se cifran mediante claves Kerberos o NTLM.

Esta opción de línea de comandos se omite cuando se selecciona transporte HTTPS.
/username:<username> Especifica el nombre de usuario en la línea de comandos.

Si no se especifica, la herramienta usa la autenticación Negotiate o solicita el nombre.

Si se especifica /username, también se debe especificar /password.
/password:<contraseña> Especifica la contraseña en la línea de comandos.

Si no se especifica /password, pero /username sí, la herramienta solicita la contraseña.

Si se especifica /password, también se debe especificar /username.
/timeout:<segundos> Esta opción está en desuso.
/directory:<path> Especifica el directorio inicial para el shell remoto.

Si no se especifica, el shell remoto se inicia en el directorio principal del usuario definido por la variable de entorno %USERPROFILE%.
/environment:<string>=<value> Especifica una única variable de entorno que se va a establecer cuando se inicia el shell, lo que permite cambiar el entorno predeterminado para shell.

Se deben usar varias repeticiones de este modificador para especificar varias variables de entorno.
/noecho Especifica que se debe deshabilitar el echo. Es posible que noecho sea necesario para tener la certeza de que las respuestas del usuario a las indicaciones remotas no se muestran localmente.

De forma predeterminada, echo está activado.
/noprofile Especifica que el perfil del usuario no debe cargarse.

De forma predeterminada, el servidor intenta cargar el perfil de usuario.

Si el usuario remoto no es un administrador local en el sistema de destino, esta opción es obligatoria (el valor predeterminado genera un error).
/allowdelegate Especifica que las credenciales del usuario se pueden usar para acceder a un recurso compartido remoto, por ejemplo, a una máquina diferente a la del punto de conexión de destino.
/compression Active la compresión. Es posible que las instalaciones anteriores en máquinas remotas no admitan la compresión.

La configuración predeterminada está desactivada, ya que es posible que las instalaciones anteriores en máquinas remotas no admitan la compresión.
/usessl Use una conexión SSL al usar un punto de conexión remoto. Especificando SSL, en lugar del https: de transporte se usa el puerto predeterminado de WinRM.
/? Muestra la ayuda en el símbolo del sistema.

Comentarios

  • Todas las opciones de línea de comandos aceptan formato corto o largo. Por ejemplo, tanto /r como /remote son válidos.
  • Para finalizar el comando /remote, el usuario puede escribir Ctrl-C o Ctrl-break, que se envía al shell remoto. El segundo Ctrl-C fuerza la terminación de winrs.exe.
  • Para administrar la configuración activa de shells remotos o winrs, use la herramienta WinRM. El alias de URI para administrar shells activos es shell/cmd. El alias de URI para la configuración de winrs es winrm/config/winrs.

Ejemplos

winrs /r:https://contoso.com command

winrs /r:contoso.com /usessl command

winrs /r:myserver command

winrs /r:http://127.0.0.1 command

winrs /r:http://169.51.2.101:80 /unencrypted command

winrs /r:https://[::FFFF:129.144.52.38] command

winrs /r:http://[1080:0:0:0:8:800:200C:417A]:80 command

winrs /r:https://contoso.com /t:600 /u:administrator /p:$%fgh7 ipconfig

winrs /r:myserver /env:path=^%path^%;c:\tools /env:TEMP=d:\temp config.cmd

winrs /r:myserver netdom join myserver /domain:testdomain /userd:johns /passwordd:$%fgh789

winrs /r:myserver /ad /u:administrator /p:$%fgh7 dir \\anotherserver\share