Auf Englisch lesen

Freigeben über


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. Falls Sie dies noch nicht getan haben, empfehlen wir Ihnen, auf die im Microsoft Store verfügbare Version von WSL zu aktualisieren, um WSL-Updates zu erhalten, sobald diese verfügbar sind. (Erfahren Sie mehr über die Installation von WSL über den Microsoft Store.).

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 Sie wsl --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 unter Windows 10 oder einer älteren Version ausführen, müssen Sie möglicherweise das Flag -d in den Befehl --install einschließen, um eine Distribution 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.

Warnung

Der Wechsel zwischen WSL 1 und WSL 2 kann zeitaufwändig sein und aufgrund der Unterschiede zwischen den beiden Architekturen zu Fehlern führen. Für Distributionen mit großen Projekten empfehlen wir, vor der Konvertierung eine Sicherungskopie der Dateien zu erstellen.

Festlegen der WSL-Standardversion

wsl --set-default-version <Version>

Um eine Standardversion von WSL 1 oder WSL 2 festzulegen, ersetzen Sie <Version> entweder durch die Zahl 1 oder 2. Beispielsweise wsl --set-default-version 2. Die Zahl stellt die Version von WSL als Standard für neue Linux-Distributionsinstallationen dar. 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 --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: gibt die IP-Adresse Ihrer Linux-Distribution zurück, die über WSL 2 installiert wurde (die WSL 2-VM-Adresse)
  • ip route show | grep -i default | awk '{ print $3}': Gibt die IP-Adresse des Windows-Computers zurück, wie von WSL 2 (der WSL 2-VM) dargestellt

Eine ausführlichere Erläuterung finden Sie unter Zugreifen auf Netzwerkanwendungen mit WSL: Identifizieren der IP-Adresse.

Exportieren einer Distribution

wsl --export <Distribution Name> <FileName>

Exportieren Sie eine Momentaufnahme der angegebenen Distribution als neue Distributionsdatei. Standardmäßig wird das TAR-Format verwendet. Der Dateiname kann - für die Standardeingabe sein. Beispiele für Optionen:

  • --vhd: Hiermit wird festgelegt, dass die Exportdistribution eine VHDX-Datei anstelle einer TAR-Datei sein soll (wird nur bei Verwendung von WSL 2 unterstützt).

Importieren einer Distribution

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

Importiert die angegebene TAR-Datei als neue Distribution. Der Dateiname kann - für die Standardeingabe sein. Beispiele für Optionen:

  • --vhd: Hiermit wird angegeben, dass die Importdistribution eine VHDX-Datei anstelle einer TAR-Datei sein soll (wird nur bei Verwendung von WSL 2 unterstützt).
  • --version <1/2>: Hiermit wird angegeben, ob die Distribution als WSL 1- oder WSL 2-Distribution 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 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.

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.