Freigeben über


Grundlegende Befehle für WSL

Die folgenden WSL-Befehle sind in einem Format aufgeführt, das von PowerShell oder Windows-Eingabeaufforderung unterstützt wird. Um diese Befehle über eine Bash/Linux-Verteilungs-Befehlszeile auszuführen, müssen Sie wsl durch wsl.exeersetzen. Führen Sie wsl --helpaus, 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. Erfahren Sie mehr. Sie können diesen Befehl auch verwenden, um zusätzliche Linux-Distributionen zu installieren, indem Sie wsl --install <Distribution Name>ausführen. Um eine gültige Liste mit Distributionsnamen zu erhalten, führen Sie wsl --list --online aus.

Zu den Optionen gehören:

  • --distribution: Geben Sie die zu installierende Linux-Verteilung an. Sie können verfügbare Verteilungen finden, indem Sie wsl --list --onlineausführen.
  • --no-launch: Installieren Sie die Linux-Verteilung, starten Sie sie jedoch nicht automatisch.
  • --web-download: Installieren Sie aus einer Onlinequelle, anstatt den Microsoft Store zu verwenden.

Wenn WSL nicht installiert ist, umfassen die Optionen:

  • --inbox: Installiert WSL mithilfe der Windows-Komponente, anstatt den Microsoft Store zu verwenden. (WSL-Updates werden über Windows-Updates empfangen, anstatt wie üblich sofort im Store verfügbar zu sein).
  • --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: Installieren Sie bei der Installation von WSL keine Distribution.

Anmerkung

Wenn Sie WSL unter Windows 10 oder einer älteren Version ausführen, müssen Sie möglicherweise das -d Flag mit dem Befehl --install angeben, um eine Verteilung anzugeben: wsl --install -d <distribution name>.

Auflisten verfügbarer Linux-Distributionen

wsl --list --online

Eine Liste der Linux-Distributionen finden Sie im Online-Store. Dieser Befehl kann auch als: wsl -l -oeingegeben werden.

Auflisten installierter Linux-Distributionen

wsl --list --verbose

Eine Liste der Linux-Distributionen, die auf Ihrem Windows-Computer installiert sind, einschließlich des aktuellen Zustands der Distributionen (ob die Distribution ausgeführt wird oder gestoppt ist) und der Version von WSL, die die Distribution ausführt (WSL 1 oder WSL 2). Vergleich von WSL 1 und WSL 2. Dieser Befehl kann auch als: wsl -l -veingegeben werden. Weitere Optionen, die mit dem Listenbefehl verwendet werden können, sind: --all, um alle Verteilungen auflisten zu können, --running nur Verteilungen auflisten, die derzeit ausgeführt werden, oder --quiet, um nur Verteilernamen anzuzeigen.

WSL-Version auf 1 oder 2 festlegen

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

Um die Version von WSL (1 oder 2) festzulegen, auf der eine Linux-Distribution ausgeführt wird, ersetzen Sie <distribution name> durch den Namen der Verteilung und ersetzen Sie <versionNumber> durch 1 oder 2. Vergleich von WSL 1 und WSL 2. WSL 2 ist nur in Windows 11 oder Windows 10, Version 1903, Build 18362 oder höher verfügbar.

Warnung

Der Wechsel zwischen WSL 1 und WSL 2 kann zeitaufwändig sein und führt zu Fehlern aufgrund der Unterschiede zwischen den beiden Architekturen. Für Verteilungen mit großen Projekten empfehlen wir, Dateien zu sichern, bevor Sie eine Konvertierung versuchen.

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. Beispiel: wsl --set-default-version 2. Die Zahl stellt die Version von WSL als Standard für neue Linux-Verteilungsinstallationen dar. Vergleich von WSL 1 und WSL 2. WSL 2 ist nur in Windows 11 oder Windows 10, Version 1903, Build 18362 oder höher verfügbar.

Festlegen der Standardmäßigen Linux-Verteilung

wsl --set-default <Distribution Name>

Um die Standard-Linux-Verteilung festzulegen, die WSL-Befehle zum Ausführen verwenden, ersetzen Sie <Distribution Name> durch den Namen Ihrer bevorzugten Linux-Verteilung.

Verzeichnis in „Home“ ändern

wsl ~

~ kann mit WSL verwendet werden, um im Startverzeichnis des Benutzers gestartet zu werden. Um von einem beliebigen Verzeichnis zurück zum Heimatverzeichnis in einer WSL-Eingabeaufforderung zu gelangen, können Sie den Befehl cd ~verwenden.

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 (dh. Debian) und <User Name> mit dem Namen eines vorhandenen Benutzers (dh Stamm). Wenn der Benutzer in der WSL-Verteilung nicht vorhanden ist, wird eine Fehlermeldung angezeigt. Um den aktuellen Benutzernamen zu drucken, verwenden Sie den Befehl whoami.

WSL aktualisieren

wsl --update

Aktualisieren Sie Ihre WSL-Version auf die neueste Version. Zu den Optionen gehören:

  • --web-download: Laden Sie das neueste Update von GitHub anstelle des Microsoft Store herunter.

WSL-Status überprüfen

wsl --status

Siehe allgemeine Informationen zu Ihrer WSL-Konfiguration, z. B. Standarddistributionstyp, Standarddistribution und Kernelversion.

Überprüfen Sie die WSL-Version

wsl --version

Überprüfen Sie die Versionsinformationen zu WSL und deren Komponenten.

Hilfebefehl

wsl --help

Eine Liste der Optionen und Befehle finden Sie in WSL.

Als bestimmter Benutzer ausführen

wsl --user <Username>

Um WSL als angegebenen Benutzer auszuführen, ersetzen Sie <Username> durch den Namen eines Benutzers, der in der WSL-Verteilung vorhanden ist.

Ändern des Standardbenutzers für eine Verteilung

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

Ändern Sie den Standardbenutzer für den Distribution-Login. Der Benutzer muss bereits innerhalb der Verteilung vorhanden sein, um zum Standardbenutzer zu werden.

Beispiel: ubuntu config --default-user johndoe würde den Standardbenutzer für die Ubuntu-Verteilung in den "johndoe"-Benutzer ändern.

Anmerkung

Wenn Sie Probleme beim Ermitteln des Namens Ihrer Verteilung haben, verwenden Sie den Befehl wsl -l.

Warnung

Dieser Befehl funktioniert nicht für importierte Verteilungen, da diese Verteilungen nicht über ein ausführbares Startprogramm verfügen. Sie können stattdessen den Standardbenutzer für importierte Verteilungen mithilfe der /etc/wsl.conf-Datei ä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 Distributionen und den virtuellen Computer des WSL 2-Lightweight-Hilfsprogramms. Dieser Befehl kann in Fällen erforderlich sein, in denen Sie die WSL 2-Computerumgebung neu starten müssen, z. B. Ändern der Speicherauslastungsbeschränkungen oder eine Änderung an der Wslconfig-Datei.

Beenden

wsl --terminate <Distribution Name>

Um die angegebene Verteilung zu beenden oder die Ausführung zu beenden, ersetzen Sie <Distribution Name> durch den Namen der zielbezogenen Verteilung.

Identifizieren der IP-Adresse

  • wsl hostname -I: Gibt die IP-Adresse Ihrer Linux-Verteilung zurück, die über WSL 2 installiert ist (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>

Exportiert eine Momentaufnahme der angegebenen Verteilung als neue Verteilungsdatei. Standardmäßig wird das TAR-Format verwendet. Der Dateiname kann für die Standardeingabe - werden. Zu den Optionen gehören:

  • --vhd: Gibt an, dass die Exportverteilung eine VHDX-Datei anstelle einer Tar-Datei sein soll (dies wird nur mit WSL 2 unterstützt)

Importieren einer Distribution

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

Importiert die angegebene Tar-Datei als neue Verteilung. Der Dateiname kann für die Standardeingabe - werden. Zu den Optionen gehören:

  • --vhd: Gibt an, dass die Importverteilung eine VHDX-Datei anstelle einer Tar-Datei sein soll (dies wird nur mit WSL 2 unterstützt)
  • --version <1/2>: Gibt an, ob die Verteilung als WSL 1- oder WSL 2-Verteilung importiert werden soll.

Direktes Importieren einer Distribution

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

Importiert die angegebene VHDX-Datei als neue Verteilung. Die virtuelle Festplatte muss im Ext4-Dateisystemtyp formatiert sein.

Aufheben der Registrierung oder Deinstallation einer Linux-Verteilung

Während Linux-Distributionen über den Microsoft Store installiert werden können, können sie nicht über den Store deinstalliert werden.

So heben Sie die Registrierung auf und deinstallieren eine WSL-Verteilung:

wsl --unregister <DistributionName>

Wenn Sie <DistributionName> durch den Namen Ihrer zielbezogenen Linux-Verteilung ersetzen, wird die Registrierung dieser Verteilung von WSL aufgehoben, damit sie neu installiert oder bereinigt werden kann. Achtung: Sobald die Registrierung aufgehoben wurde, gehen alle Daten, Einstellungen und Software, die dieser Verteilung zugeordnet sind, dauerhaft verloren. Durch das erneute Installieren aus dem Store wird eine saubere Kopie der Distribution heruntergeladen. Beispielsweise würde wsl --unregister Ubuntu Ubuntu aus den distributionen entfernen, die in WSL verfügbar sind. Wenn wsl --list ausgeführt wird, wird angezeigt, dass sie nicht mehr aufgeführt ist.

Sie können die Linux-Verteilungs-App auch auf Ihrem Windows-Computer wie jede andere Store-Anwendung deinstallieren. Um die Neuinstallation zu installieren, suchen Sie die Verteilung im Microsoft Store, und wählen Sie "Starten" aus.

Einbinden eines Datenträgers oder Geräts

wsl --mount <DiskPath>

Sie können einen physischen Datenträger an alle WSL2-Distributionen anfügen und bereitstellen, indem Sie <DiskPath> durch den Verzeichnis-/Dateipfad ersetzen, unter dem sich der Datenträger befindet. Siehe Einen Linux-Datenträger in WSL 2 einbinden. Zu den Optionen gehören:

  • --vhd: Gibt an, dass <Disk> auf eine virtuelle Festplatte verweist.
  • --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>: Dateisystemtyp, der beim Anbringen eines Datenträgers verwendet werden soll; falls nicht angegeben, wird standardmäßig ext4 verwendet. Dieser Befehl kann auch als: wsl --mount -t <Filesystem>eingegeben werden. Sie können den Dateisystemtyp mithilfe des Befehls erkennen: blkid <BlockDevice>, z. B.: blkid <dev/sdb1>.
  • --partition <Partition Number>: Indexnummer der Partition, die eingehängt werden soll; wenn nicht angegeben, wird standardmäßig das gesamte Laufwerk verwendet.
  • --options <MountOptions>: Es gibt einige dateisystemspezifische Optionen, die beim Einbinden eines Datenträgers enthalten sein 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, rwoder noatimewerden nicht unterstützt.

Anmerkung

Wenn Sie einen 32-Bit-Prozess ausführen, um auf wsl.exe (ein 64-Bit-Tool) zuzugreifen, müssen Sie den Befehl möglicherweise wie folgt ausführen: C:\Windows\Sysnative\wsl.exe --command.

Aufheben der Einbindung von Datenträgern

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 Linux-Distributionen, die mit WSL installiert wurden, wurden jedoch durch die wsl- oder wsl.exe Befehlssyntax ersetzt.