HOWTO · PowerShell

Cómo ejecutar comandos con PowerShell Remoting

Este artículo explica cómo funciona PowerShell Remoting y cómo configurar WinRM, crear y reutilizar sesiones remotas, conectarse mediante SSH cuando el entorno lo admite y ejecutar comandos puntuales.

En esta página

PowerShell Remoting permite ejecutar comandos en otro equipo mediante un punto de conexión de remoting configurado. Usa New-PSSession cuando varios comandos necesiten compartir el mismo estado remoto; usa Invoke-Command con -ComputerName para una tarea que no requiera una sesión reutilizable. Los comandos siguientes son plantillas: sustituye DC01 por un host que tengas autorización para administrar y ejecuta los comandos de configuración en una ventana de PowerShell con los privilegios adecuados.

Qué hace PowerShell Remoting

En una conexión de WinRM, el cliente llega a un listener del equipo remoto, se autentica y ejecuta el comando solicitado en una sesión remota. PowerShell devuelve los resultados al cliente; muchos objetos atraviesan la conexión como representaciones serializadas, por lo que quizá no conserven todos los comportamientos del objeto original en memoria. La comunicación de remoting está protegida según la configuración del transporte y la autenticación. No des por sentado que todas las conexiones usan HTTPS: WinRM suele usar HTTP con protección a nivel de mensaje para los métodos de autenticación admitidos, mientras que HTTPS usa TLS en la capa de transporte. La guía de seguridad de WinRM de Microsoft explica cómo afectan la autenticación y el transporte a esta protección.

El punto de conexión remoto determina qué comandos y permisos están disponibles. Una conexión correcta no concede automáticamente derechos de administrador: la cuenta proporcionada debe tener autorización para usar el punto de conexión y realizar la operación solicitada.

Habilitar y comprobar WinRM

En un equipo Windows que vaya a aceptar conexiones de WinRM, un administrador puede configurar remoting con Enable-PSRemoting -Force. Antes de modificar un equipo administrado, revisa los efectos y la política de tu organización. Para inspeccionar los listeners configurados, ejecuta winrm enumerate winrm/config/listener desde el símbolo del sistema o PowerShell. Los detalles del listener indican el transporte y las direcciones en las que WinRM acepta conexiones. winrm quickconfig puede informar o configurar los ajustes básicos del servicio y los listeners de WinRM; no sustituye la comprobación de las reglas del firewall, los permisos del punto de conexión y la conectividad de red.

Usa HTTPS cuando tu entorno requiera transporte TLS y tenga un certificado y un listener HTTPS configurados correctamente. HTTP no significa que todo el tráfico de remoting se envíe sin protección: WinRM aplica cifrado a nivel de mensaje después de la autenticación para los métodos de autenticación admitidos. La protección exacta depende del método de autenticación y de la configuración, así que sigue los requisitos de seguridad de tu organización; consulta la guía de seguridad de WinRM de Microsoft para conocer las condiciones documentadas.

TrustedHosts es una configuración del cliente que puede ser pertinente en grupos de trabajo u otras configuraciones en las que el cliente no pueda autenticar el servidor del modo habitual basado en dominio. No es una solución universal para los problemas de conexión ni hace que un servidor que no sea de confianza sea seguro. La guía de seguridad de WinRM de Microsoft explica el contexto de autenticación y las precauciones; cuando sea posible, prefiere una configuración adecuada basada en dominio o certificados. Si la política exige TrustedHosts, limita su alcance a hosts conocidos y usa un método de autenticación aprobado. Puedes inspeccionarlo con winrm get winrm/config/client y cambiarlo solo después de revisar las implicaciones de seguridad.

Crear y reutilizar una PSSession

Crea una sesión remota persistente indicando un destino y las credenciales:

$credential = Get-Credential; $session = New-PSSession -ComputerName 'DC01' -Credential $credential

Ejecuta este ejemplo:

El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.

$result = 'Ready to run the remote task.'
$result
Ready to run the remote task.

El ejemplo local anterior muestra la cadena «Ready to run the remote task.»; tanto esa cadena como la etiqueta visible del resultado se mantienen en inglés porque el bloque es inmutable. El ejemplo imprime una cadena local y no se conecta a un equipo remoto. Para establecer una conexión real, ejecuta el comando en línea en una sesión interactiva de PowerShell; Get-Credential solicita las credenciales en lugar de incluir una contraseña en el código fuente. La cuenta también necesita permiso para conectarse al punto de conexión remoto. Después de crear la sesión, pasa el objeto de sesión a los comandos que deban compartir esa sesión remota y su estado. Por ejemplo, usa Invoke-Command -Session $session -ScriptBlock { Get-Service -Name 'Spooler' } para ejecutar un comando en ella. Una sesión persistente resulta útil cuando necesitas realizar varias operaciones remotas o mantener variables y otros datos de estado entre llamadas.

Cuando termines, cierra la conexión y libera la sesión con Remove-PSSession $session. Si la creación falla, comprueba el nombre del destino, la ruta de red, el listener de WinRM, el firewall, las credenciales y los permisos del punto de conexión antes de cambiar la configuración de confianza del cliente.

PowerShell también puede usar remoting mediante SSH cuando la versión instalada de PowerShell, el cliente SSH, el servicio SSH remoto y el punto de conexión SSH de PowerShell configurado lo admitan. La guía de remoting mediante SSH de Microsoft describe los requisitos previos y la configuración; consulta la guía correspondiente a las versiones y al punto de conexión que realmente utilizas, ya que la compatibilidad depende de ese entorno. La referencia de New-PSSession documenta formas de conexión SSH como -HostName con -UserName y el parámetro -SSHConnection para especificar los datos de conexión. Estas opciones no configuran el servicio SSH remoto ni el punto de conexión de PowerShell.

Ejecutar comandos puntuales con Invoke-Command

Para una sola tarea, Invoke-Command -ComputerName se conecta durante la llamada y devuelve los resultados sin dejar un objeto de sesión que puedas reutilizar. Por ejemplo, Invoke-Command -ComputerName 'DC01' -Credential (Get-Credential) -ScriptBlock { Get-Service -Name 'Spooler' } solicita las credenciales y pide al equipo remoto la información del servicio. Usa una cuenta autorizada por el punto de conexión; remoting no eleva sus privilegios.

A continuación se muestra un ejemplo local y autocontenido de cómo invocar un bloque de script. Ilustra la forma del comando con un bloque de script sin conectarse a un equipo remoto; para trabajar de forma remota, sustitúyelo por una llamada con -ComputerName configurado o basada en una sesión:

El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.

$result = Invoke-Command -ScriptBlock { 'Ready to run the remote task.' }
$result

El ejemplo local devuelve la cadena «Ready to run the remote task.»; ese texto se conserva en inglés porque el bloque de código es inmutable.

Para el trabajo remoto, las variables a las que se hace referencia dentro de un bloque de script se evalúan en el lado remoto. Cuando corresponda, pasa los valores locales explícitamente con -ArgumentList y el ámbito automático $using:, y evita incluir contraseñas directamente en el código fuente. Usa New-PSSession en su lugar cuando los comandos posteriores deban compartir una conexión persistente o el estado de una sesión remota.