WSL için temel komutlar

Aşağıdaki WSL komutları PowerShell veya Windows Komut İstemi tarafından desteklenen bir biçimde listelenmiştir. Bu komutları bir Bash / Linux dağıtım komut satırından çalıştırmak için wsl yerine wsl.exedeğerini kullanmanız gerekir. Komutların tam listesi için wsl --helpçalıştırın. Henüz yapmadıysanız, WSL güncelleştirmelerini kullanılabilir oldukları anda almak için Microsoft Store'dan yüklenen WSL sürümüne güncelleştirme öneririz. (WSL'yi Microsoft Store aracılığıyla yükleme hakkında daha fazla bilgi edinin.).

Yüklemek

wsl --install

WSL'yi ve Linux'un varsayılan Ubuntu dağıtımını yükleyin. daha fazla bilgi edinin. bu komutu wsl --install <Distribution Name>çalıştırarak ek Linux dağıtımlarını yüklemek için de kullanabilirsiniz. Geçerli bir dağıtım adları listesi için wsl --list --onlineçalıştırın.

Seçenekler şunlardır:

• --distribution: Yüklenecek Linux dağıtımını belirtin. wsl --list --onlineçalıştırarak kullanılabilir dağıtımları bulabilirsiniz.
• --no-launch: Linux dağıtımını yükleyin, ancak otomatik olarak başlatmayın.
• --web-download: Microsoft Store'u kullanmak yerine çevrimiçi bir kaynaktan yükleyin.

WSL yüklü olmadığında seçenekler şunlardır:

• --inbox: WSL'yi Microsoft Store yerine Windows bileşenini kullanarak yükler. (WSL güncelleştirmeleri mağaza üzerinden kullanılabilir olarak gönderilmek yerine Windows güncelleştirmeleri aracılığıyla alınır).
• --enable-wsl1: "Linux için Windows Alt Sistemi" isteğe bağlı bileşenini de etkinleştirerek WSL'nin Microsoft Store sürümünün yüklenmesi sırasında WSL 1'i etkinleştirir.
• --no-distribution: WSL'yi yüklerken dağıtım yüklemeyin.

Not Alınız

WSL'yi Windows 10'da veya daha eski bir sürümde çalıştırıyorsanız, bir dağıtım belirtmek için -d komutuyla --install bayrağını eklemeniz gerekebilir: wsl --install -d <distribution name>.

Kullanılabilir Linux dağıtımlarını listeleme

wsl --list --online

Çevrimiçi mağaza üzerinden kullanılabilen Linux dağıtımlarının listesine bakın. Bu komut şu şekilde de girilebilir: wsl -l -o.

Yüklü Linux dağıtımlarını listeleme

wsl --list --verbose

Durumu (dağıtımın çalışıp çalışmadığı veya durdurulduğu) ve dağıtımı çalıştıran WSL sürümü (WSL 1 veya WSL 2) dahil olmak üzere Windows makinenizde yüklü Linux dağıtımlarının listesine bakın. WSL 1 ve WSL 2 karşılaştırması. Bu komut şu şekilde de girilebilir: wsl -l -v. Liste komutuyla kullanılabilen ek seçenekler şunlardır: tüm dağıtımları listelemek için --all, yalnızca çalışmakta olan dağıtımları listelemek --running veya yalnızca dağıtım adlarını göstermek için --quiet.

WSL sürümünü 1 veya 2 olarak ayarlama

wsl --set-version <distribution name> <versionNumber>

Linux dağıtımının üzerinde çalıştığı WSL (1 veya 2) sürümünü ayarlamak için <distribution name> dağıtım adıyla değiştirin ve <versionNumber> 1 veya 2 ile değiştirin. WSL 1 ve WSL 2 karşılaştırması. WSL 2 yalnızca Windows 11 veya Windows 10, Sürüm 1903, Derleme 18362 veya sonraki sürümlerde kullanılabilir.

Uyarı

WSL 1 ile WSL 2 arasında geçiş yapmak zaman alabilir ve iki mimari arasındaki farklardan dolayı hatalara neden olabilir. Büyük projeleri olan dağıtımlar için, dönüştürmeyi denemeden önce dosyaları yedeklemenizi öneririz.

Varsayılan WSL sürümünü ayarlama

wsl --set-default-version <Version>

Varsayılan WSL 1 veya WSL 2 sürümünü ayarlamak için <Version> değerini 1 veya 2 sayısıyla değiştirin. Örneğin, wsl --set-default-version 2. Sayı, yeni Linux dağıtım yüklemeleri için varsayılan olarak WSL sürümünü temsil eder. WSL 1 ve WSL 2 karşılaştırması. WSL 2 yalnızca Windows 11 veya Windows 10, Sürüm 1903, Derleme 18362 veya sonraki sürümlerde kullanılabilir.

Varsayılan Linux dağıtımlarını ayarlama

wsl --set-default <Distribution Name>

WSL komutlarının çalıştırmak için kullanacağı varsayılan Linux dağıtımını ayarlamak için <Distribution Name> tercih ettiğiniz Linux dağıtımının adıyla değiştirin.

Kullanıcının home dizininde WSL'i başlat

wsl ~

~, kullanıcının giriş dizininde başlamak için wsl ile kullanılabilir. WSL komut isteminden herhangi bir dizinden ana dizine geri atlamak için şu komutu kullanabilirsiniz: cd ~.

PowerShell veya CMD'den belirli bir Linux dağıtımı çalıştırma

wsl --distribution <Distribution Name> --user <User Name>

Belirli bir Linux dağıtımını belirli bir kullanıcıyla çalıştırmak için <Distribution Name> tercih ettiğiniz Linux dağıtımının adıyla değiştirin (örneğin. debian) ve mevcut bir kullanıcının (kök) adıyla <User Name>. Kullanıcı WSL dağıtımında yoksa bir hata alırsınız. Geçerli kullanıcı adını yazdırmak için whoamikomutunu kullanın.

WSL'i güncelleştirme

wsl --update

WSL sürümünüzü en son sürüme güncelleştirin. Seçenekler şunlardır:

• --web-download: En son güncelleştirmeyi Microsoft Store yerine GitHub'dan indirin.

WSL durumunu denetleme

wsl --status

Varsayılan dağıtım türü, varsayılan dağıtım ve çekirdek sürümü gibi WSL yapılandırmanız hakkında genel bilgilere bakın.

WSL sürümünü denetleme

wsl --version

WSL ve bileşenleri hakkındaki sürüm bilgilerini denetleyin.

Yardım komutu

wsl --help

WSL ile kullanılabilen seçeneklerin ve komutların listesine bakın.

Belirli bir kullanıcı olarak çalıştır

wsl --user <Username>

WSL'yi belirtilen kullanıcı olarak çalıştırmak için <Username> WSL dağıtımında bulunan bir kullanıcının adıyla değiştirin.

Dağıtım için varsayılan kullanıcıyı değiştirme

<DistributionName> config --default-user <Username>

Dağıtım oturum açma işleminiz için varsayılan kullanıcıyı değiştirin. Kullanıcının varsayılan kullanıcı olabilmesi için dağıtımın içinde zaten bulunması gerekir.

Örneğin: ubuntu config --default-user johndoe Ubuntu dağıtımı için varsayılan kullanıcıyı "johndoe" kullanıcı olarak değiştirir.

Not Alınız

Dağıtımınızın adını bulmakta sorun yaşıyorsanız wsl -lkomutunu kullanın.

Uyarı

Bu dağıtımların yürütülebilir başlatıcısı olmadığından, bu komut içeri aktarılan dağıtımlar için çalışmaz. Bunun yerine, /etc/wsl.conf dosyasını kullanarak içeri aktarılan dağıtımlar için varsayılan kullanıcıyı değiştirebilirsiniz. Gelişmiş Ayarlar Yapılandırması belgesindeki Otomatik Bağlama seçeneklerine bakın.

Kapatma

wsl --shutdown

Çalışan tüm dağıtımları ve WSL 2 hafif yardımcı sanal makinesini derhal sonlandırır. Bu komut, bellek kullanım sınırlarını değiştirme veya .wslconfig dosyanızda değişiklik gibi WSL 2 sanal makine ortamını yeniden başlatmanızı gerektiren örneklerde gerekli olabilir.

Bitirmek

wsl --terminate <Distribution Name>

Belirtilen dağıtımı sonlandırmak veya çalışmasını durdurmak için <Distribution Name> hedeflenen dağıtımın adıyla değiştirin.

IP adresini tanımlama

• wsl hostname -I: WSL 2 (WSL 2 VM adresi) aracılığıyla yüklenen Linux dağıtımınızın IP adresini döndürür
• ip route show | grep -i default | awk '{ print $3}': WSL 2'den (WSL 2 VM) görüldüğü gibi Windows makinesinin IP adresini döndürür

Daha ayrıntılı bir açıklama için bkz. WSL ile ağ uygulamalarına erişme: IP Adresini tanımlama.

Dağıtımı dışa aktarma

wsl --export <Distribution Name> <FileName>

Belirtilen dağıtımın anlık görüntüsünü yeni bir dağıtım dosyası olarak dışarı aktarır. Varsayılan olarak tar formatına sahiptir. Dosya adı standart giriş için - olabilir. Seçenekler şunlardır:

• --vhd: Dışarı aktarma dağıtımının tar dosyası yerine .vhdx dosyası olması gerektiğini belirtir (bu yalnızca WSL 2 kullanılarak desteklenir)

Dağıtımı içeri aktarma

wsl --import <Distribution Name> <InstallLocation> <FileName>

Belirtilen tar dosyasını yeni bir dağıtım olarak içeri aktarır. Dosya adı standart giriş için - olabilir. Seçenekler şunlardır:

• --vhd: İçeri aktarma dağıtımının tar dosyası yerine .vhdx dosyası olması gerektiğini belirtir (bu yalnızca WSL 2 kullanılarak desteklenir)
• --version <1/2>: Dağıtımın WSL 1 veya WSL 2 dağıtımı olarak içeri aktarılıp aktarılmayacağını belirtir

Dağıtımı yerinde aktarma

wsl --import-in-place <Distribution Name> <FileName>

Belirtilen .vhdx dosyasını yeni bir dağıtım olarak içeri aktarır. Sanal sabit disk ext4 dosya sistemi türünde biçimlendirilmelidir.

Linux dağıtımının kaydını silme veya kaldırma

Linux dağıtımları Microsoft Store üzerinden yüklenebilir ancak mağaza üzerinden kaldırılamaz.

WSL dağıtımını kayıttan silmek ve kaldırmak için:

wsl --unregister <DistributionName>

Hedeflediğiniz Linux dağıtım ismiyle <DistributionName>'ı değiştirmek, bu dağıtımın WSL'den kaydını kaldırır, böylece yeniden yüklenebilir veya temizlenebilir. Dikkat: Kayıt silindikten sonra, bu dağıtımla ilişkili tüm veriler, ayarlar ve yazılımlar kalıcı olarak kaybolur. Mağazadan yeniden yükleme, dağıtımın temiz bir kopyasını yükler. Örneğin, wsl --unregister Ubuntu WSL'de kullanılabilen dağıtımlardan Ubuntu'yı kaldırır. wsl --list çalıştırılırsa artık listelenmediğini gösterir.

Windows makinenizdeki Linux dağıtım uygulamasını da diğer mağaza uygulamaları gibi kaldırabilirsiniz. Yeniden yüklemek için Microsoft Store'da dağıtımı bulun ve "Başlat"ı seçin.

Disk veya cihaz bağlama

wsl --mount <DiskPath>

<DiskPath> yerine diskin bulunduğu dizin\dosya yolunu yazarak tüm WSL2 dağıtımlarına fiziksel disk ekleyin ve bağlayın. Bkz. WSL 2'de bir Linux diski bağlama . Seçenekler şunlardır:

• --vhd: <Disk>'in bir sanal sabit diske atıfta bulunduğunu belirtir.
• --name: Bağlama noktası için özel bir ad kullanarak diski bağlama
• --bare: Diski WSL2'ye takın, ancak bağlamayın.
• --type <Filesystem>: Disk bağlanırken kullanılacak dosya sistemi türü, belirtilmemişse varsayılan olarak ext4 olarak belirlenmiştir. Bu komut şu şekilde de girilebilir: wsl --mount -t <Filesystem>. Dosya sistemi türünü algılamak için şu komutu kullanabilirsiniz: blkid <BlockDevice>, örneğin: blkid <dev/sdb1>.
• --partition <Partition Number>: Belirtilmezse, bağlanacak bölümün dizin numarası diskin tamamı için varsayılandır.
• --options <MountOptions>: Disk bağlanırken ekleyebileceğiniz dosya sistemine özgü bazı seçenekler vardır. Örneğin, ext4 bağlama seçenekleri gibi: wsl --mount -o "data-ordered" veya wsl --mount -o "data=writeback. Ancak şu anda yalnızca dosya sistemine özgü seçenekler desteklenmektedir. ro, rwveya noatimegibi genel seçenekler desteklenmez.

Not Alınız

wsl.exe (64 bit araç) erişmek için 32 bitlik bir işlem çalıştırıyorsanız, komutunu şu şekilde çalıştırmanız gerekebilir: C:\Windows\Sysnative\wsl.exe --command.

Diskleri çıkarma

wsl --unmount <DiskPath>

Disk yolunda belirtilen bir diski çıkartın. Eğer bir disk yolu verilmezse, bu komut TAKILI olan TÜM diskleri çıkartır ve ayırır.

Kullanım dışı WSL komutları

wslconfig.exe [Argument] [Options]

bash [Options]

lxrun /[Argument]

Bu komutlar, WSL ile yüklenen Linux dağıtımlarını yapılandırmaya yönelik özgün wsl söz dizimiydi, ancak wsl veya wsl.exe komut söz dizimi ile değiştirildi.