Résoudre l’erreur WSL 0x80370102 : fonctionnalité manquante

L’erreur WSL 0x80370102 affiche « The virtual machine could not be started because a required feature is not installed. ». Elle signifie que la machine virtuelle WSL 2 ne peut pas démarrer parce qu’une condition requise de virtualisation est absente ou désactivée. L’erreur peut survenir lors de l’installation, de l’inscription, de la conversion ou du démarrage d’une distribution sous Windows 11 ou une version éligible de Windows 10. Déterminez d’abord si Windows s’exécute sur un PC physique ou dans une machine virtuelle ; sur un PC physique, l’action la plus sûre consiste à activer Virtual Machine Platform si nécessaire, puis à effectuer le redémarrage requis.

Signification de l’erreur WSL 0x80370102

Le même échec peut apparaître sous la forme WslRegisterDistribution failed with error: 0x80370102, Wsl/Service/CreateInstance/CreateVm/0x80370102, ou sous la forme d’un message vous demandant d’activer Virtual Machine Platform et la virtualisation dans le BIOS. Il s’agit de signatures équivalentes d’un échec de démarrage de la virtualisation WSL 2, et non d’erreurs distinctes.

WSL ou la distribution Linux peuvent déjà être installés. L’échec se produit parce que la machine virtuelle WSL 2 ne peut pas démarrer. Cette erreur ne permet pas, à elle seule, de conclure que la distribution est endommagée.

Contexte Windows	Premier prérequis à examiner
PC physique	Virtual Machine Platform, puis virtualisation dans le microprogramme
Matériel physique ancien	Prise en charge par le processeur de la traduction d’adresses de second niveau (SLAT)
Windows dans une machine virtuelle Hyper-V	Virtualisation imbriquée exposée par l’hôte parent
Prérequis applicables déjà confirmés	Configuration de démarrage de l’hyperviseur Windows

Microsoft documente cette erreur et ses branches de prérequis dans les instructions de dépannage WSL de Microsoft. Le contexte actuel d’installation de WSL requiert Windows 10 version 2004 ou ultérieure, ou Windows 11. La documentation d’installation manuelle de Microsoft indique également des seuils limités pour des versions antérieures de Windows 10, notamment la version 1903 x64 build 18362.1049 ou ultérieure. L’éligibilité technique d’une build ne signifie pas qu’une version de Windows 10 est encore incluse dans son cycle de support actuel.

Résoudre l’erreur 0x80370102 sur un PC Windows physique

Activer Virtual Machine Platform et redémarrer

Quand appliquer cette solution : utilisez cette procédure sur un PC physique lorsque Virtual Machine Platform n’est pas déjà connue comme étant activée. La procédure officielle fournie ne comprend pas de commande distincte de vérification de la fonctionnalité ; si le composant est déjà activé et que Windows a été redémarré après son activation, passez à la vérification de la virtualisation dans le microprogramme.

Prérequis : vous devez disposer de droits d’administrateur et d’une version de Windows prenant en charge WSL 2. Les limites de build et la commande documentées par Microsoft sont disponibles dans les instructions d’installation de WSL de Microsoft.

Ouvrez PowerShell en tant qu’administrateur.
Exécutez dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart.
Redémarrez l’ordinateur. Le redémarrage est obligatoire avant que le composant soit actif.
Réessayez l’installation de WSL, l’inscription de la distribution, la conversion vers WSL 2 ou le démarrage de la distribution qui a produit l’erreur 0x80370102.

Résultat attendu : Windows active le composant Virtual Machine Platform afin que WSL 2 puisse l’utiliser. Un autre prérequis indisponible peut toutefois encore empêcher le démarrage de la machine virtuelle.

Risque et annulation : il s’agit d’une modification à faible risque d’une fonctionnalité Windows, qui ne supprime pas les données de la distribution. Des droits d’administrateur sont requis. Si nécessaire, désactivez la fonctionnalité Virtual Machine Platform pour revenir à l’état précédent ; aucune commande de désactivation non vérifiée n’est fournie ici.

Activer la virtualisation dans le BIOS ou l’UEFI

Quand appliquer cette solution : utilisez cette procédure sur un PC physique si Virtual Machine Platform est activée, si le redémarrage Windows requis a été effectué et si l’erreur 0x80370102 persiste.

Prérequis : obtenez les instructions BIOS ou UEFI correspondant exactement au PC ou à la carte mère. Les noms des menus du microprogramme et les méthodes d’accès varient selon le fabricant ; les séquences de touches ou libellés de menus universels ne sont donc pas fiables.

Ouvrez les paramètres du microprogramme du PC en suivant les instructions du fabricant.
Activez la prise en charge de la virtualisation du processeur dans le BIOS ou l’UEFI.
Enregistrez la modification du microprogramme et quittez le programme de configuration.
Redémarrez Windows.
Réessayez l’opération WSL 2.

Résultat attendu : Windows peut utiliser la capacité de virtualisation du processeur, à condition que celui-ci prenne également en charge SLAT et qu’aucun autre prérequis applicable ne soit absent.

Risque et annulation : il s’agit d’une modification du microprogramme à risque moyen. Notez le paramètre d’origine, car les changements de virtualisation peuvent affecter d’autres hyperviseurs ou configurations de sécurité. Pour annuler, revenez dans l’interface du microprogramme et restaurez le paramètre de virtualisation précédent.

Vérifier la prise en charge de SLAT par le processeur

Quand appliquer cette vérification : vérifiez cette exigence lorsque l’appareil peut être trop ancien pour WSL 2 ou lorsque l’activation des paramètres Windows et du microprogramme documentés ne résout pas l’échec de démarrage.

Prérequis : vous devez pouvoir accéder aux informations système de Windows ou aux spécifications fiables du processeur installé.

Identifiez le processeur et vérifiez s’il prend en charge la traduction d’adresses de second niveau, ou SLAT.
Confirmez cette capacité à l’aide des informations système Windows ou de spécifications matérielles fiables, sans supposer que tous les processeurs 64 bits la prennent en charge.
Si le processeur est antérieur à Intel Nehalem ou AMD Opteron et ne possède pas la capacité requise, cessez d’essayer de forcer WSL 2 et envisagez le recours à WSL 1.

Résultat attendu : cette vérification distingue un problème de virtualisation configurable d’un matériel non pris en charge. Les modifications du microprogramme ne peuvent pas ajouter SLAT à un processeur qui en est dépourvu.

Risque et annulation : il s’agit d’un diagnostic en lecture seule, à faible risque, qui ne modifie pas le système.

Résoudre l’erreur 0x80370102 lorsque Windows s’exécute dans une machine virtuelle Hyper-V

Lorsque Windows est lui-même un invité Hyper-V, il ne suffit pas d’activer les paramètres de virtualisation dans cet invité. L’hôte Hyper-V parent doit exposer les extensions de virtualisation à l’invité. Cette procédure nécessite un accès à l’hôte et ne s’applique pas automatiquement aux hyperviseurs tiers ou dans le cloud.

Quand appliquer cette solution : utilisez cette procédure uniquement lorsque WSL 2 s’exécute dans une machine virtuelle Windows Hyper-V.

Prérequis : vous devez disposer de droits d’administrateur sur l’hôte Hyper-V parent et connaître le nom réel de la machine virtuelle invitée Windows.

Sur l’hôte Hyper-V parent, ouvrez PowerShell en tant qu’administrateur.
Exécutez Set-VMProcessor -VMName <VMName> -ExposeVirtualizationExtensions $true.
Remplacez <VMName> par le nom réel de l’invité ; ne saisissez pas le texte de remplacement tel quel.
Démarrez ou redémarrez l’invité Windows.
Réessayez WSL 2 dans l’invité.

Résultat attendu : l’hôte parent expose les extensions de virtualisation requises par WSL 2 dans l’invité. Microsoft explique cette exigence côté hôte dans sa documentation sur la virtualisation imbriquée Hyper-V.

Risque et annulation : il s’agit d’une modification à risque moyen de la configuration du processeur de la machine virtuelle. Pour supprimer les extensions exposées, exécutez la même commande sur l’hôte parent avec $false à la place de $true. N’appliquez pas cette commande Hyper-V à une autre plateforme de virtualisation. Pour un hyperviseur tiers, consultez sa documentation de compatibilité actuelle et spécifique à la version.

Vérifier la configuration de démarrage de l’hyperviseur si les prérequis sont activés

Quand appliquer cette solution : utilisez cette procédure avancée uniquement après avoir confirmé la fonctionnalité Windows applicable, le redémarrage requis, la virtualisation du microprogramme, la prise en charge de SLAT et l’exigence de virtualisation imbriquée. Elle s’applique lorsque WSL 2 ne peut toujours pas créer sa machine virtuelle parce que Windows est configuré pour ne pas démarrer l’hyperviseur.

Prérequis : des droits d’administrateur sont requis. La modification de ce paramètre peut affecter les logiciels qui dépendent d’un autre état de l’hyperviseur Windows.

Ouvrez PowerShell en tant qu’administrateur.
Exécutez bcdedit /enum | findstr -i hypervisorlaunchtype.
Si le résultat affiche Off, exécutez bcdedit /set hypervisorlaunchtype Auto.
Redémarrez Windows.
Réessayez l’opération WSL 2 qui a échoué.

Résultat attendu : lorsque la valeur était auparavant définie sur Off, Windows peut démarrer l’hyperviseur lors du démarrage du système. Cette modification ne résout pas l’absence de prise en charge de SLAT ni l’indisponibilité de la virtualisation imbriquée.

Risque et annulation : il s’agit d’une modification à risque moyen de la configuration de démarrage. Si l’état antérieur doit être restauré, redéfinissez hypervisorlaunchtype sur Off, puis redémarrez Windows.

Utiliser WSL 1 lorsque WSL 2 n’est pas disponible

Quand appliquer cette solution : utilisez WSL 1 comme solution de repli uniquement lorsque le matériel ne peut pas prendre en charge WSL 2 ou lorsque le fournisseur de machines virtuelles ne peut pas rendre la virtualisation imbriquée disponible. Ce n’est pas la solution principale à une condition requise désactivée qui peut être activée sans risque.

Prérequis : WSL doit être installé et la distribution doit déjà être présente ou pouvoir être installée. Si une distribution existante contient des données importantes, exportez-la ou sauvegardez-la avant la conversion. Les commandes précises de sauvegarde et de conversion sont volontairement omises, car elles ne figuraient pas dans la procédure confirmée.

Exportez ou sauvegardez autrement la distribution existante lorsque la conservation des données est importante.
Configurez la distribution pour utiliser WSL 1 au lieu de WSL 2 en suivant la documentation WSL actuelle de Microsoft.
Continuez à utiliser la distribution en tenant compte des limitations de WSL 1.

Résultat attendu : la distribution utilise WSL 1 au lieu de l’architecture de machine virtuelle de WSL 2. WSL 1 n’est pas fonctionnellement identique à WSL 2 ; consultez donc la documentation WSL actuelle de Microsoft concernant les différences de fonctionnalités et de compatibilité avant de choisir cette solution de repli.

Risque et annulation : cette solution de repli présente un faible risque lorsque les données de la distribution ont été conservées. Si les prérequis de WSL 2 deviennent disponibles ultérieurement, la distribution peut être reconvertie vers WSL 2 après une nouvelle sauvegarde.

Éléments à collecter si l’erreur 0x80370102 persiste

Si tous les prérequis applicables sont déjà confirmés et que l’erreur persiste, rassemblez des éléments avant d’escalader le problème. Cela permet de distinguer un problème Microsoft Windows d’une limitation liée au microprogramme, au processeur ou à l’hôte de virtualisation.

Le code d’erreur exact et le message complet, y compris tout texte WslRegisterDistribution ou CreateInstance/CreateVm.
L’édition, la version et le numéro de build de Windows.
Si Windows s’exécute sur du matériel physique ou dans une machine virtuelle.
Si Virtual Machine Platform a été activée et si le redémarrage requis a été effectué.
Si la virtualisation du microprogramme est activée sur un PC physique.
Le modèle du processeur et la source fiable utilisée pour confirmer la prise en charge de SLAT.
Pour une machine virtuelle, l’hyperviseur parent et si les extensions de virtualisation ont été exposées.
La valeur hypervisorlaunchtype indiquée et si elle a été modifiée.
L’action ayant échoué : installation de WSL, inscription de la distribution, démarrage ou conversion de WSL 1 vers WSL 2.

Escaladez vers Microsoft en cas d’échec Windows ou WSL après confirmation de toutes les exigences, vers le fabricant de l’appareil pour les questions relatives au microprogramme ou au processeur, ou vers le fournisseur de virtualisation lorsque la virtualisation imbriquée n’est pas disponible. Ne réinitialisez pas, ne désinscrivez pas et ne réinstallez pas la distribution pour cette seule erreur : les éléments officiels fournis ne confirment pas ces actions potentiellement perturbatrices comme solutions.

Éviter les solutions non prises en charge

N’utilisez pas de modifications non documentées du Registre.
Ne supposez pas que l’activation de Hyper-V seule remplace Virtual Machine Platform, la virtualisation du microprogramme, SLAT ou la virtualisation imbriquée.
N’apportez pas de modifications générales aux fonctionnalités ou services Hyper-V qui ne sont pas liés au prérequis diagnostiqué.
Ne sautez pas le redémarrage après l’activation de Virtual Machine Platform ou la modification de la virtualisation du microprogramme.
Ne continuez pas à forcer WSL 2 sur un processeur dépourvu de SLAT.

Autres erreurs Windows

Si le code n’est pas 0x80370102, utilisez un guide propre à l’erreur rencontrée. Les procédures destinées aux erreurs Windows Update 0x80070005 ou Add-AppxPackage 0x80073D02 ne s’appliquent pas à cette erreur de virtualisation WSL 2.

Questions fréquentes

Que signifie l’erreur WSL 0x80370102 ?

Elle signifie que la machine virtuelle utilisée par WSL 2 ne peut pas démarrer parce qu’un prérequis de virtualisation est absent ou désactivé. Il peut s’agir de Virtual Machine Platform, de la virtualisation BIOS/UEFI, de SLAT, de la virtualisation imbriquée ou de la configuration de démarrage de l’hyperviseur.

Dois-je redémarrer après avoir activé Virtual Machine Platform ?

Oui. Le redémarrage est requis avant que le composant Virtual Machine Platform soit actif.

Pourquoi l’erreur 0x80370102 se produit-elle dans une machine virtuelle Hyper-V ?

Un invité Windows Hyper-V a besoin que l’hôte parent lui expose les extensions de virtualisation. L’activation de paramètres dans l’invité seul ne suffit pas.

WSL 1 peut-il être utilisé à la place de WSL 2 ?

WSL 1 est une solution de repli lorsque le matériel ne prend pas en charge WSL 2 ou lorsque la virtualisation imbriquée ne peut pas être fournie. Sauvegardez les données importantes de la distribution avant une conversion.

Dois-je réinstaller ou désinscrire ma distribution Linux ?

Non. Les éléments officiels fournis ne confirment pas la réinitialisation, la désinscription ou la réinstallation de la distribution comme solution à l’erreur 0x80370102.