Instructions d’installation pour WSL 2Installation Instructions for WSL 2

Pour installer et commencer à utiliser WSL 2, effectuez les étapes suivantes :To install and start using WSL 2 complete the following steps:

WSL 2 est disponible uniquement dans Windows 10 versions 18917 ou ultérieuresWSL 2 is only available in Windows 10 builds 18917 or higher

  • Vérifiez que vous avez installé WSL (vous trouverez des instructions pour le faire ici) et que vous exécutez Windows 10 Build 18917 ou une version ultérieure.Ensure that you have WSL installed (you can find instructions to do so here) and that you are running Windows 10 build 18917 or higher
    • Pour vous assurer que vous utilisez la version 18917 ou une version ultérieure, rejoignez le programme Windows Insider et sélectionnez l’anneau « Fast ».To make sure you are using build 18917 or higher please join the Windows Insider Program and select the 'Fast' ring.
    • Vous pouvez vérifier votre version de Windows en ouvrant l’invite de commandes et en exécutant la commande ver.You can check your Windows version by opening Command Prompt and running the ver command.
  • Activer le composant facultatif « Plateforme de machine virtuelle »Enable the 'Virtual Machine Platform' optional component
  • Définir une distribution basée sur WSL 2 en utilisant la ligne de commandeSet a distro to be backed by WSL 2 using the command line
  • Vérifier les versions de WSL que vos distributions utilisentVerify what versions of WSL your distros are using

Activez le composant facultatif « plateforme de machine virtuelle » et assurez-vous que WSL est activéEnable the 'Virtual Machine Platform' optional component and make sure WSL is enabled

Ouvrez PowerShell en tant qu’administrateur et exécutez :Open PowerShell as an Administrator and run:

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform

Cela permet de s’assurer que les composants facultatifs plateforme de machine virtuelle et sous-système Windows pour Linux sont installés.This will make sure that both the Virtual Machine Platform and Windows Subsystem for Linux optional components are installed. Une fois que vous avez exécuté ces commandes, vous devez redémarrer votre ordinateur.After you've run these commands you'll need to restart your computer.

Définir une distribution basée sur WSL 2 en utilisant la ligne de commandeSet a distro to be backed by WSL 2 using the command line

Dans PowerShell, exécutez :In PowerShell run:

wsl --set-version <Distro> 2

et veillez à remplacer <Distro> par le vrai nom de votre distribution.and make sure to replace <Distro> with the actual name of your distro. (Vous pouvez le trouver avec la commande : wsl -l).(You can find these with the command: wsl -l). Vous pouvez revenir à WSL 1 quand vous voulez en exécutant la même commande que ci-dessus, mais en remplaçant le « 2 » par un « 1 ».You can change back to WSL 1 at anytime by running the same command as above but replacing the '2' with a '1'.

Par ailleurs, si vous souhaitez faire de WSL 2 votre architecture par défaut, utilisez cette commande :Additionally, if you want to make WSL 2 your default architecture you can do so with this command:

wsl --set-default-version 2

Ainsi, toutes les nouvelles distributions que vous installerez seront initialisées en tant que distributions WSL 2.This will make any new distro that you install be initialized as a WSL 2 distro.

Pour terminer, vérifiez quelles versions de WSL utilisent vos distributions.Finish with verifying what versions of WSL your distro are using

Pour vérifier les versions de WSL que chaque distribution utilise, utilisez la commande suivante (disponible uniquement dans Windows Build 18917 ou version ultérieure) :To verify what versions of WSL each distro is using use the following command (only available in Windows Build 18917 or higher):

wsl --list --verbose ou wsl -l -vwsl --list --verbose or wsl -l -v

La distribution que vous avez choisie ci-dessus doit maintenant afficher un « 2 » dans la colonne « version ».The distro that you've chosen above should now display a '2' under the 'version' column. Maintenant que vous avez terminé, n’hésitez pas à commencer à utiliser votre distribution WSL 2 !Now that you're finished feel free to start using your WSL 2 distro!

Dépannage :Troubleshooting:

Vous trouverez ci-dessous des erreurs associées et des suggestions de correction lors de l’installation de WSL 2.Below are related errors and suggested fixes when installing WSL 2. Reportez-vous à la page de résolution des problèmes WSL pour voir d’autres erreurs WSL générales et leurs solutions.Please refer to the WSL troubleshooting page for other general WSL errors and their solutions.

  • Échec de l’installation avec l’erreur 0x80070003 ou l’erreur 0x80370102Installation failed with error 0x80070003 or error 0x80370102

    • Assurez-vous que la virtualisation est activée dans le BIOS de votre ordinateur.Please make sure that virtualization is enabled inside of your computer's BIOS. Les instructions sur la façon de procéder varient d’un ordinateur à l’autre et se trouvent très probablement sous les options liées au processeur.The instructions on how to do this will vary from computer to computer, and will most likely be under CPU related options.
  • Erreur lors d’une tentative de mise à niveau : Invalid command line option: wsl --set-version Ubuntu 2Error when trying to upgrade: Invalid command line option: wsl --set-version Ubuntu 2

    • Vérifiez que le sous-système Windows pour Linux est activé et que vous utilisez Windows version de build 18917 ou ultérieure.Please make sure that you have the Windows Subsystem for Linux enabled, and that you're using Windows Build version 18917 or higher. Pour activer WSL, exécutez cette commande dans une invite PowerShell avec des privilèges d’administrateur : Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux.To enable WSL run this command in a Powershell prompt with admin privileges: Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux. Vous trouverez les instructions complètes de l’installation de WSL ici.You can find the full WSL install instructions here.
  • L’opération demandée n’a pas pu être effectuée en raison d’une limitation du système de disque virtuel. Les fichiers de disque dur virtuel doivent être décompressés et déchiffrés et ne doivent pas être éparpillés.The requested operation could not be completed due to a virtual disk system limitation. Virtual hard disk files must be uncompressed and unencrypted and must not be sparse.