about_Remote
Deskripsi singkat
Menjelaskan cara menjalankan perintah jarak jauh di PowerShell.
Deskripsi panjang
Anda dapat menjalankan perintah jarak jauh pada satu atau beberapa komputer jarak jauh menggunakan koneksi sementara atau persisten. Anda juga dapat memulai sesi interaktif dengan satu komputer jarak jauh.
Catatan
Untuk menggunakan remoting PowerShell, Anda harus mengonfigurasi komputer lokal dan jarak jauh untuk jarak jauh. Untuk informasi selengkapnya, lihat about_Remote_Requirements.
Cara memulai sesi interaktif
Cara term mudah untuk menjalankan perintah jarak jauh adalah dengan memulai sesi interaktif dengan komputer jarak jauh.
Ketika sesi dimulai, perintah yang Anda ketik berjalan di komputer jarak jauh, seolah-olah Anda mengetiknya langsung di komputer jarak jauh. Anda hanya dapat tersambung ke satu komputer di setiap sesi interaktif.
Untuk memulai sesi interaktif, gunakan Enter-PSSession
cmdlet. Perintah berikut memulai sesi interaktif dengan komputer Server01:
Enter-PSSession Server01
PowerShell mengubah prompt perintah untuk menyertakan nama komputer jarak jauh.
Server01\PS>
Sekarang, Anda dapat mengetik perintah di komputer Server01.
Untuk mengakhiri sesi interaktif, ketik:
Exit-PSSession
Untuk informasi selengkapnya, lihat Enter-PSSession.
Cara menjalankan perintah jarak jauh
Untuk menjalankan perintah lain pada komputer jarak jauh, gunakan Invoke-Command
cmdlet.
Untuk menjalankan satu perintah atau beberapa perintah yang tidak terkait, gunakan parameter ComputerName untuk Invoke-Command
menentukan komputer jarak jauh. Gunakan parameter ScriptBlock untuk menentukan perintah.
Misalnya, perintah berikut menjalankan Get-Culture
perintah di komputer Server01.
Invoke-Command -ComputerName Server01 -ScriptBlock {Get-Culture}
Cara membuat koneksi persisten
Saat Anda menggunakan parameter ComputerName cmdlet Invoke-Command
, PowerShell membuat koneksi sementara ke komputer jarak jauh. Ini menutup koneksi ketika perintah selesai. Variabel atau fungsi apa pun yang ditentukan dalam sesi sementara ini hilang.
Untuk membuat koneksi persisten ke komputer jarak jauh, gunakan New-PSSession
cmdlet. Misalnya, perintah berikut membuat PSSessions di komputer Server01 dan Server02 lalu menyimpan PSSessions dalam $s
variabel.
$s = New-PSSession -ComputerName Server01, Server02
Cara menjalankan perintah dalam PSSession
Dengan PSSession, Anda dapat menjalankan serangkaian perintah jarak jauh yang berbagi data, seperti fungsi, alias, dan nilai variabel. Untuk menjalankan perintah dalam PSSession, gunakan parameter Sesi cmdlet Invoke-Command
.
Misalnya, perintah berikut menggunakan Invoke-Command
cmdlet untuk menjalankan Get-Process
perintah di PSSessions pada komputer Server01 dan Server02.
Perintah menyimpan proses dalam $p
variabel di setiap PSSession.
Invoke-Command -Session $s -ScriptBlock {$p = Get-Process}
Karena PSSession menggunakan koneksi persisten, Anda dapat menjalankan perintah lain dalam PSSession yang sama yang menggunakan $p
variabel . Perintah berikut menghitung jumlah proses yang disimpan di $p
.
Invoke-Command -Session $s -ScriptBlock {$p.count}
Cara menjalankan perintah jarak jauh di beberapa komputer
Untuk menjalankan perintah jarak jauh pada beberapa komputer, ketik semua nama komputer dalam nilai parameter ComputerName dari Invoke-Command
. Pisahkan nama dengan koma.
Misalnya, perintah berikut menjalankan Get-Culture
perintah di tiga komputer:
Invoke-Command -ComputerName S1, S2, S3 -ScriptBlock {Get-Culture}
Anda juga dapat menjalankan perintah di beberapa PSSessions. Perintah berikut membuat PSSessions di komputer Server01, Server02, dan Server03 lalu menjalankan Get-Culture
perintah di setiap PSSessions.
$s = New-PSSession -ComputerName S1, S2, S3
Invoke-Command -Session $s -ScriptBlock {Get-Culture}
Untuk menyertakan daftar komputer lokal, ketik nama komputer lokal, ketik titik (.
), atau ketik localhost
.
Invoke-Command -ComputerName S1, S2, S3, localhost -ScriptBlock {Get-Culture}
Cara menjalankan skrip di komputer jarak jauh
Untuk menjalankan skrip lokal di komputer jarak jauh, gunakan parameter FilePath dari Invoke-Command
. Anda tidak perlu menyalin file apa pun. Misalnya, perintah berikut menjalankan Sample.ps1
skrip di komputer S1 dan S2:
Invoke-Command -ComputerName S1, S2 -FilePath C:\Test\Sample.ps1
PowerShell mengembalikan hasil skrip ke komputer lokal.
Cara menghentikan perintah jarak jauh
Untuk mengganggu perintah, tekan Ctrl+c. PowerShell meneruskan permintaan interupsi ke komputer jarak jauh di mana ia mengakhiri perintah jarak jauh.
Untuk informasi lebih lanjut
Untuk informasi tentang persyaratan sistem untuk jarak jauh, lihat about_Remote_Requirements.
Untuk bantuan dalam memformat output jarak jauh, lihat about_Remote_Output.
Untuk informasi tentang cara kerja jarak jauh, cara mengelola data jarak jauh, konfigurasi khusus, masalah keamanan, dan pertanyaan umum lainnya, lihat Tanya Jawab Umum PowerShell Remoting.
Untuk bantuan dalam mengatasi kesalahan jarak jauh, lihat about_Remote_Troubleshooting.
Untuk informasi tentang PSSessions dan koneksi persisten, lihat about_PSSessions.
Untuk informasi tentang pekerjaan latar belakang PowerShell, lihat about_Jobs.