Alapszintű parancsok a WSL-hez

Az alábbi WSL-parancsok a PowerShell vagy a Windows parancssor által támogatott formátumban jelennek meg. Ha ezeket a parancsokat Bash/Linux terjesztési parancssorból szeretné futtatni, wslwsl.exekell lecserélnie. A parancsok teljes listájához futtassa a wsl --help. Ha még nem tette meg, javasoljuk, hogy frissítsen a Microsoft Store-ból telepített WSL-verzióra annak érdekében, hogy a WSL-frissítések azonnal elérhetők legyenek. (További információ a WSL Microsoft Store-on keresztüli telepítéséről.).

Felszerel

wsl --install

Telepítse a WSL-t és a Linux alapértelmezett Ubuntu-disztribúcióját. További információ. Ezzel a paranccsal további Linux-disztribúciókat is telepíthet a wsl --install <Distribution Name>futtatásával. Az érvényes terjesztési nevek listájához futtassa a wsl --list --onlineparancsot.

A lehetőségek a következők:

• --distribution: Adja meg a telepíteni kívánt Linux-disztribúciót. Az elérhető disztribúciók a wsl --list --onlinefuttatásával érhetők el.
• --no-launch: Telepítse a Linux-disztribúciót, de ne indítsa el automatikusan.
• --web-download: Telepítés online forrásból a Microsoft Store helyett.
• --location: Adja meg, hogy melyik mappába szeretné telepíteni a WSL-disztribúciót.

Ha a WSL nincs telepítve, a következő lehetőségek közül választhat:

• --inbox: A WSL telepítése a Windows-összetevővel a Microsoft Store használata helyett. (A WSL-frissítések a Windows-frissítéseken keresztül érkeznek, ahelyett, hogy az áruházon keresztül elérhetőként küldik el).
• --enable-wsl1: Engedélyezi a WSL 1-et a WSL Microsoft Store-verziójának telepítése során a "Windows Alrendszer Linuxhoz" opcionális összetevő engedélyezésével.
• --no-distribution: A WSL telepítésekor ne telepítsen disztribúciót.

Jegyzet

Ha Windows 10-en vagy régebbi verzióban futtatja a WSL-t, előfordulhat, hogy a -d jelzőt a --install paranccsal kell megadnia a következő eloszlás megadásához: wsl --install -d <distribution name>.

Elérhető Linux-disztribúciók listázása

wsl --list --online

Tekintse meg az online áruházon keresztül elérhető Linux-disztribúciók listáját. Ez a parancs a következőként is megadható: wsl -l -o.

Telepített Linux-disztribúciók listázása

wsl --list --verbose

Tekintse meg a Windows-gépen telepített Linux-disztribúciók listáját, beleértve az állapotot (függetlenül attól, hogy a disztribúció fut vagy le van-e állítva) és a disztribúciót futtató WSL-verziót (WSL 1 vagy WSL 2). A WSL 1 és a WSL 2összehasonlítása. Ez a parancs a következőként is megadható: wsl -l -v. A listaparancsgal használható további lehetőségek a következők: --all az összes disztribúció listázására, --running csak az éppen futó disztribúciók listázására, vagy --quiet csak a terjesztési nevek megjelenítésére.

WSL-verzió beállítása 1 vagy 2 értékre

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

A WSL (1 vagy 2) linuxos disztribúció által futtatott verziójának kijelöléséhez cserélje le a <distribution name> a disztribúció nevére, és cserélje le a <versionNumber> 1 vagy 2-esre. A WSL 1 és a WSL 2összehasonlítása. A WSL 2 csak Windows 11 vagy Windows 10, 1903-es, 18362-es vagy újabb buildben érhető el.

Figyelmeztetés

A WSL 1 és a WSL 2 közötti váltás időigényes lehet, és a két architektúra közötti különbségek miatt hibákhoz vezethet. Nagy projektekkel rendelkező disztribúciók esetén javasoljuk, hogy a konvertálás előtt biztonsági másolatot készítsön a fájlokról.

Alapértelmezett WSL-verzió beállítása

wsl --set-default-version <Version>

A WSL 1 vagy a WSL 2 alapértelmezett verziójának beállításához cserélje le <Version> az 1-es vagy a 2-es számra. Például wsl --set-default-version 2. A szám a WSL alapértelmezett verzióját jelöli az új Linux-disztribúciós telepítések esetében. A WSL 1 és a WSL 2összehasonlítása. A WSL 2 csak Windows 11 vagy Windows 10, 1903-es, 18362-es vagy újabb buildben érhető el.

Alapértelmezett Linux-disztribúció beállítása

wsl --set-default <Distribution Name>

A WSL-parancsok által használt alapértelmezett Linux-disztribúció beállításához cserélje le a <Distribution Name> az előnyben részesített Linux-disztribúció nevére.

WSL indítása a felhasználói kezdőkönyvtárban

wsl ~

A ~ a(z) wsl használatával indítható el a felhasználó otthoni könyvtárában. Ha egy WSL-parancssoron belül bármelyik könyvtárból haza szeretne ugrani, a következő parancsot használhatja: cd ~.

Adott Linux-disztribúció futtatása a PowerShellből vagy a CMD-ből

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

Ha egy adott Linux-disztribúciót egy adott felhasználóval szeretne futtatni, cserélje le a <Distribution Name> az előnyben részesített Linux-disztribúció nevére (azaz. Debian) és <User Name> egy meglévő felhasználó (azaz gyökér) nevével. Ha a felhasználó nem létezik a WSL-disztribúcióban, hibaüzenet jelenik meg. Az aktuális felhasználónév nyomtatásához használja a whoamiparancsot.

WSL frissítése

wsl --update

Frissítse a WSL-verziót a legújabb verzióra. A lehetőségek a következők:

• --web-download: Töltse le a legújabb frissítést a GitHubról a Microsoft Store helyett.

A WSL állapotának ellenőrzése

wsl --status

Tekintse meg a WSL-konfigurációval kapcsolatos általános információkat, például az alapértelmezett terjesztési típust, az alapértelmezett disztribúciót és a kernelverziót.

A WSL verziójának ellenőrzése

wsl --version

Ellenőrizze a WSL-ről és összetevőiről szóló verzióinformációkat.

Súgó parancs

wsl --help

A WSL-ben elérhető beállítások és parancsok listája.

Futtatás adott felhasználóként

wsl --user <Username>

A WSL megadott felhasználóként való futtatásához cserélje le a <Username> a WSL-disztribúcióban található felhasználó nevére.

A disztribúció alapértelmezett felhasználójának módosítása

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

Módosítsa a terjesztési bejelentkezés alapértelmezett felhasználóját. A felhasználónak már léteznie kell a disztribúcióban ahhoz, hogy az alapértelmezett felhasználó legyen.

Például: ubuntu config --default-user johndoe az Ubuntu-disztribúció alapértelmezett felhasználója a "johndoe" felhasználóra változna.

Jegyzet

Ha problémát tapasztal a disztribúció nevének megállapításával, használja a wsl -lparancsot.

Figyelmeztetés

Ez a parancs nem működik az importált disztribúciók esetében, mert ezek a disztribúciók nem rendelkeznek végrehajtható indítóprogramokkal. Ehelyett az importált disztribúciók alapértelmezett felhasználója módosítható a /etc/wsl.conf fájl használatával. Tekintse meg a Speciális beállítások dokumentum automatikus csatolási beállításait.

Leállítás

wsl --shutdown

Azonnal leállítja az összes futó disztribúciót és a WSL 2 egyszerűsített segédprogram virtuális gépet. Ez a parancs olyan példányokban lehet szükséges, amelyek megkövetelik a WSL 2 virtuálisgép-környezet újraindítását, például a memóriahasználati korlátok módosítását, vagy a .wslconfig fájlmódosítását.

Befejeződik

wsl --terminate <Distribution Name>

A megadott disztribúció leállításához vagy futtatásának leállításához cserélje le a <Distribution Name> a célterjesztés nevére.

IP-cím azonosítása

• wsl hostname -I: A WSL 2-n keresztül telepített Linux-disztribúció IP-címét adja vissza (a WSL 2 virtuálisgép-cím)
• ip route show | grep -i default | awk '{ print $3}': A Windows-gép IP-címét adja vissza a WSL 2 -ből (a WSL 2 virtuális gépből) látható módon.

Részletesebb magyarázatért lásd: Hálózati alkalmazások elérése WSL-vel: IP-cím azonosítása.

Disztribúció exportálása

wsl --export <Distribution Name> <FileName>

A megadott disztribúció pillanatképét exportálja új terjesztési fájlként. Alapértelmezés szerint tar formátum. A fájlnév lehet - a standard bemenethez. A lehetőségek a következők:

• --vhd: Azt adja meg, hogy az exportálási disztribúciónak tar-fájl helyett .vhdx fájlnak kell lennie (ez csak a WSL 2 használatával támogatott)

Disztribúció importálása

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

Importálja a megadott tar-fájlt új disztribúcióként. A fájlnév lehet - a standard bemenethez. A lehetőségek a következők:

• --vhd: Azt adja meg, hogy az importálási disztribúciónak tar-fájl helyett .vhdx fájlnak kell lennie (ez csak a WSL 2 használatával támogatott)
• --version <1/2>: Meghatározza, hogy a disztribúciót WSL 1 vagy WSL 2-disztribúcióként importálja-e

Disztribúció importálása helyben

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

Importálja a megadott .vhdx fájlt új disztribúcióként. A virtuális merevlemezt az ext4 fájlrendszer típusában kell formázni.

Linux-disztribúció regisztrációja vagy eltávolítása

WSL-disztribúció regisztrációja és eltávolítása:

wsl --unregister <DistributionName>

Ha a <DistributionName>-t a megcélzott Linux-disztribúció nevére cseréli, az a WSL-ből törli az adott disztribúció regisztrációját, hogy újratelepíthetővé vagy eltávolíthatóvá váljon. Figyelem: Regisztráció törlése után az adott terjesztéshez társított összes adat, beállítás és szoftver véglegesen elveszik. Az áruházból történő újratelepítés a disztribúció tiszta másolatát fogja telepíteni. Például wsl --unregister Ubuntu eltávolítaná az Ubuntu-t a WSL-ben elérhető disztribúciókból. A wsl --list futtatása azt fogja felfedni, hogy már nem szerepel a listán.

A Linux-disztribúciós alkalmazást ugyanúgy eltávolíthatja a Windows-gépen, mint bármely más áruházbeli alkalmazást. Az újratelepítéshez keresse meg a disztribúciót a Microsoft Store-ban, és válassza a "Launch" (Indítás) lehetőséget.

Lemez vagy eszköz csatlakoztatása

wsl --mount <DiskPath>

Fizikai lemez csatolása és csatlakoztatása az összes WSL2-disztribúcióban a <DiskPath> lecserélésével a lemez helyét tartalmazó könyvtár\fájl elérési útjára. Lásd a Linux-lemez csatlakoztatása a WSL 2-ben . A lehetőségek a következők:

• --vhd: Azt határozza meg, hogy <Disk> virtuális merevlemezre hivatkozik-e.
• --name: A lemez csatlakoztatása a csatlakoztatási pont egyéni nevével
• --bare: Csatlakoztassa a lemezt a WSL2-höz, de ne csatolja fel.
• --type <Filesystem>: Lemez csatlakoztatásakor használandó fájlrendszertípus, ha nincs megadva az ext4 alapértelmezett értéke. Ez a parancs a következőként is megadható: wsl --mount -t <Filesystem>. A fájlrendszer típusát a következő paranccsal észlelheti: blkid <BlockDevice>, például: blkid <dev/sdb1>.
• --partition <Partition Number>: A csatlakoztatni kívánt partíció indexszáma, ha nincs megadva alapértelmezett érték a teljes lemezen.
• --options <MountOptions>: Vannak fájlrendszerspecifikus beállítások, amelyek a lemez csatlakoztatásakor is használhatók. Például ext4 csatlakoztatási opciók, mint: wsl --mount -o "data-ordered" vagy wsl --mount -o "data=writeback. Jelenleg azonban csak a fájlrendszer-specifikus beállítások támogatottak. Az általános beállítások, például ro, rwvagy noatimenem támogatottak.

Jegyzet

Ha 32 bites folyamatot futtat a wsl.exe (64 bites eszköz) eléréséhez, előfordulhat, hogy a következő módon kell futtatnia a parancsot: C:\Windows\Sysnative\wsl.exe --command.

Lemezek leválasztása

wsl --unmount <DiskPath>

A megadott lemez elérési útján bontsa le a lemezt, ha nem adtak meg lemezútvonalat, akkor ez a parancs leválasztja és eltávolítja az ÖSSZES csatlakoztatott lemezt.

Elavult WSL-parancsok

wslconfig.exe [Argument] [Options]

bash [Options]

lxrun /[Argument]

Ezek a parancsok voltak az eredeti wsl szintaxis a WSL-vel telepített Linux-disztribúciók konfigurálásához, de az wsl vagy wsl.exe parancs szintaxisa váltotta fel őket.