Befehlsreferenz für WSL

  • Artikel
  • 4 Minuten Lesedauer

Die folgenden grundlegenden 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.

Grundlegende Befehle

Die folgenden grundlegenden Befehle werden nach der Installation von WSL unterstützt.

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 --quite, 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.

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.

Startverzeichnis

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 ~.

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

wsl --unregister <Distribution Name>

Sie können die Registrierung einer bestimmten Verteilung aufheben oder sie deinstallieren, indem Sie <Distribution Name> durch den Namen der Zielverteilung ersetzen. Dadurch wird die Verteilung aus WSL entfernt, und alle zugeordneten Daten werden gelöscht. Sie können die App der Linux-Verteilung wie jede andere Store-Anwendung auch auf Ihrem Windows-Computer deinstallieren.

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 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.