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.

Installieren

wsl --install

Installieren Sie WSL und die Ubuntu-Verteilung von Linux. Weitere Informationen

Installieren einer bestimmten Linux-Verteilung

wsl --install --distribution <Distribution Name>

Legen Sie neben der Standardverteilung (Ubuntu) eine Linux-Verteilung für die Installation fest, indem Sie <Distribution Name> durch den Namen der Verteilung ersetzen. Dieser Befehl kann auch folgendermaßen eingegeben werden: wsl -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.

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.

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 die Version Ihres WSL Linux-Kernels manuell. Sie können auch den Befehl wsl --update rollback verwenden, um ein Rollback auf eine frühere Version des WSL Linux-Kernels auszuführen.

Überprüfen des WSL-Status

wsl --status

Weitere Informationen zu Ihrer WSL-Konfiguration, z. B. Standardverteilungstyp, Standardverteilung und Kernelversion.

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.

Exportieren einer Verteilung in eine TAR-Datei

wsl --export <Distribution Name> <FileName>

Exportiert die Distribution in eine TAR-Datei. Der Dateiname kann „-“ für Standardausgabe sein.

Importieren einer neuen Verteilung

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

Importiert die angegebene TAR-Datei als neue Distribution. Der Dateiname kann „-“ für Standardeingabe sein. Die Option --version kann auch mit diesem Befehl verwendet werden, um festzulegen, ob die importierte Verteilung unter WSL 1 oder WSL 2 ausgeführt wird.

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:

  • wsl --mount --bare: Fügt den Datenträger an WSL2 an, stellt ihn aber nicht bereit.
  • wsl --mount --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>.
  • wsl --mount --partition <Partition Number>: Indexnummer der Partition, die bereitgestellt werden soll. Wird keine Angabe gemacht, wird standardmäßig der gesamte Datenträger verwendet.
  • wsl --mount --options <MountOptions>: Es gibt einige dateisystemspezifische Optionen, die beim Bereitstellen eines Datenträgers hinzugefügt werden können. Beispiel: ext4-Bereitstellungsoptionen wie wsl --mount -o "data-ordered" oder wsl --mount -o "data=writeback. Derzeit werden jedoch nur dateisystemspezifische Optionen unterstützt. Generische Optionen wie ro, rw oder noatime werden nicht unterstützt.
  • wsl --unmount <DiskPath>: Hebt die Bereitstellung auf und trennt den Datenträger von allen WSL 2-Verteilungen. Wird <DiskPath> nicht hinzugefügt, hebt dieser Befehl die Bereitstellung ALLER bereitgestellten Datenträger auf und trennt sie.

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.

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.