Aller au contenu
tricknfixGAMING · TECHNOLOGIE · INFORMATIQUE
Créer
#windows-11·Question ouverteTutorial

Erreur 0x80370102 à l'installation de WSL 2 sous Windows 11 : virtualisation et solutions

0 réponse
Tutorial

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. »

Problème

  • wsl --install ou le premier lancement d'Ubuntu affiche l'erreur 0x80370102.
  • Le message parle d'une machine virtuelle qui ne peut pas démarrer ou d'une fonctionnalité requise non installée.
  • La distribution reste inutilisable alors que l'installation semblait terminée.
  • Le PC est lui-même une machine virtuelle (Hyper-V) et WSL 2 refuse de démarrer à l'intérieur.

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 --install fonctionne 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.

Solution proposée

  1. Ouvrez PowerShell ou une invite de commandes.
  2. Lancez la commande ci-dessous, puis descendez jusqu'à la section Configuration requise pour Hyper-V (Hyper-V Requirements).
Batch3 lignes

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.

Solution proposée

  1. Ouvrez de préférence cette page sur un autre appareil, comme le conseille Microsoft.
  2. Allez dans Paramètres > Système > Récupération, puis à côté de Démarrage avancé, choisissez Redémarrer maintenant.
  3. Choisissez Dépannage (parfois traduit « Résoudre les problèmes ») > Options avancées > Paramètres du microprogramme UEFI > Redémarrer.
  4. Dans l'UEFI, activez l'option de virtualisation du processeur (souvent appelée Intel VT-x, Intel Virtualization Technology, AMD-V ou SVM selon le fabricant), enregistrez et quittez.

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.

Solution proposée

  1. Ouvrez le menu Démarrer, tapez fonctionnalités Windows et choisissez Activer ou désactiver des fonctionnalités Windows.
  2. Cochez Plateforme de machine virtuelle, puis OK.
  3. Redémarrez le PC : Microsoft rappelle que le redémarrage est nécessaire après l'activation.

Vous pouvez aussi activer ce composant depuis PowerShell administrateur, avec la commande donnée par Microsoft :

PowerShell3 lignes

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.

Solution proposée

  1. Ouvrez PowerShell en tant qu'administrateur.
  2. Lancez la commande de vérification ci-dessous.
  3. Si la ligne affiche hypervisorlaunchtype Off, l'hyperviseur est désactivé : lancez la commande d'activation, puis redémarrez.
PowerShell4 lignes

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.

Solution proposée

  1. Listez les distributions installées et leur version de WSL.
  2. Si la distribution est encore en version 1, passez-la en version 2 (remplacez <Distro> par son nom, par exemple Ubuntu).
  3. Si l'installation reste bloquée à 0,0 %, Microsoft conseille de télécharger d'abord la distribution avec l'option --web-download.
PowerShell5 lignes

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

SituationCe qu'indique Microsoft
WSL 2 dans une machine virtuelle Hyper-VActivez 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 AzureLa virtualisation imbriquée n'est pas prise en charge avec Trusted Launch : vérifiez que cette option est désactivée.
Erreur 0x8007019eLe composant facultatif WSL n'est pas activé : Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux, puis redémarrage.
Erreur 0x80070003Les 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.exe indique 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 hypervisorlaunchtype affiche Auto.
  • ☐ wsl.exe --list --verbose affiche la version 2 et la distribution démarre.

Sources

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.

Une idée, une piste ?

Soyez la première personne à rejoindre la discussion.

Répondre

Votre réponse sera conservée avant la connexion. Vous pourrez la relire avant de publier.

Votre réponse sera conservée pendant la connexion.

Les captures pourront être ajoutées après connexion.