Compartir a través de

acerca de Remote

Descripción breve

Describe cómo ejecutar comandos remotos en PowerShell.

Descripción larga

Puede ejecutar comandos remotos en uno o varios equipos remotos mediante una conexión temporal o persistente. También puede iniciar una sesión interactiva con un solo equipo remoto.

Nota:

Para usar la comunicación remota de PowerShell, debe configurar los equipos locales y remotos para la comunicación remota. Para obtener más información, consulte about_Remote_Requirements.

Inicio de una sesión interactiva

La manera más fácil de ejecutar comandos remotos es iniciar una sesión interactiva con un equipo remoto.

Cuando se inicia la sesión, los comandos que escriba se ejecutan en el equipo remoto, como si se escriben directamente en el equipo remoto. Solo puede conectarse a un equipo en cada sesión interactiva.

Para iniciar una sesión interactiva, use el cmdlet Enter-PSSession. El comando siguiente inicia una sesión interactiva con el equipo Server01:

Enter-PSSession Server01

PowerShell cambia el símbolo del sistema para incluir el nombre del equipo remoto.

Server01\PS>

Ahora, puede escribir comandos en el equipo Server01.

Para finalizar la sesión interactiva, escriba:

Exit-PSSession

Para obtener más información, vea Enter-PSSession .

Ejecución de un comando remoto

Para ejecutar otros comandos en equipos remotos, use el cmdlet Invoke-Command.

Para ejecutar un solo comando o algunos comandos no relacionados, use el parámetro computerName de de Invoke-Command para especificar los equipos remotos. Use el parámetro ScriptBlock para especificar el comando.

Por ejemplo, el siguiente comando ejecuta un comando Get-Culture en el equipo Server01.

Invoke-Command -ComputerName Server01 -ScriptBlock {Get-Culture}

Creación de una conexión persistente

Cuando se usa el parámetro ComputerName del cmdlet Invoke-Command, PowerShell establece una conexión temporal al equipo remoto. Cierra la conexión cuando se completa el comando. Se pierden las variables o funciones definidas en esta sesión temporal.

Para crear una conexión persistente a un equipo remoto, use el cmdlet New-PSSession. Por ejemplo, el siguiente comando crea PSSessions en los equipos Server01 y Server02 y, a continuación, guarda las PSSessions en la variable $s.

$s = New-PSSession -ComputerName Server01, Server02

Ejecución de comandos en una PSSession

Con psSession, puede ejecutar una serie de comandos remotos que comparten datos, como funciones, alias y los valores de las variables. Para ejecutar comandos en una PSSession, use el parámetro Session del cmdlet Invoke-Command.

Por ejemplo, el comando siguiente usa el cmdlet Invoke-Command para ejecutar un comando Get-Process en psSessions en los equipos Server01 y Server02. El comando guarda los procesos en una variable $p en cada PSSession.

Invoke-Command -Session $s -ScriptBlock {$p = Get-Process}

Dado que PSSession usa una conexión persistente, puede ejecutar otro comando en la misma PSSession que usa la variable $p. El comando siguiente cuenta el número de procesos guardados en $p.

Invoke-Command -Session $s -ScriptBlock {$p.count}

Ejecución de un comando remoto en varios equipos

Para ejecutar un comando remoto en varios equipos, escriba todos los nombres de equipo en el valor del parámetro ComputerName de de Invoke-Command. Separe los nombres con comas.

Por ejemplo, el siguiente comando ejecuta un comando Get-Culture en tres equipos:

Invoke-Command -ComputerName S1, S2, S3 -ScriptBlock {Get-Culture}

También puede ejecutar un comando en varias PSSessions. Los siguientes comandos crean PSSessions en los equipos Server01, Server02 y Server03 y, a continuación, ejecutan un comando Get-Culture en cada una de las PSSessions.

$s = New-PSSession -ComputerName S1, S2, S3
Invoke-Command -Session $s -ScriptBlock {Get-Culture}

Para incluir la lista de equipos locales de equipos, escriba el nombre del equipo local, escriba un punto (.) o escriba localhost.

Invoke-Command -ComputerName S1, S2, S3, localhost -ScriptBlock {Get-Culture}

Ejecución de un script en equipos remotos

Para ejecutar un script local en equipos remotos, use el parámetro FilePath de Invoke-Command. No es necesario copiar ningún archivo. Por ejemplo, el siguiente comando ejecuta el script de Sample.ps1 en los equipos S1 y S2:

Invoke-Command -ComputerName S1, S2 -FilePath C:\Test\Sample.ps1

PowerShell devuelve los resultados del script en el equipo local.

Cómo detener un comando remoto

Para interrumpir un comando, presione Ctrl+c. PowerShell pasa la solicitud de interrupción al equipo remoto donde finaliza el comando remoto.

Para más información

Consulte también

  • Last updated on