about_Remote

Krátký popis

Popisuje, jak spustit vzdálené příkazy v PowerShellu.

Dlouhý popis

Vzdálené příkazy můžete spouštět na jednom nebo několika vzdálených počítačích pomocí dočasného nebo trvalého připojení. Můžete také spustit interaktivní relaci s jedním vzdáleným počítačem.

Poznámka:

Pokud chcete používat vzdálenou komunikace PowerShellu, musíte nakonfigurovat místní a vzdálené počítače pro vzdálenou komunikace. Další informace najdete v tématu about_Remote_Requirements.

Jak spustit interaktivní relaci

Nejjednodušší způsob, jak spustit vzdálené příkazy, je spustit interaktivní relaci se vzdáleným počítačem.

Po spuštění relace se příkazy, které zadáte na vzdáleném počítači, spustí, jako kdybyste je zadali přímo na vzdáleném počítači. V každé interaktivní relaci se můžete připojit jenom k jednomu počítači.

Pokud chcete spustit interaktivní relaci, použijte tuto rutinu Enter-PSSession . Následující příkaz spustí interaktivní relaci s počítačem Server01:

Enter-PSSession Server01

PowerShell změní příkazový řádek tak, aby zahrnoval název vzdáleného počítače.

Server01\PS>

Teď můžete psát příkazy na počítači Server01.

Chcete-li ukončit interaktivní relaci, zadejte:

Exit-PSSession

Další informace naleznete v tématu Enter-PSSession.

Spuštění vzdáleného příkazu

Pokud chcete na vzdálených počítačích spustit další příkazy, použijte tuto rutinu Invoke-Command .

Pokud chcete spustit jeden příkaz nebo několik nesouvisejících příkazů, zadejte vzdálené počítače pomocí parametru Invoke-Command ComputerName. K zadání příkazu použijte parametr ScriptBlock.

Například následující příkaz spustí Get-Culture příkaz na počítači Server01.

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

Jak vytvořit trvalé připojení

Pokud použijete parametr Invoke-Command ComputerName rutiny, PowerShell vytvoří dočasné připojení ke vzdálenému počítači. Po dokončení příkazu se připojení zavře. Všechny proměnné nebo funkce definované v této dočasné relaci se ztratí.

Pokud chcete vytvořit trvalé připojení ke vzdálenému počítači, použijte rutinu New-PSSession . Například následující příkaz vytvoří psSessions na počítačích Server01 a Server02 a potom uloží psSessions do $s proměnné.

$s = New-PSSession -ComputerName Server01, Server02

Spouštění příkazů v psSession

Pomocí psSession můžete spustit řadu vzdálených příkazů, které sdílejí data, jako jsou funkce, aliasy a hodnoty proměnných. Pokud chcete spouštět příkazy v psSession, použijte parametr Session rutiny Invoke-Command .

Například následující příkaz používá rutinu Invoke-Command ke spuštění Get-Process příkazu v psSessions na počítačích Server01 a Server02. Příkaz uloží procesy do $p proměnné v každé psSession.

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

Vzhledem k tomu, že psSession používá trvalé připojení, můžete spustit jiný příkaz ve stejné PSSession, který používá proměnnou $p . Následující příkaz spočítá počet procesů uložených v $p.

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

Spuštění vzdáleného příkazu na více počítačích

Chcete-li spustit vzdálený příkaz na více počítačích, zadejte všechny názvy počítačů v hodnotě Parametr ComputerName parametru Invoke-Command. Názvy oddělte čárkami.

Následující příkaz například spustí Get-Culture příkaz na třech počítačích:

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

Můžete také spustit příkaz ve více psSessions. Následující příkazy vytvoří psSessions na počítačích Se serverem 01, Server02 a Server03 a potom spustí Get-Culture příkaz v každé z psSessions.

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

Chcete-li zahrnout seznam počítačů místního počítače, zadejte název místního počítače, zadejte tečku (.) nebo typ localhost.

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

Spuštění skriptu na vzdálených počítačích

Chcete-li spustit místní skript na vzdálených počítačích, použijte parametr FilePath parametru Invoke-Command. Nemusíte kopírovat žádné soubory. Například následující příkaz spustí Sample.ps1 skript na počítačích S1 a S2:

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

PowerShell vrátí výsledky skriptu do místního počítače.

Zastavení vzdáleného příkazu

Pokud chcete příkaz přerušit, stiskněte ctrl +c. PowerShell předá žádost o přerušení vzdálenému počítači, kde ukončí vzdálený příkaz.

Další informace

  • Informace o požadavcích na systém pro vzdálené komunikace najdete v tématu about_Remote_Requirements.

  • Nápovědu k formátování vzdáleného výstupu najdete v tématu about_Remote_Output.

  • Informace o tom, jak vzdálená komunikace funguje, jak spravovat vzdálená data, speciální konfigurace, problémy se zabezpečením a další nejčastější dotazy, najdete v nejčastějších dotazech ke vzdálené komunikaci PowerShellu.

  • Nápovědu k řešení chyb vzdálené komunikace najdete v tématu about_Remote_Troubleshooting.

  • Informace o instancích PSSession a trvalých připojeních najdete v tématu about_PSSessions.

  • Informace o úlohách na pozadí PowerShellu najdete v tématu about_Jobs.

Viz také