Perintah dasar untuk WSL
Perintah WSL di bawah ini tercantum dalam format yang didukung oleh PowerShell atau Prompt Perintah Windows. Untuk menjalankan perintah ini dari baris perintah distribusi Bash / Linux, Anda harus mengganti wsl
dengan wsl.exe
. Untuk daftar lengkap perintah, jalankan wsl --help
. Jika Anda belum melakukannya, sebaiknya perbarui ke versi WSL yang diinstal dari Microsoft Store untuk menerima pembaruan WSL segera setelah tersedia. (Pelajari selengkapnya tentang menginstal WSL melalui Microsoft Store.).
Instal
wsl --install
Instal WSL dan distribusi Ubuntu default Linux. Pelajari selengkapnya. Anda juga dapat menggunakan perintah ini untuk menginstal distribusi Linux tambahan dengan menjalankan wsl --install <Distribution Name>
. Untuk daftar nama distribusi yang valid, jalankan wsl --list --online
.
Opsi meliputi:
--distribution
: Tentukan distribusi Linux yang akan diinstal. Anda dapat menemukan distribusi yang tersedia dengan menjalankanwsl --list --online
.--no-launch
: Instal distribusi Linux tetapi jangan luncurkan secara otomatis.--web-download
: Instal dari sumber online daripada menggunakan Microsoft Store.
Ketika opsi WSL tidak diinstal meliputi:
--inbox
: Menginstal WSL menggunakan komponen Windows alih-alih menggunakan Microsoft Store. (Pembaruan WSL akan diterima melalui pembaruan Windows, daripada didorong keluar sebagai tersedia melalui toko).--enable-wsl1
: Mengaktifkan WSL 1 selama penginstalan WSL versi Microsoft Store dengan juga mengaktifkan komponen opsional "Subsistem Windows untuk Linux".--no-distribution
: Jangan instal distribusi saat menginstal WSL.
Catatan
Jika Anda menjalankan WSL pada Windows 10 atau versi yang lebih lama, Anda mungkin perlu menyertakan -d
bendera dengan --install
perintah untuk menentukan distribusi: wsl --install -d <distribution name>
.
Mencantumkan distribusi Linux yang tersedia
wsl --list --online
Lihat daftar distribusi Linux yang tersedia melalui toko online. Perintah ini juga dapat dimasukkan sebagai: wsl -l -o
.
Mencantumkan distribusi Linux yang terinstal
wsl --list --verbose
Lihat daftar distribusi Linux yang diinstal pada komputer Windows Anda, termasuk status (apakah distribusi berjalan atau dihentikan) dan versi WSL yang menjalankan distribusi (WSL 1 atau WSL 2). Membandingkan WSL 1 dan WSL 2. Perintah ini juga dapat dimasukkan sebagai: wsl -l -v
. Opsi tambahan yang dapat digunakan dengan perintah daftar meliputi: --all
untuk mencantumkan semua distribusi, --running
untuk mencantumkan hanya distribusi yang saat ini berjalan, atau --quiet
untuk hanya menampilkan nama distribusi.
Atur versi WSL ke 1 atau 2
wsl --set-version <distribution name> <versionNumber>
Untuk menunjuk versi WSL (1 atau 2) tempat distribusi Linux berjalan, ganti <distribution name>
dengan nama distribusi dan ganti <versionNumber>
dengan 1 atau 2. Membandingkan WSL 1 dan WSL 2. WSL 2 hanya tersedia di Windows 11 atau Windows 10, Versi 1903, Build 18362 atau yang lebih baru.
Peringatan
Beralih antara WSL 1 dan WSL 2 dapat memakan waktu dan mengakibatkan kegagalan karena perbedaan antara kedua arsitektur. Untuk distribusi dengan proyek besar, sebaiknya cadangkan file sebelum mencoba konversi.
Mengatur versi WSL default
wsl --set-default-version <Version>
Untuk mengatur versi default WSL 1 atau WSL 2, ganti <Version>
dengan angka 1 atau 2. Contohnya,wsl --set-default-version 2
. Angka tersebut menunjukkan versi WSL ke default untuk penginstalan distribusi Linux baru. Membandingkan WSL 1 dan WSL 2. WSL 2 hanya tersedia di Windows 11 atau Windows 10, Versi 1903, Build 18362 atau yang lebih baru.
Mengatur distribusi Linux default
wsl --set-default <Distribution Name>
Untuk mengatur distribusi Linux default yang akan digunakan perintah WSL untuk dijalankan, ganti <Distribution Name>
dengan nama distribusi Linux pilihan Anda.
Ubah direktori ke rumah
wsl ~
~
dapat digunakan dengan wsl untuk memulai di direktori beranda pengguna. Untuk melompat dari direktori apa pun kembali ke rumah dari dalam prompt perintah WSL, Anda dapat menggunakan perintah: cd ~
.
Menjalankan distribusi Linux tertentu dari PowerShell atau CMD
wsl --distribution <Distribution Name> --user <User Name>
Untuk menjalankan distribusi Linux tertentu dengan pengguna tertentu, ganti <Distribution Name>
dengan nama distribusi Linux pilihan Anda (yaitu. Debian) dan <User Name>
dengan nama pengguna yang ada (yaitu root). Jika pengguna tidak ada dalam distribusi WSL, Anda akan menerima kesalahan. Untuk mencetak nama pengguna saat ini, gunakan perintah whoami
.
Memperbarui WSL
wsl --update
Perbarui versi WSL Anda ke versi terbaru. Opsi meliputi:
--web-download
: Unduh pembaruan terbaru dari GitHub daripada Microsoft Store.
Periksa status WSL
wsl --status
Lihat informasi umum tentang konfigurasi WSL Anda, seperti jenis distribusi default, distribusi default, dan versi kernel.
Periksa versi WSL
wsl --version
Periksa informasi versi tentang WSL dan komponennya.
Perintah Bantuan
wsl --help
Lihat daftar opsi dan perintah yang tersedia dengan WSL.
Jalankan sebagai pengguna tertentu
wsl --user <Username>
Untuk menjalankan WSL sebagai pengguna tertentu, ganti <Username>
dengan nama pengguna yang ada di distribusi WSL.
Mengubah pengguna default untuk distribusi
<DistributionName> config --default-user <Username>
Ubah pengguna default untuk masuk distribusi Anda. Pengguna harus sudah ada di dalam distribusi untuk menjadi pengguna default.
Misalnya: ubuntu config --default-user johndoe
akan mengubah pengguna default untuk distribusi Ubuntu ke pengguna "johndoe".
Catatan
Jika Anda mengalami masalah saat mencari tahu nama distribusi Anda, gunakan perintah wsl -l
.
Peringatan
Perintah ini tidak akan berfungsi untuk distribusi yang diimpor, karena distribusi ini tidak memiliki peluncur yang dapat dieksekusi. Anda dapat mengubah pengguna default untuk distribusi yang diimpor menggunakan /etc/wsl.conf
file . Lihat opsi Automount di dokumen Konfigurasi Pengaturan Tingkat Lanjut.
Matikan
wsl --shutdown
Segera mengakhiri semua distribusi yang sedang berjalan dan komputer virtual utilitas ringan WSL 2. Perintah ini mungkin diperlukan dalam instans yang mengharuskan Anda untuk menghidupkan ulang lingkungan komputer virtual WSL 2, seperti mengubah batas penggunaan memori atau membuat perubahan pada file .wslconfig Anda.
Mengakhiri
wsl --terminate <Distribution Name>
Untuk mengakhiri distribusi yang ditentukan, atau menghentikannya agar tidak berjalan, ganti <Distribution Name>
dengan nama distribusi yang ditargetkan.
Identifikasi alamat IP
wsl hostname -I
: Mengembalikan alamat IP distribusi Linux Anda yang diinstal melalui WSL 2 (alamat VM WSL 2)ip route show | grep -i default | awk '{ print $3}'
: Mengembalikan alamat IP komputer Windows seperti yang terlihat dari WSL 2 (WSL 2 VM)
Untuk penjelasan yang lebih rinci, lihat Mengakses aplikasi jaringan dengan WSL: Mengidentifikasi Alamat IP.
Mengekspor distribusi
wsl --export <Distribution Name> <FileName>
Mengekspor rekam jepret dari distribusi yang ditentukan sebagai file distribusi baru. Default ke format tar. Nama file dapat untuk -
input standar. Opsi meliputi:
--vhd
: Menentukan distribusi ekspor harus berupa file .vhdx alih-alih file tar (ini hanya didukung menggunakan WSL 2)
Mengimpor distribusi
wsl --import <Distribution Name> <InstallLocation> <FileName>
Mengimpor file tar yang ditentukan sebagai distribusi baru. Nama file dapat untuk -
input standar. Opsi meliputi:
--vhd
: Menentukan distribusi impor harus berupa file .vhdx alih-alih file tar (ini hanya didukung menggunakan WSL 2)--version <1/2>
: Menentukan apakah akan mengimpor distribusi sebagai distribusi WSL 1 atau WSL 2
Mengimpor distribusi di tempat
wsl --import-in-place <Distribution Name> <FileName>
Mengimpor file .vhdx yang ditentukan sebagai distribusi baru. Hard disk virtual harus diformat dalam jenis sistem file ext4.
Membatalkan pendaftaran atau menghapus instalan distribusi Linux
Meskipun distribusi Linux dapat diinstal melalui Microsoft Store, distribusi tersebut tidak dapat dihapus instalasinya melalui penyimpanan.
Untuk membatalkan pendaftaran dan menghapus instalan distribusi WSL:
wsl --unregister <DistributionName>
<DistributionName>
Mengganti dengan nama distribusi Linux yang Anda targetkan akan membatalkan pendaftaran distribusi tersebut dari WSL sehingga dapat diinstal ulang atau dibersihkan. Perhatian: Setelah tidak terdaftar, semua data, pengaturan, dan perangkat lunak yang terkait dengan distribusi tersebut akan hilang secara permanen. Menginstal ulang dari penyimpanan akan menginstal salinan distribusi yang bersih. Misalnya, wsl --unregister Ubuntu
akan menghapus Ubuntu dari distribusi yang tersedia di WSL. Menjalankan wsl --list
akan mengungkapkan bahwa itu tidak lagi terdaftar.
Anda juga dapat menghapus instalan aplikasi distribusi Linux di komputer Windows Sama seperti aplikasi toko lainnya. Untuk menginstal ulang, temukan distribusi di Microsoft Store dan pilih "Luncurkan".
Memasang disk atau perangkat
wsl --mount <DiskPath>
Lampirkan dan pasang disk fisik di semua distribusi WSL2 dengan mengganti <DiskPath>
dengan jalur directory\file tempat disk berada. Lihat Memasang disk Linux di WSL 2. Opsi meliputi:
--vhd
: Menentukan yang<Disk>
mengacu pada hard disk virtual.--name
: Pasang disk menggunakan nama kustom untuk titik pemasangan--bare
: Lampirkan disk ke WSL2, tetapi jangan pasang.--type <Filesystem>
: Jenis sistem file yang akan digunakan saat memasang disk, jika tidak ditentukan default ke ext4. Perintah ini juga dapat dimasukkan sebagai:wsl --mount -t <Filesystem>
. Anda dapat mendeteksi jenis sistem file menggunakan perintah:blkid <BlockDevice>
, misalnya:blkid <dev/sdb1>
.--partition <Partition Number>
: Nomor indeks partisi yang akan dipasang, jika tidak ditentukan default ke seluruh disk.--options <MountOptions>
: Ada beberapa opsi khusus sistem file yang dapat disertakan saat memasang disk. Misalnya, opsi pemasangan ext4 seperti:wsl --mount -o "data-ordered"
atauwsl --mount -o "data=writeback
. Namun, hanya opsi khusus sistem file yang didukung saat ini. Opsi umum, sepertiro
, ,rw
ataunoatime
, tidak didukung.
Catatan
Jika Anda menjalankan proses 32-bit untuk mengakses wsl.exe (alat 64-bit), Anda mungkin perlu menjalankan perintah dengan cara berikut: C:\Windows\Sysnative\wsl.exe --command
.
Melepaskan disk
wsl --unmount <DiskPath>
Lepaskan disk yang diberikan di jalur disk, jika tidak ada jalur disk yang diberikan maka perintah ini akan melepas dan melepaskan SEMUA disk yang dipasang.
Perintah WSL yang tidak digunakan lagi
wslconfig.exe [Argument] [Options]
bash [Options]
lxrun /[Argument]
Perintah ini adalah sintaks wsl asli untuk mengonfigurasi distribusi Linux yang diinstal dengan WSL, tetapi telah diganti dengan wsl
sintaks perintah atau wsl.exe
.
Windows Subsystem for Linux