Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.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. 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 Siewsl --list --online
ausfü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 -o
eingegeben 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 -v
eingegeben 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 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.
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.
Windows Subsystem for Linux