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 menjalankan wsl --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 untuk alamat IP distribusi Linux Anda yang diinstal melalui WSL 2 (alamat VM WSL 2)
  • cat /etc/resolv.conf untuk alamat IP komputer Windows seperti yang terlihat dari WSL 2 (WSL 2 VM)

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" atau wsl --mount -o "data=writeback. Namun, hanya opsi khusus sistem file yang didukung saat ini. Opsi umum, seperti ro, , rwatau noatime, 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 .