Základní příkazy pro WSL

Níže uvedené příkazy WSL jsou uvedené ve formátu podporovaném PowerShellem nebo příkazovým řádkem Windows. Chcete-li tyto příkazy spustit z příkazového řádku distribuce Bash / Linux, musíte nahradit wslwsl.exe. Úplný seznam příkazů zobrazíte spuštěním wsl --help. Pokud jste to ještě neudělali, doporučujeme aktualizovat na verzi WSL nainstalovanou z Microsoft Storu, aby bylo možné dostávat aktualizace WSL, jakmile budou k dispozici. (Další informace o instalaci WSL přes Microsoft Store.).

Nainstalovat

wsl --install

Nainstalujte WSL a výchozí distribuci Ubuntu Linuxu. Další informace. Tento příkaz můžete také použít k instalaci dalších linuxových distribucí spuštěním wsl --install <Distribution Name>. Pro platný seznam distribučních názvů spusťte wsl --list --online.

Mezi možnosti patří:

• --distribution: Zadejte distribuci Linuxu, která se má nainstalovat. Dostupné distribuce najdete spuštěním wsl --list --online.
• --no-launch: Nainstalujte distribuci Linuxu, ale nespustíte ji automaticky.
• --web-download: Nainstalujte ho z online zdroje místo použití Microsoft Storu.

Pokud wsL není nainstalován možnosti zahrnují:

• --inbox: Nainstaluje WSL pomocí součásti systému Windows namísto použití Microsoft Storu. (aktualizace WSL budou dostávány prostřednictvím aktualizací Windows, a nikoli nabízeny jako dostupné prostřednictvím obchodu).
• --enable-wsl1: Povolí WSL 1 během instalace verze WSL z Microsoft Storu tím, že povolí volitelnou komponentu Subsystém Windows pro Linux.
• --no-distribution: Při instalaci WSL neinstalujte distribuci.

Poznámka

Pokud používáte WSL ve Windows 10 nebo starší verzi, možná budete muset zahrnout příznak -d s příkazem --install k určení distribuce: wsl --install -d <distribution name>.

Seznam dostupných distribucí Linuxu

wsl --list --online

Podívejte se na seznam distribucí Linuxu dostupných prostřednictvím online obchodu. Tento příkaz lze zadat také jako: wsl -l -o.

Výpis nainstalovaných distribucí Linuxu

wsl --list --verbose

Podívejte se na seznam linuxových distribucí nainstalovaných na vašem počítači s Windows, včetně stavu (jestli je distribuce spuštěná nebo zastavená) a verze WSL se spuštěnou distribucí (WSL 1 nebo WSL 2). Porovnání WSL 1 a WSL 2. Tento příkaz lze zadat také jako: wsl -l -v. Mezi další možnosti, které lze použít s příkazem seznamu, patří: --all k výpisu všech distribucí, --running k výpisu pouze distribucí, které jsou aktuálně spuštěné, nebo --quiet k zobrazení pouze názvů distribucí.

Nastavení verze WSL na 1 nebo 2

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

Pokud chcete určit verzi WSL (1 nebo 2), na které běží linuxová distribuce, nahraďte <distribution name> názvem distribuce a nahraďte <versionNumber> 1 nebo 2. Porovnání WSL 1 a WSL 2. WSL 2 je k dispozici pouze ve Windows 11 nebo Windows 10 verze 1903, buildu 18362 nebo novějším.

Varování

Přepínání mezi WSL 1 a WSL 2 může být časově náročné a vést k selháním kvůli rozdílům mezi těmito dvěma architekturami. U distribucí s velkými projekty doporučujeme před pokusem o převod zálohovat soubory.

Nastavení výchozí verze WSL

wsl --set-default-version <Version>

Pokud chcete nastavit výchozí verzi WSL 1 nebo WSL 2, nahraďte <Version> číslem 1 nebo 2. Například wsl --set-default-version 2. Číslo představuje verzi WSL, která je výchozí pro nové instalace distribuce Linuxu. Porovnání WSL 1 a WSL 2. WSL 2 je k dispozici pouze ve Windows 11 nebo Windows 10 verze 1903, buildu 18362 nebo novějším.

Nastavení výchozí linuxové distribuce

wsl --set-default <Distribution Name>

Pokud chcete nastavit výchozí linuxovou distribuci, kterou příkazy WSL použijí ke spuštění, nahraďte <Distribution Name> názvem upřednostňované distribuce Linuxu.

Spuštění WSL na domovské stránce uživatele

wsl ~

~ lze použít s wsl ke spuštění v domovském adresáři uživatele. Pokud chcete přejít z libovolného adresáře zpět do domova z příkazového řádku WSL, můžete použít příkaz: cd ~.

Spuštění konkrétní linuxové distribuce z PowerShellu nebo CMD

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

Pokud chcete spustit konkrétní linuxovou distribuci s konkrétním uživatelem, nahraďte <Distribution Name> názvem preferované distribuce Linuxu (tj. Debian) a <User Name> s názvem existujícího uživatele (tj. root). Pokud uživatel v distribuci WSL neexistuje, zobrazí se chyba. Chcete-li vytisknout aktuální uživatelské jméno, použijte příkaz whoami.

Aktualizace WSL

wsl --update

Aktualizujte verzi WSL na nejnovější verzi. Mezi možnosti patří:

• --web-download: Stáhněte si nejnovější aktualizaci z GitHubu místo z Microsoft Storu.

Kontrola stavu WSL

wsl --status

Podívejte se na obecné informace o konfiguraci WSL, jako je výchozí typ distribuce, výchozí distribuce a verze jádra.

Zkontrolujte verzi WSL

wsl --version

Zkontrolujte informace o verzi WSL a jejích komponentách.

příkaz nápověda

wsl --help

Podívejte se na seznam možností a příkazů dostupných ve WSL.

Spustit jako konkrétní uživatel

wsl --user <Username>

Chcete-li spustit WSL jako zadaný uživatel, nahraďte <Username> názvem uživatele, který existuje v distribuci WSL.

Změna výchozího uživatele pro distribuci

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

Změňte výchozího uživatele pro přihlášení k distribuci. Uživatel už musí existovat uvnitř distribuce, aby se stal výchozím uživatelem.

Například: ubuntu config --default-user johndoe by změnil výchozího uživatele distribuce Ubuntu na uživatele "johndoe".

Poznámka

Pokud máte potíže zjistit název distribuce, použijte příkaz wsl -l.

Varování

Tento příkaz nebude fungovat pro importované distribuce, protože tyto distribuce nemají spustitelný spouštěč. Místo toho můžete změnit výchozího uživatele pro importované distribuce pomocí souboru /etc/wsl.conf. Podívejte se na možnosti automatického připojení v dokumentu Konfigurace rozšířeného nastavení.

Vypnutí

wsl --shutdown

Okamžitě ukončí všechny spuštěné distribuce a virtuální počítač wsL 2 lightweight utility. Tento příkaz může být nutný v instancích, které vyžadují restartování prostředí virtuálního počítače WSL 2, například změnu limitů využití paměti nebo provedení změny souboru .wslconfig.

Ukončit

wsl --terminate <Distribution Name>

Pokud chcete ukončit zadanou distribuci nebo ji zastavit, nahraďte <Distribution Name> názvem cílové distribuce.

Zjistit IP adresu

• wsl hostname -I: Vrátí IP adresu vaší linuxové distribuce nainstalované prostřednictvím WSL 2 (adresa virtuálního počítače WSL 2).
• ip route show | grep -i default | awk '{ print $3}': Vrátí IP adresu počítače s Windows, jak je vidět z WSL 2 (virtuální počítač WSL 2).

Podrobnější vysvětlení najdete v tématu Přístup k síťovým aplikacím pomocí WSL: Identifikace IP adresy.

Export distribuci

wsl --export <Distribution Name> <FileName>

Exportuje snímek zadané distribuce jako nový distribuční soubor. Výchozím formátem je tar. Název souboru může být - pro standardní vstup. Mezi možnosti patří:

• --vhd: Určuje, že distribuce exportu by měla být souborem .vhdx místo souboru tar (to se podporuje jenom pomocí WSL 2).

Importovat distribuci

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

Importuje zadaný soubor tar jako novou distribuci. Název souboru může být - pro standardní vstup. Mezi možnosti patří:

• --vhd: Určuje, že distribuce importu by měla být souborem .vhdx místo souboru tar (to se podporuje jenom pomocí WSL 2).
• --version <1/2>: Určuje, jestli se má importovat distribuce jako distribuce WSL 1 nebo WSL 2.

Import distribuce na místě

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

Importuje zadaný soubor .vhdx jako novou distribuci. Virtuální pevný disk musí být formátován v typu systému souborů ext4.

Zrušení registrace nebo odinstalace distribuce Linuxu

I když je možné distribuce Linuxu nainstalovat prostřednictvím Microsoft Storu, není možné je odinstalovat prostřednictvím úložiště.

Zrušení registrace a odinstalace distribuce WSL:

wsl --unregister <DistributionName>

Nahrazení <DistributionName> názvem cílové linuxové distribuce zruší registraci této distribuce z WSL, aby bylo možné ji přeinstalovat nebo vyčistit. Upozornění: Po zrušení registrace budou všechna data, nastavení a software přidružené k této distribuci trvale ztracena. Opětovná instalace z úložiště nainstaluje čistou kopii distribuce. Například wsl --unregister Ubuntu odebere Ubuntu z distribucí dostupných ve WSL. Spuštění wsl --list ukáže, že už není v seznamu.

Distribuční aplikaci pro Linux můžete také odinstalovat na počítači s Windows stejně jako jakoukoli jinou aplikaci pro Store. Pokud ho chcete přeinstalovat, vyhledejte distribuci v Microsoft Storu a vyberte Spustit.

Připojení disku nebo zařízení

wsl --mount <DiskPath>

Připojte a přimontujte fyzický disk ve všech distribucích WSL2 nahrazením <DiskPath> adresářem nebo cestou k souboru, kde se disk nachází. Viz Připojení disku s Linuxem ve WSL 2. Mezi možnosti patří:

• --vhd: Určuje, že <Disk> odkazuje na virtuální pevný disk.
• --name: Připojte disk pomocí vlastního názvu přípojného bodu
• --bare: Připojte disk k WSL2, ale nepřipojujte ho.
• --type <Filesystem>: Typ systému souborů, který se má použít při připojování disku, pokud není zadán, výchozí bude ext4. Tento příkaz lze zadat také jako: wsl --mount -t <Filesystem>. Typ systému souborů můžete zjistit pomocí příkazu: blkid <BlockDevice>, například: blkid <dev/sdb1>.
• --partition <Partition Number>: Číslo indexu oddílu, který se má připojit, pokud není zadáno, výchozí hodnota je připojit celý disk.
• --options <MountOptions>: Při připojování disku je možné zahrnout některé možnosti specifické pro systém souborů. Například možnosti připojení ext4 například: wsl --mount -o "data-ordered" nebo wsl --mount -o "data=writeback. V tuto chvíli se ale podporují pouze možnosti specifické pro systém souborů. Obecné možnosti, jako jsou ro, rwnebo noatime, nejsou podporovány.

Poznámka

Pokud používáte 32bitový proces pro přístup k wsl.exe (64bitový nástroj), možná budete muset příkaz spustit následujícím způsobem: C:\Windows\Sysnative\wsl.exe --command.

Odpojte disky

wsl --unmount <DiskPath>

Odpojte disk zadaný cestou k disku; pokud není cesta k disku zadána, tento příkaz odpojí a odpojí všechny připojené disky.

Zastaralé příkazy WSL

wslconfig.exe [Argument] [Options]

bash [Options]

lxrun /[Argument]

Tyto příkazy byly původní syntaxí wsl pro konfiguraci linuxových distribucí nainstalovaných ve WSL, ale byly nahrazeny syntaxí příkazů wsl nebo wsl.exe.