Grundlegende Befehle für WSL
Die folgenden WSL-Befehle sind in einem Format aufgeführt, das von PowerShell oder der Windows-Eingabeaufforderung unterstützt wird. Um diese Befehle über die Befehlszeile einer Bash-/Linux-Verteilung auszuführen, müssen Sie wsl
durch wsl.exe
ersetzen. Führen Sie wsl --help
aus, um eine vollständige Liste der Befehle anzuzeigen.
Installieren
wsl --install
Installieren Sie WSL und die standardmäßige Ubuntu-Verteilung von Linux. Weitere Informationen Sie können diesen Befehl auch verwenden, um zusätzliche Linux-Verteilungen zu installieren, indem Sie wsl --install <Distribution Name>
ausführen. Um eine gültige Liste von Verteilungsnamen zu erhalten, führen Sie wsl --list --online
aus.
Zu den Optionen gehören:
--distribution
: Gibt die zu installierende Linux-Verteilung an. Verfügbare Verteilungen finden Sie, indem Siewsl --list --online
ausführen.--no-launch
: Installiert die Linux-Verteilung, aber startet sie nicht automatisch.--web-download
: Installiert die Verteilung aus einer Onlinequelle und nicht aus dem Microsoft Store.
Wenn WSL nicht installiert ist, stehen folgende Optionen bereit:
--inbox
: Installiert WSL mithilfe der Windows-Komponente, anstatt den Microsoft Store zu verwenden. (WSL-Updates werden über Windows-Updates empfangen, anstatt bei Verfügbarkeit per Push über den Store gesendet zu werden.)--enable-wsl1
: Aktiviert WSL 1 während der Installation der Microsoft Store-Version von WSL, indem auch die optionale Komponente „Windows-Subsystem für Linux“ aktiviert wird.--no-distribution
: Installiert keine Verteilung beim Installieren von WSL.
Hinweis
Wenn Sie WSL auf Windows 10 oder einer älteren Version ausführen, müssen Sie möglicherweise das Flag -d
in den Befehl --install
einschließen, um eine Verteilung anzugeben: wsl --install -d <distribution name>
.
Auflisten der verfügbaren Linux-Verteilungen
wsl --list --online
Zeigen Sie eine Liste der Linux-Verteilungen an, die im Onlineshop verfügbar sind. Dieser Befehl kann auch folgendermaßen eingegeben werden: wsl -l -o
.
Auflisten der installierten Linux-Verteilungen
wsl --list --verbose
Zeigen Sie eine Liste der auf Ihrem Windows-Computer installierten Linux-Verteilungen an, einschließlich Status (ob die Verteilung ausgeführt wird oder beendet wurde) und Version von WSL, mit dem die Verteilung ausgeführt wird (WSL 1 oder WSL 2). Vergleich zwischen WSL 1 und WSL 2. Dieser Befehl kann auch folgendermaßen eingegeben werden: wsl -l -v
. Weitere Optionen, die mit dem list-Befehl verwendet werden können, sind: --all
zum Auflisten aller Verteilungen, --running
zum Auflisten der aktuell ausgeführten Verteilungen oder --quiet
, um nur die Namen der Verteilungen anzuzeigen.
Festlegen der WSL-Version auf 1 oder 2
wsl --set-version <distribution name> <versionNumber>
Um die Version von WSL (1 oder 2) festzulegen, unter der eine Linux-Verteilung ausgeführt wird, ersetzen Sie <distribution name>
durch den Namen der Verteilung und <versionNumber>
durch 1 oder 2. Vergleich zwischen WSL 1 und WSL 2. WSL 2 ist nur in Windows 11 oder Windows 10, Version 1903, Build 18362 oder neuer verfügbar.
Festlegen der WSL-Standardversion
wsl --set-default-version <Version>
Um als Standardversion WSL 1 oder WSL 2 festzulegen, ersetzen Sie <Version>
durch die Zahl 1 oder 2. Dadurch geben Sie die WSL-Version an, die für die Installation neuer Linux-Verteilungen standardmäßig verwendet werden soll. Beispiel: wsl --set-default-version 2
. Vergleich zwischen WSL 1 und WSL 2. WSL 2 ist nur in Windows 11 oder Windows 10, Version 1903, Build 18362 oder neuer verfügbar.
Festlegen der Standard-Linux-Verteilung
wsl --set-default <Distribution Name>
Ersetzen Sie <Distribution Name>
durch den Namen Ihrer bevorzugten Linux-Verteilung, um festzulegen, welche Linux-Verteilung von WSL-Befehlen standardmäßig zum Ausführen verwendet wird.
Verzeichnis in „Home“ ändern
wsl ~
~
kann mit WSL verwendet werden, um im Startverzeichnis des Benutzers gestartet zu werden. Um von einem beliebigen Verzeichnis innerhalb einer WSL-Eingabeaufforderung zurück zur Startseite zu wechseln, können Sie den folgenden Befehl verwenden: cd ~
.
Ausführen einer bestimmten Linux-Verteilung über PowerShell oder CMD
wsl --distribution <Distribution Name> --user <User Name>
Um eine bestimmte Linux-Verteilung mit einem bestimmten Benutzer auszuführen, ersetzen Sie <Distribution Name>
durch den Namen Ihrer bevorzugten Linux-Verteilung (d. h. „Debian“) und <User Name>
durch den Namen eines vorhandenen Benutzers (d. h. „root“). Wenn der Benutzer in der WSL-Verteilung nicht vorhanden ist, wird ein Fehler angezeigt. Verwenden Sie zum Drucken des aktuellen Benutzernamens den Befehl whoami
.
Aktualisieren von WSL
wsl --update
Aktualisieren Sie Ihre WSL-Version auf die neueste Version. Zu den Optionen gehören:
--web-download
: Lädt das neueste Update von GitHub und nicht aus dem Microsoft Store herunter.
Überprüfen des WSL-Status
wsl --status
Weitere Informationen zu Ihrer WSL-Konfiguration, z. B. Standardverteilungstyp, Standardverteilung und Kernelversion.
Überprüfen der WSL-Version
wsl --version
Überprüfen Sie die Versionsinformationen zu WSL und den zugehörigen Komponenten.
Help-Befehl
wsl --help
Sehen Sie sich eine Liste der Optionen und Befehle an, die mit WSL verfügbar sind.
Ausführen als ein bestimmter Benutzer
wsl -u <Username>`, `wsl --user <Username>
Um WSL unter einem bestimmten Benutzer auszuführen, ersetzen Sie <Username>
durch den Namen eines in der WSL-Verteilung vorhandenen Benutzers.
Ändern des Standardbenutzers für eine Verteilung
<DistributionName> config --default-user <Username>
Ändern Sie den Standardbenutzer zur Anmeldung bei Ihrer Verteilung. Der Benutzer muss innerhalb der Verteilung bereits vorhanden sein, um der Standardbenutzer zu werden.
Beispiel: Durch ubuntu config --default-user johndoe
würde der Standardbenutzer für die Ubuntu-Verteilung in den Benutzer „johndoe“ geändert.
Hinweis
Wenn Sie Probleme haben, den Namen Ihrer Verteilung herauszufinden, verwenden Sie den Befehl wsl -l
.
Warnung
Dieser Befehl kann nicht für importierte Verteilungen verwendet werden, da diese Verteilungen nicht über ein ausführbares Startprogramm verfügen. Sie können stattdessen den Standardbenutzer für importierte Verteilungen mithilfe der Datei /etc/wsl.conf
ändern. Weitere Informationen finden Sie unter den Optionen zur automatischen Einbindung im Dokument Konfiguration der erweiterten Einstellungen.
Herunterfahren
wsl --shutdown
Beendet sofort alle ausgeführten Verteilungen und den virtuellen Computer des WSL 2-Lightweight-Hilfsprogramms. Dieser Befehl kann in Fällen erforderlich sein, in denen Sie die Umgebung des virtuellen WSL 2-Computers neu starten müssen, z. B. beim Ändern der Grenzwerte für die Arbeitsspeicherauslastung oder bei Änderungen an der WSLCONFIG-Datei.
Terminate
wsl --terminate <Distribution Name>
Um die angegebene Verteilung oder deren Ausführung zu beenden, ersetzen Sie <Distribution Name>
durch den Namen der Zielverteilung.
Ermitteln der IP-Adresse
wsl hostname -i
für die IP-Adresse Ihrer Linux-Distribution, die über WSL 2 installiert wurde (die WSL 2-VM-Adresse)cat /etc/resolv.conf
für die IP-Adresse des Windows-Computers aus Sicht von WSL 2 (die WSL 2-VM)
Importieren und Exportieren einer Verteilung
wsl --export <Distribution Name> <FileName>
wsl --import <Distribution Name> <InstallLocation> <FileName>
Importiert und exportiert die angegebene TAR-Datei als neue Distribution. Der Dateiname kann „-“ für Standardeingabe sein. Zu den Optionen gehören:
--vhd
: Gibt an, dass die Import-/Exportverteilung eine VHDX-Datei anstelle einer TAR-Datei sein soll.--version
: Gibt nur für den Import an, ob die Verteilung als WSL 1- oder WSL 2-Verteilung importiert werden soll.
Direktes Importieren einer Verteilung
wsl --import-in-place <Distribution Name> <FileName>
Importiert die angegebene VHDX-Datei als neue Verteilung. Die virtuelle Festplatte muss im Dateisystemtyp ext4 formatiert sein.
Aufheben der Registrierung oder Deinstallieren einer Linux-Verteilung
Obwohl Linux-Verteilungen über den Microsoft Store installiert werden können, können Sie nicht über den Store deinstalliert werden.
So entfernen Sie die Registrierung und deinstallieren eine WSL-Verteilung:
wsl --unregister <DistributionName>
Wenn Sie <DistributionName>
durch den Namen Ihrer Linux-Zielverteilung ersetzen, wird die Registrierung dieser Verteilung bei WSL aufgehoben, damit sie neu installiert oder bereinigt werden kann. Vorsicht: Nachdem die Registrierung aufgehoben wurde, gehen alle Daten, Einstellungen und Softwareanwendungen, die dieser Verteilung zugeordnet sind, dauerhaft verloren. Bei der erneuten Installation aus dem Store wird eine saubere Kopie der Distribution installiert. Beispiel: wsl --unregister Ubuntu
würde Ubuntu aus den in WSL verfügbaren Verteilungen entfernen. Wenn Sie wsl --list
ausführen, wird angezeigt, dass sie nicht mehr aufgeführt ist.
Sie können die App der Linux-Verteilung wie jede andere Store-Anwendung auch auf Ihrem Windows-Computer deinstallieren. Zum erneuten Installieren suchen Sie die Verteilung im Microsoft Store, und wählen Sie dann „Starten“ aus.
Bereitstellen eines Datenträgers oder Geräts
wsl --mount <DiskPath>
Sie können einen physischen Datenträger an alle WSL2-Verteilungen anfügen und bereitstellen, indem Sie <DiskPath>
durch den Verzeichnis-/Dateipfad ersetzen, unter dem sich der Datenträger befindet. Weitere Informationen finden Sie unter Bereitstellen eines Linux-Datenträgers in WSL 2. Zu den Optionen gehören:
--vhd
: Gibt an, dass<Disk>
sich auf eine virtuelle Festplatte bezieht.--name
: Stellt den Datenträger mit einem benutzerdefinierten Namen für den Bereitstellungspunkt bereit.--bare
: Fügt den Datenträger an WSL2 an, stellt ihn aber nicht bereit.--type <Filesystem>
: Der Dateisystemtyp, der beim Bereitstellen eines Datenträgers verwendet werden soll. Wird keine Angabe gemacht, wird standardmäßig ext4 verwendet. Dieser Befehl kann auch folgendermaßen eingegeben werden:wsl --mount -t <Filesystem>
. Sie können den Dateisystemtyp mithilfe des folgenden Befehls ermitteln:blkid <BlockDevice>
. Beispiel:blkid <dev/sdb1>
.--partition <Partition Number>
: Indexnummer der Partition, die bereitgestellt werden soll. Wird keine Angabe gemacht, wird standardmäßig der gesamte Datenträger verwendet.--options <MountOptions>
: Es gibt einige dateisystemspezifische Optionen, die beim Bereitstellen eines Datenträgers hinzugefügt werden können. Beispiel: ext4-Bereitstellungsoptionen wiewsl --mount -o "data-ordered"
oderwsl --mount -o "data=writeback
. Derzeit werden jedoch nur dateisystemspezifische Optionen unterstützt. Generische Optionen wiero
,rw
odernoatime
werden nicht unterstützt.
Hinweis
Wenn Sie einen 32-Bit-Prozess ausführen, um auf „wsl.exe“ (ein 64-Bit-Tool) zuzugreifen, müssen Sie den Befehl möglicherweise auf folgende Weise ausführen: C:\Windows\Sysnative\wsl.exe --command
.
Aufheben der Bereitstellung der Datenträger
wsl --unmount <DiskPath>
Hebt die Bereitstellung eines im Datenträgerpfad angegebenen Datenträgers auf. Wenn kein Datenträgerpfad angegeben ist, hebt dieser Befehl die Bereitstellung auf und trennt ALLE bereitgestellten Datenträger.
Veraltete WSL-Befehle
wslconfig.exe [Argument] [Options]
bash [Options]
lxrun /[Argument]
Diese Befehle waren die ursprüngliche wsl-Syntax zum Konfigurieren von mit WSL installierten Linux-Verteilungen, wurden jedoch durch die wsl
- oder wsl.exe
-Befehlssyntax ersetzt.