Podstawowe polecenia w WSL

Poniższe polecenia WSL są wymienione w formacie obsługiwanym przez program PowerShell lub wiersz polecenia systemu Windows. Aby uruchomić te polecenia z poziomu wiersza polecenia dystrybucji Bash/Linux, należy zastąpić wslwsl.exe. Aby uzyskać pełną listę poleceń, uruchom polecenie wsl --help. Jeśli jeszcze tego nie zrobiłeś, zalecamy aktualizację do wersji programu WSL zainstalowanej ze sklepu Microsoft Store, aby otrzymywać aktualizacje programu WSL natychmiast po ich udostępnieniu. (Dowiedz się więcej o instalowaniu biblioteki WSL za pośrednictwem sklepu Microsoft Store.).

Instalować

wsl --install

Zainstaluj program WSL i domyślną dystrybucję systemu Ubuntu systemu Linux. Dowiedz się więcej. Możesz również użyć tego polecenia, aby zainstalować dodatkowe dystrybucje systemu Linux, uruchamiając wsl --install <Distribution Name>. Aby uzyskać prawidłową listę nazw dystrybucji, uruchom polecenie wsl --list --online.

Dostępne są następujące opcje:

• --distribution: określ dystrybucję systemu Linux do zainstalowania. Dostępne dystrybucje można znaleźć, uruchamiając wsl --list --online.
• --no-launch: zainstaluj dystrybucję systemu Linux, ale nie uruchamiaj jej automatycznie.
• --web-download: zainstaluj ze źródła online zamiast korzystać ze sklepu Microsoft Store.

Jeśli program WSL nie jest zainstalowany, dostępne są następujące opcje:

• --inbox: instaluje program WSL przy użyciu składnika systemu Windows zamiast korzystania ze sklepu Microsoft Store. (aktualizacje WSL będą odbierane za pośrednictwem aktualizacji systemu Windows, a nie udostępniane w miarę dostępności za pośrednictwem Microsoft Store).
• --enable-wsl1: włącza program WSL 1 podczas instalowania wersji programu WSL ze sklepu Microsoft Store, włączając również opcjonalny składnik "Podsystem Windows dla systemu Linux".
• --no-distribution: nie instaluj dystrybucji podczas instalowania programu WSL.

Notatka

Jeśli uruchomisz program WSL w systemie Windows 10 lub starszej wersji, może być konieczne dołączenie flagi -d za pomocą polecenia --install w celu określenia dystrybucji: wsl --install -d <distribution name>.

Lista dostępnych dystrybucji systemu Linux

wsl --list --online

Zobacz listę dystrybucji systemu Linux dostępnych za pośrednictwem sklepu online. To polecenie można również wprowadzić jako: wsl -l -o.

Lista zainstalowanych dystrybucji systemu Linux

wsl --list --verbose

Zobacz listę dystrybucji systemu Linux zainstalowanych na komputerze z systemem Windows, w tym stan (czy dystrybucja jest uruchomiona, czy zatrzymana) oraz wersja systemu WSL z uruchomioną dystrybucją (WSL 1 lub WSL 2). PorównanieWSL 1 i WSL 2. To polecenie można również wprowadzić jako: wsl -l -v. Dodatkowe opcje, których można użyć z poleceniem listy, obejmują: --all do wyświetlania listy wszystkich dystrybucji, --running do wyświetlania tylko dystrybucji, które są aktualnie uruchomione lub --quiet tylko w celu wyświetlania nazw dystrybucji.

Ustaw wersję WSL na 1 lub 2

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

Aby wyznaczyć wersję programu WSL (1 lub 2), na którym działa dystrybucja systemu Linux, zastąp <distribution name> nazwą dystrybucji i zastąp <versionNumber> 1 lub 2. PorównanieWSL 1 i WSL 2. Program WSL 2 jest dostępny tylko w systemie Windows 11 lub Windows 10 w wersji 1903, kompilacji 18362 lub nowszej.

Ostrzeżenie

Przełączanie między WSL 1 i WSL 2 może być czasochłonne i powodować błędy z powodu różnic między dwiema architekturami. W przypadku dystrybucji z dużymi projektami zalecamy utworzenie kopii zapasowej plików przed podjęciem próby konwersji.

Ustaw domyślną wersję WSL

wsl --set-default-version <Version>

Aby ustawić domyślną wersję WSL 1 lub WSL 2, zastąp <Version> numerem 1 lub 2. Na przykład wsl --set-default-version 2. Liczba reprezentuje wersję programu WSL, którą domyślnie stosuje się dla nowych instalacji dystrybucji Linux. PorównanieWSL 1 i WSL 2. Program WSL 2 jest dostępny tylko w systemie Windows 11 lub Windows 10 w wersji 1903, kompilacji 18362 lub nowszej.

Ustawianie domyślnej dystrybucji systemu Linux

wsl --set-default <Distribution Name>

Aby ustawić domyślną dystrybucję systemu Linux używaną przez polecenia WSL do uruchomienia, zastąp <Distribution Name> nazwą preferowanej dystrybucji systemu Linux.

Uruchamianie protokołu WSL w domu użytkownika

wsl ~

~ można użyć z wsl, aby uruchomić w katalogu głównym użytkownika. Aby przejść z dowolnego katalogu z powrotem do domu z poziomu wiersza polecenia WSL, możesz użyć polecenia: cd ~.

Uruchamianie określonej dystrybucji systemu Linux z poziomu programu PowerShell lub cmD

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

Aby uruchomić określoną dystrybucję systemu Linux z określonym użytkownikiem, zastąp <Distribution Name> nazwą preferowanej dystrybucji systemu Linux (tj. Debian) i <User Name> z nazwą istniejącego użytkownika (tj. root). Jeśli użytkownik nie istnieje w dystrybucji WSL, zostanie wyświetlony błąd. Aby wyświetlić bieżącą nazwę użytkownika, użyj polecenia whoami.

Zaktualizuj WSL

wsl --update

Zaktualizuj wersję programu WSL do najnowszej wersji. Dostępne są następujące opcje:

• --web-download: pobierz najnowszą aktualizację z usługi GitHub, a nie ze sklepu Microsoft Store.

Sprawdzanie stanu programu WSL

wsl --status

Zobacz ogólne informacje o konfiguracji programu WSL, takie jak domyślny typ dystrybucji, dystrybucja domyślna i wersja jądra.

Sprawdzanie wersji programu WSL

wsl --version

Sprawdź informacje o wersji WSL i jego składnikach.

Polecenie pomocy

wsl --help

Zobacz listę opcji i poleceń dostępnych w programie WSL.

Uruchamianie jako określony użytkownik

wsl --user <Username>

Aby uruchomić program WSL jako określony użytkownik, zastąp <Username> nazwą użytkownika, który istnieje w dystrybucji WSL.

Zmienianie domyślnego użytkownika dla dystrybucji

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

Zmień domyślnego użytkownika na potrzeby logowania do dystrybucji. Użytkownik musi już istnieć wewnątrz dystrybucji, aby stać się użytkownikiem domyślnym.

Na przykład: ubuntu config --default-user johndoe spowoduje zmianę domyślnego użytkownika dystrybucji systemu Ubuntu na użytkownika "johndoe".

Notatka

Jeśli masz problemy z ustaleniem nazwy dystrybucji, użyj polecenia wsl -l.

Ostrzeżenie

To polecenie nie będzie działać w przypadku importowanych dystrybucji, ponieważ te dystrybucje nie mają uruchamiania plików wykonywalnych. Zamiast tego można zmienić domyślnego użytkownika dla importowanych dystrybucji przy użyciu pliku /etc/wsl.conf. Zobacz opcje autoinstalacji w Konfiguracja ustawień zaawansowanych dokument.

Wyłączenie

wsl --shutdown

Natychmiast przerywa wszystkie działające dystrybucje oraz lekką wirtualną maszynę narzędziową WSL 2. To polecenie może być konieczne w wystąpieniach, które wymagają ponownego uruchomienia środowiska maszyny wirtualnej WSL 2, na przykład zmiany limitów użycia pamięci lub wprowadzenia zmiany w pliku .wslconfig.

Zakończyć

wsl --terminate <Distribution Name>

Aby zakończyć określoną dystrybucję lub zatrzymać jej działanie, zastąp <Distribution Name> nazwą docelowej dystrybucji.

Identyfikowanie adresu IP

• wsl hostname -I: zwraca adres IP dystrybucji systemu Linux zainstalowanej za pośrednictwem programu WSL 2 (adres maszyny wirtualnej WSL 2)
• ip route show | grep -i default | awk '{ print $3}': zwraca adres IP maszyny z systemem Windows, jak widać na maszynie wirtualnej WSL 2 (maszyna wirtualna WSL 2)

Aby uzyskać bardziej szczegółowe wyjaśnienie, zobacz Uzyskiwanie dostępu do aplikacji sieciowych przy użyciu protokołu WSL: Identyfikowanie adresu IP.

Eksportuj dystrybucję

wsl --export <Distribution Name> <FileName>

Eksportuje migawkę określonej dystrybucji jako nowy plik dystrybucji. Domyślnie format tar. Nazwa pliku może być - dla standardowych danych wejściowych. Dostępne są następujące opcje:

• --vhd: określa, że dystrybucja eksportu powinna być plikiem vhdx zamiast pliku tar (jest to obsługiwane tylko przy użyciu protokołu WSL 2)

Importować dystrybucję

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

Importuje określony plik tar jako nową dystrybucję. Nazwa pliku może być - dla standardowych danych wejściowych. Dostępne są następujące opcje:

• --vhd: określa, że dystrybucja importu powinna być plikiem vhdx zamiast pliku tar (jest to obsługiwane tylko przy użyciu protokołu WSL 2)
• --version <1/2>: określa, czy importować dystrybucję jako dystrybucję WSL 1, czy WSL 2

Import dystrybucji w określonym miejscu

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

Importuje określony plik vhdx jako nową dystrybucję. Wirtualny dysk twardy musi być sformatowany w typie systemu plików ext4.

Wyrejestrowywanie lub odinstalowywanie dystrybucji systemu Linux

Dystrybucje systemu Linux można zainstalować za pośrednictwem sklepu Microsoft Store, ale nie można ich odinstalować za pośrednictwem sklepu.

Aby wyrejestrować i odinstalować dystrybucję WSL:

wsl --unregister <DistributionName>

Zastąpienie <DistributionName> nazwą docelowej dystrybucji systemu Linux spowoduje wyrejestrowanie tej dystrybucji z programu WSL, aby można je było ponownie zainstalować lub wyczyścić. Przestroga: Po wyrejestrowywaniu wszystkie dane, ustawienia i oprogramowanie skojarzone z tą dystrybucją zostaną trwale utracone. Ponowne zainstalowanie ze sklepu spowoduje zainstalowanie czystej kopii dystrybucji. Na przykład wsl --unregister Ubuntu usunąłby Ubuntu z dystrybucji dostępnych w programie WSL. Uruchomienie wsl --list ujawni, że nie jest już wyświetlane.

Możesz również odinstalować aplikację dystrybucji systemu Linux na komputerze z systemem Windows tak samo jak każda inna aplikacja ze sklepu. Aby ponownie zainstalować, znajdź dystrybucję w sklepie Microsoft Store i wybierz pozycję "Uruchom".

Instalowanie dysku lub urządzenia

wsl --mount <DiskPath>

Dołącz i zainstaluj dysk fizyczny we wszystkich dystrybucjach WSL2, zastępując <DiskPath> ścieżką katalogu\pliku, w której znajduje się dysk. Zobacz Instalowanie dysku z systemem Linux w programie WSL 2. Dostępne są następujące opcje:

• --vhd: określa, że <Disk> odnosi się do wirtualnego dysku twardego.
• --name: Zainstaluj dysk przy użyciu niestandardowej nazwy punktu instalacji
• --bare: dołącz dysk do programu WSL2, ale nie zainstaluj go.
• --type <Filesystem>: typ systemu plików do użycia podczas instalowania dysku, jeśli nie określono wartości domyślnych na ext4. To polecenie można również wprowadzić jako: wsl --mount -t <Filesystem>. Typ systemu plików można wykryć przy użyciu polecenia : blkid <BlockDevice>, na przykład: blkid <dev/sdb1>.
• --partition <Partition Number>: numer indeksu partycji do zainstalowania, jeśli nie określono wartości domyślnych dla całego dysku.
• --options <MountOptions>: istnieją pewne opcje specyficzne dla systemu plików, które można uwzględnić podczas instalowania dysku. Na przykład opcje montowania ext4 takie jak: wsl --mount -o "data-ordered" lub wsl --mount -o "data=writeback. Jednak obecnie obsługiwane są tylko opcje specyficzne dla systemu plików. Opcje ogólne, takie jak ro, rwlub noatime, nie są obsługiwane.

Notatka

Jeśli uruchamiasz proces 32-bitowy w celu uzyskania dostępu do wsl.exe (64-bitowego narzędzia), może być konieczne uruchomienie polecenia w następujący sposób: C:\Windows\Sysnative\wsl.exe --command.

Odinstalowywanie dysków

wsl --unmount <DiskPath>

Odinstalowywanie dysku podanego na ścieżce dysku, jeśli nie podano ścieżki dysku, to to polecenie spowoduje odinstalowanie i odłączenie wszystkich zainstalowanych dysków.

Przestarzałe polecenia WSL

wslconfig.exe [Argument] [Options]

bash [Options]

lxrun /[Argument]

Te polecenia były oryginalną składnią wsl do konfigurowania dystrybucji systemu Linux zainstalowanych w programie WSL, ale zostały zastąpione składnią poleceń wsl lub wsl.exe.