Le Sous-système Windows pour Linux (WSL) permet d'utiliser une distribution Linux comme Ubuntu directement dans Windows. Avec WSL 2, la distribution tourne dans une machine virtuelle légère. Si un composant de virtualisation manque, l'installation ou le premier démarrage s'arrête sur l'erreur 0x80370102, que Microsoft documente ainsi : « Impossible de démarrer la machine virtuelle parce qu'une fonctionnalité requise n'est pas installée. »
Ce qu'il faut savoir avant d'agir
- Les trois causes citées par Microsoft : la fonctionnalité Windows Plateforme de machine virtuelle n'est pas activée, la virtualisation est désactivée dans le BIOS/UEFI, ou le lancement de l'hyperviseur est désactivé dans la configuration de démarrage.
- Matériel requis : WSL 2 exige un processeur compatible SLAT (traduction d'adresses de second niveau), apparu avec les Intel Nehalem (Core de 1re génération) et les AMD Opteron. Microsoft précise qu'un processeur plus ancien comme un Core 2 Duo ne pourra pas exécuter WSL 2, même si la Plateforme de machine virtuelle s'installe.
- Version de Windows :
wsl --installfonctionne sous Windows 11 et sous Windows 10 version 2004 ou ultérieure (build 19041 et plus). - Droits administrateur : les commandes de ce guide se lancent dans PowerShell ouvert en tant qu'administrateur.
Étape 1 : vérifier que le processeur et le BIOS sont prêts
Quand l'utiliser : toujours en premier, avant de modifier quoi que ce soit.
systeminfo.exe
Résultat attendu : selon Microsoft, si toutes les lignes de cette section indiquent Oui, le matériel convient. Si la section indique qu'un hyperviseur a été détecté, un hyperviseur tourne déjà : la virtualisation est donc active, passez à l'étape 3.
Quand arrêter : si la ligne sur la traduction d'adresses de second niveau indique Non, le processeur ne prend pas en charge WSL 2. Ne modifiez rien d'autre : WSL 2 ne fonctionnera pas sur ce PC.
Étape 2 : activer la virtualisation dans le BIOS/UEFI
Quand l'utiliser : l'étape 1 indique Non pour la virtualisation activée dans le microprogramme.
Résultat attendu : après redémarrage, la ligne correspondante de systeminfo.exe passe à Oui.
Quand arrêter : Microsoft insiste pour ne modifier que ce qui est nécessaire dans l'UEFI : d'autres réglages peuvent empêcher Windows de démarrer. Si vous ne trouvez pas l'option, suivez la documentation du fabricant de votre PC ou de votre carte mère (Microsoft renvoie vers Acer, Asus, Dell, HP et Lenovo). Sur les appareils Surface, la virtualisation est déjà activée.
Retour arrière : l'option se désactive de la même façon dans l'UEFI.
Étape 3 : activer la Plateforme de machine virtuelle
Quand l'utiliser : la virtualisation est active, mais l'erreur 0x80370102 persiste. C'est notamment le cas si WSL a été installé manuellement avant l'arrivée de wsl --install, ou après une mise à niveau de Windows 10 vers Windows 11.
Vous pouvez aussi activer ce composant depuis PowerShell administrateur, avec la commande donnée par Microsoft :
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
Résultat attendu : après redémarrage, la distribution démarre sans erreur.
Retour arrière : décochez Plateforme de machine virtuelle dans la même fenêtre et redémarrez.
Étape 4 : vérifier le lancement de l'hyperviseur
Quand l'utiliser : la virtualisation et la Plateforme de machine virtuelle sont activées, et l'erreur continue.
bcdedit /enum | findstr -i hypervisorlaunchtype
bcdedit /set hypervisorlaunchtype Auto
Résultat attendu : la vérification affiche Auto et WSL 2 démarre.
Quand arrêter : si la ligne affiche déjà Auto, ne lancez pas la seconde commande et passez aux cas particuliers.
Retour arrière : si la valeur était Off avant votre intervention (par exemple pour un ancien logiciel de virtualisation), elle peut être remise avec bcdedit /set hypervisorlaunchtype Off puis un redémarrage. WSL 2 ne fonctionnera alors plus.
Étape 5 : terminer l'installation de la distribution
Quand l'utiliser : les étapes précédentes sont faites et vous voulez vérifier ou relancer l'installation.
wsl.exe --list --verbose
wsl --set-version <Distro> 2
wsl --install --web-download -d <Distro>
Résultat attendu : la colonne VERSION affiche 2 et la distribution s'ouvre.
Cas particuliers
| Situation | Ce qu'indique Microsoft |
|---|---|
| WSL 2 dans une machine virtuelle Hyper-V | Activez la virtualisation imbriquée sur l'hôte dans PowerShell administrateur : Set-VMProcessor -VMName <VMName> -ExposeVirtualizationExtensions $true (nom visible dans le Gestionnaire Hyper-V). |
| VMware ou VirtualBox installé | Utilisez une version compatible avec Hyper-V (VMware 15.5.5 ou ultérieure, VirtualBox 6 ou ultérieure) ou désactivez ces logiciels. |
| Machine virtuelle Azure | La virtualisation imbriquée n'est pas prise en charge avec Trusted Launch : vérifiez que cette option est désactivée. |
| Erreur 0x8007019e | Le composant facultatif WSL n'est pas activé : Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux, puis redémarrage. |
| Erreur 0x80070003 | Les distributions doivent être stockées sur le lecteur système (C:). Sous Windows 11 : Paramètres > Système > Stockage > Paramètres de stockage avancés > Emplacement d'enregistrement du nouveau contenu. |
Vérification finale
- ☐
systeminfo.exeindique Oui partout dans la section Hyper-V, ou qu'un hyperviseur a été détecté. - ☐ Plateforme de machine virtuelle est cochée et le PC a redémarré.
- ☐
bcdedit /enum | findstr -i hypervisorlaunchtypeafficheAuto. - ☐
wsl.exe --list --verboseaffiche la version 2 et la distribution démarre.
Sources
- Microsoft Learn : Résolution des problèmes liés au Sous-système Windows pour Linux (erreur 0x80370102, SLAT, bcdedit, virtualisation imbriquée, hyperviseurs tiers, Azure Trusted Launch, erreurs 0x8007019e et 0x80070003)
- Microsoft Learn : Comment installer Linux sur Windows avec WSL (versions de Windows prises en charge,
wsl --install,--web-download,--set-version, commande DISM pour la Plateforme de machine virtuelle) - Support Microsoft : Activer la virtualisation sur Windows (accès à l'UEFI depuis Windows, ne modifier que le nécessaire, liens fabricants, Surface, Plateforme de machine virtuelle)
- Microsoft Learn : Configuration matérielle requise pour Hyper-V (vérification avec
systeminfo.exe, message « un hyperviseur a été détecté »)
Le problème continue ?
Répondez en indiquant votre version de Windows (Paramètres > Système > Informations système), le modèle de votre processeur, la section Hyper-V de systeminfo.exe, le résultat de bcdedit /enum | findstr -i hypervisorlaunchtype et le message d'erreur complet. Retirez le nom de votre PC et votre nom d'utilisateur des captures avant de les publier.