WSL-Fehler 0x80370102 beheben: Erforderliches Feature fehlt

Der WSL-Fehler 0x80370102 zeigt die Meldung „Der virtuelle Computer konnte nicht gestartet werden, da ein erforderliches Feature nicht installiert ist.“ an. Das bedeutet, dass der virtuelle Computer von WSL 2 nicht gestartet werden kann, weil eine Virtualisierungsvoraussetzung fehlt oder deaktiviert ist. Der Fehler kann beim Installieren, Registrieren, Konvertieren oder Starten einer Distribution unter Windows 11 oder einer unterstützten Windows-10-Version auftreten. Stellen Sie zunächst fest, ob Windows auf einem physischen PC oder in einer virtuellen Maschine ausgeführt wird. Auf einem physischen PC ist die sicherste erste Maßnahme, bei Bedarf Virtual Machine Platform zu aktivieren und den erforderlichen Neustart durchzuführen.

Bedeutung des WSL-Fehlers 0x80370102

Der gleiche Fehler kann als WslRegisterDistribution failed with error: 0x80370102, Wsl/Service/CreateInstance/CreateVm/0x80370102 oder als Meldung angezeigt werden, die zum Aktivieren von Virtual Machine Platform und der Virtualisierung im BIOS auffordert. Dies sind gleichwertige Kennungen für einen Fehler beim Start der WSL-2-Virtualisierung, keine unterschiedlichen Fehler.

WSL selbst oder die Linux-Distribution können bereits installiert sein. Der Fehler tritt auf, weil der virtuelle Computer von WSL 2 nicht starten kann. Er belegt für sich genommen nicht, dass die Distribution beschädigt ist.

Windows-Umgebung	Zuerst zu prüfende Voraussetzung
Physischer PC	Virtual Machine Platform, anschließend Firmware-Virtualisierung
Ältere physische Hardware	CPU-Unterstützung für Second Level Address Translation (SLAT)
Windows in einer Hyper-V-VM	Vom übergeordneten Host bereitgestellte geschachtelte Virtualisierung
Alle zutreffenden Voraussetzungen bereits bestätigt	Startkonfiguration des Windows-Hypervisors

Microsoft dokumentiert diesen Fehler und die zugehörigen Voraussetzungen in der Problembehandlung für WSL von Microsoft. Die aktuelle WSL-Installationsumgebung erfordert Windows 10, Version 2004 oder höher, oder Windows 11. Die manuelle Installationsdokumentation von Microsoft nennt außerdem eingeschränkte Mindestanforderungen für ältere Windows-10-Builds, darunter Version 1903 x64, Build 18362.1049 oder höher. Die technische Eignung eines Builds bedeutet nicht, dass die betreffende Windows-10-Version noch innerhalb ihres aktuellen Supportlebenszyklus liegt.

0x80370102 auf einem physischen Windows-PC beheben

Virtual Machine Platform aktivieren und neu starten

Wann dies zutrifft: Verwenden Sie diesen Weg auf einem physischen PC, wenn nicht bereits bekannt ist, dass Virtual Machine Platform aktiviert ist. Das bereitgestellte offizielle Verfahren enthält keinen separaten Befehl zur Überprüfung des Features. Wenn die Komponente bereits aktiviert und Windows danach neu gestartet wurde, fahren Sie mit der Prüfung der Firmware-Virtualisierung fort.

Voraussetzungen: Sie benötigen Administratorrechte und eine Windows-Version, die WSL 2 unterstützt. Die von Microsoft dokumentierten Buildgrenzen und den Befehl finden Sie in der Anleitung WSL installieren von Microsoft.

Öffnen Sie PowerShell als Administrator.
Führen Sie dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart aus.
Starten Sie den Computer neu. Der Neustart ist erforderlich, bevor die Komponente aktiv wird.
Wiederholen Sie die WSL-Installation, die Registrierung der Distribution, die Konvertierung zu WSL 2 oder den Start der Distribution, bei dem 0x80370102 aufgetreten ist.

Erwartetes Ergebnis: Windows aktiviert die Komponente Virtual Machine Platform, sodass WSL 2 sie verwenden kann. Eine weitere nicht verfügbare Voraussetzung kann den Start des virtuellen Computers weiterhin verhindern.

Risiko und Rückgängigmachen: Dies ist eine Windows-Featureänderung mit geringem Risiko und löscht keine Daten der Distribution. Administratorrechte sind erforderlich. Deaktivieren Sie bei Bedarf das Feature Virtual Machine Platform, um zum vorherigen Featurezustand zurückzukehren. Ein nicht überprüfter Deaktivierungsbefehl wird hier nicht angegeben.

Firmware-Virtualisierung in BIOS oder UEFI aktivieren

Wann dies zutrifft: Verwenden Sie diesen Weg auf einem physischen PC, wenn Virtual Machine Platform aktiviert ist, der erforderliche Windows-Neustart durchgeführt wurde und der Fehler 0x80370102 weiterhin auftritt.

Voraussetzungen: Besorgen Sie die BIOS- oder UEFI-Anleitung für den genauen PC beziehungsweise das Mainboard. Firmware-Menünamen und Zugriffsmethoden unterscheiden sich je nach Hersteller; allgemeingültige Tastenkombinationen oder Menübezeichnungen sind daher nicht zuverlässig.

Öffnen Sie die Firmwareeinstellungen des PCs gemäß den Anweisungen des Herstellers.
Aktivieren Sie die CPU-Virtualisierungsunterstützung im BIOS oder UEFI.
Speichern Sie die Firmwareänderung und beenden Sie das Setup.
Starten Sie Windows neu.
Wiederholen Sie den WSL-2-Vorgang.

Erwartetes Ergebnis: Windows kann die Virtualisierungsfunktion des Prozessors verwenden, sofern die CPU auch SLAT unterstützt und keine weitere zutreffende Voraussetzung fehlt.

Risiko und Rückgängigmachen: Dies ist eine Firmwareänderung mit mittlerem Risiko. Notieren Sie die ursprüngliche Einstellung, da Änderungen der Virtualisierung andere Hypervisoren oder Sicherheitskonfigurationen beeinflussen können. Um die Änderung rückgängig zu machen, öffnen Sie die Firmwareoberfläche erneut und stellen Sie die vorherige Virtualisierungseinstellung wieder her.

Prüfen, ob die CPU SLAT unterstützt

Wann dies zutrifft: Prüfen Sie diese Voraussetzung, wenn das Gerät für WSL 2 möglicherweise zu alt ist oder das Aktivieren der dokumentierten Windows- und Firmwareeinstellungen den Startfehler nicht behebt.

Voraussetzung: Sie benötigen Zugriff auf die Windows-Systeminformationen oder auf maßgebliche technische Daten des installierten Prozessors.

Ermitteln Sie den Prozessor und prüfen Sie, ob er Second Level Address Translation (SLAT) unterstützt.
Bestätigen Sie die Fähigkeit über die Windows-Systeminformationen oder maßgebliche Hardwarespezifikationen, statt anzunehmen, dass jede 64-Bit-CPU sie unterstützt.
Wenn der Prozessor älter als Intel Nehalem oder AMD Opteron ist und die erforderliche Fähigkeit nicht besitzt, versuchen Sie nicht weiter, WSL 2 zu erzwingen, und ziehen Sie WSL 1 als Ausweichlösung in Betracht.

Erwartetes Ergebnis: Diese Prüfung unterscheidet ein konfigurierbares Virtualisierungsproblem von nicht unterstützter Hardware. Firmwareänderungen können einer CPU ohne diese Funktion kein SLAT hinzufügen.

Risiko und Rückgängigmachen: Dies ist eine schreibgeschützte Diagnose mit geringem Risiko und nimmt keine Systemänderung vor.

0x80370102 beheben, wenn Windows in einer Hyper-V-VM ausgeführt wird

Wenn Windows selbst ein Hyper-V-Gast ist, reicht das Aktivieren von Virtualisierungseinstellungen innerhalb dieses Gasts nicht aus. Der übergeordnete Hyper-V-Host muss die Virtualisierungserweiterungen für den Gast verfügbar machen. Dieser Zweig erfordert Zugriff auf den Host und gilt nicht automatisch für Hypervisoren anderer Anbieter oder Cloud-Hypervisoren.

Wann dies zutrifft: Verwenden Sie diesen Weg nur, wenn WSL 2 in einer Windows-Hyper-V-VM ausgeführt wird.

Voraussetzungen: Sie benötigen Administratorrechte auf dem übergeordneten Hyper-V-Host und den tatsächlichen Namen der Windows-Gast-VM.

Öffnen Sie auf dem übergeordneten Hyper-V-Host PowerShell als Administrator.
Führen Sie Set-VMProcessor -VMName <VMName> -ExposeVirtualizationExtensions $true aus.
Ersetzen Sie <VMName> durch den tatsächlichen Namen des Gasts; geben Sie den Platzhalter nicht wörtlich ein.
Starten Sie den Windows-Gast oder starten Sie ihn neu.
Wiederholen Sie WSL 2 innerhalb des Gasts.

Erwartetes Ergebnis: Der übergeordnete Host stellt die Virtualisierungserweiterungen bereit, die WSL 2 innerhalb des Gasts benötigt. Microsoft erläutert diese Hostvoraussetzung in der Dokumentation Was ist geschachtelte Virtualisierung für Hyper-V?.

Risiko und Rückgängigmachen: Dies ist eine Änderung der VM-Prozessorkonfiguration mit mittlerem Risiko. Um die bereitgestellten Erweiterungen zu entfernen, führen Sie denselben Befehl auf dem übergeordneten Host mit $false statt $true aus. Wenden Sie diesen Hyper-V-Befehl nicht auf eine andere Virtualisierungsplattform an. Ziehen Sie für einen Hypervisor eines Drittanbieters dessen aktuelle versionsspezifische Kompatibilitätsdokumentation heran.

Hypervisor-Startkonfiguration prüfen, wenn Voraussetzungen aktiviert sind

Wann dies zutrifft: Verwenden Sie diesen erweiterten Weg erst, nachdem Sie das zutreffende Windows-Feature, den erforderlichen Neustart, die Firmware-Virtualisierung, die SLAT-Unterstützung und die Anforderung der geschachtelten Virtualisierung bestätigt haben. Er gilt, wenn WSL 2 seinen virtuellen Computer weiterhin nicht erstellen kann, weil Windows so konfiguriert ist, dass der Hypervisor nicht gestartet wird.

Voraussetzung: Administratorrechte sind erforderlich. Das Ändern dieser Einstellung kann Software beeinträchtigen, die einen anderen Hypervisorzustand von Windows benötigt.

Öffnen Sie PowerShell als Administrator.
Führen Sie bcdedit /enum | findstr -i hypervisorlaunchtype aus.
Wenn das Ergebnis Off zeigt, führen Sie bcdedit /set hypervisorlaunchtype Auto aus.
Starten Sie Windows neu.
Wiederholen Sie den fehlgeschlagenen WSL-2-Vorgang.

Erwartetes Ergebnis: Wenn der Wert zuvor Off war, kann Windows den Hypervisor beim Start laden. Dadurch werden fehlendes SLAT oder nicht verfügbare geschachtelte Virtualisierung nicht überwunden.

Risiko und Rückgängigmachen: Dies ist eine Änderung der Startkonfiguration mit mittlerem Risiko. Wenn der vorherige Zustand wiederhergestellt werden muss, setzen Sie hypervisorlaunchtype wieder auf Off und starten Sie neu.

WSL 1 verwenden, wenn WSL 2 nicht verfügbar ist

Wann dies zutrifft: Verwenden Sie WSL 1 nur als Ausweichlösung, wenn die Hardware WSL 2 nicht unterstützt oder der Anbieter der virtuellen Maschine keine geschachtelte Virtualisierung bereitstellen kann. Dies ist nicht die primäre Lösung für eine deaktivierte Voraussetzung, die sicher aktiviert werden kann.

Voraussetzungen: WSL muss installiert sein und die Distribution muss bereits vorhanden oder installierbar sein. Wenn eine vorhandene Distribution wichtige Daten enthält, exportieren Sie sie oder erstellen Sie vor der Konvertierung eine Sicherung. Die genauen Sicherungs- und Konvertierungsbefehle werden absichtlich nicht angegeben, da sie im bestätigten Verfahren nicht enthalten waren.

Exportieren Sie die vorhandene Distribution oder sichern Sie sie auf andere Weise, wenn die Daten erhalten bleiben müssen.
Stellen Sie die Distribution gemäß der aktuellen WSL-Dokumentation von Microsoft auf WSL 1 statt WSL 2 um.
Verwenden Sie die Distribution weiter und berücksichtigen Sie dabei die Einschränkungen von WSL 1.

Erwartetes Ergebnis: Die Distribution verwendet WSL 1 statt der Architektur virtueller Computer von WSL 2. WSL 1 ist funktional nicht mit WSL 2 identisch. Prüfen Sie daher vor der Auswahl dieser Ausweichlösung die aktuelle WSL-Dokumentation von Microsoft auf Funktions- und Kompatibilitätsunterschiede.

Risiko und Rückgängigmachen: Die Ausweichlösung ist risikoarm, wenn die Daten der Distribution gesichert wurden. Falls die Voraussetzungen für WSL 2 später verfügbar werden, kann die Distribution nach einer weiteren Sicherung wieder zu WSL 2 konvertiert werden.

Was Sie erfassen sollten, wenn der Fehler 0x80370102 weiterhin auftritt

Wenn alle zutreffenden Voraussetzungen bereits bestätigt sind und der Fehler weiterhin besteht, sammeln Sie vor einer Eskalation Nachweise. Dies hilft, ein Microsoft-Windows-Problem von einer Einschränkung der Firmware, des Prozessors oder des Virtualisierungshosts zu unterscheiden.

Den genauen Fehlercode und die vollständige Meldung, einschließlich etwaigem Text mit WslRegisterDistribution oder CreateInstance/CreateVm.
Die Windows-Edition, -Version und den Build.
Ob Windows auf physischer Hardware oder in einer virtuellen Maschine ausgeführt wird.
Ob Virtual Machine Platform aktiviert wurde und ob der erforderliche Neustart durchgeführt wurde.
Ob die Firmware-Virtualisierung auf einem physischen PC aktiviert ist.
Das Prozessormodell und die maßgebliche Quelle, mit der die SLAT-Unterstützung bestätigt wurde.
Bei einer virtuellen Maschine den übergeordneten Hypervisor und ob Virtualisierungserweiterungen bereitgestellt wurden.
Den gemeldeten Wert für hypervisorlaunchtype und ob er geändert wurde.
Die fehlgeschlagene Aktion: WSL-Installation, Registrieren der Distribution, Start oder Konvertierung von WSL 1 zu WSL 2.

Wenden Sie sich an Microsoft, wenn nach der Bestätigung aller Anforderungen weiterhin ein Windows- oder WSL-Fehler auftritt, an den Gerätehersteller bei Fragen zu Firmware oder Prozessor oder an den Virtualisierungsanbieter, wenn geschachtelte Virtualisierung nicht verfügbar ist. Setzen Sie die Distribution nicht zurück, heben Sie ihre Registrierung nicht auf und installieren Sie sie nicht allein wegen dieses Fehlers neu: Die bereitgestellten offiziellen Nachweise bestätigen diese potenziell störenden Maßnahmen nicht als Abhilfe.

Nicht unterstützte Lösungen vermeiden

Verwenden Sie keine undokumentierten Registrierungsänderungen.
Nehmen Sie nicht an, dass das Aktivieren von Hyper-V allein Virtual Machine Platform, Firmware-Virtualisierung, SLAT oder geschachtelte Virtualisierung ersetzt.
Nehmen Sie keine pauschalen Änderungen an Hyper-V-Features oder -Diensten vor, die nicht mit der ermittelten Voraussetzung zusammenhängen.
Überspringen Sie den Neustart nicht, nachdem Sie Virtual Machine Platform oder die Firmware-Virtualisierung aktiviert haben.
Versuchen Sie nicht weiter, WSL 2 auf einem Prozessor ohne SLAT zu erzwingen.

Andere Windows-Fehler

Wenn der Code nicht 0x80370102 lautet, verwenden Sie stattdessen eine Anleitung für den jeweiligen Fehler. Die Verfahren für Windows-Update-Fehler 0x80070005 oder Add-AppxPackage-Fehler 0x80073D02 gelten nicht für diesen WSL-2-Virtualisierungsfehler.