Guide d’installation du sous-système Windows pour Linux pour Windows 10Windows Subsystem for Linux Installation Guide for Windows 10

Installer le sous-système Windows pour LinuxInstall the Windows Subsystem for Linux

Avant d’installer des distributions Linux sur Windows, vous devez activer la fonctionnalité facultative « Sous-système Windows pour Linux ».Before installing any Linux distributions on Windows, you must enable the "Windows Subsystem for Linux" optional feature.

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

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

Pour installer uniquement WSL 1, vous devez maintenant redémarrer votre ordinateur et passer à Installer la distribution Linux de votre choix. Sinon, attendez de redémarrer et passez à la mise à jour vers WSL 2.To only install WSL 1, you should now restart your machine and move on to Install your Linux distribution of choice, otherwise wait to restart and move on to update to WSL 2. Découvrez plus en détail la comparaison entre WSL 2 et WSL 1.Read more about Comparing WSL 2 and WSL 1.

Mettre à jour vers WSL 2Update to WSL 2

Pour effectuer une mise à jour vers WSL 2, vous devez respecter les critères suivants :To update to WSL 2, you must meet the following criteria:

Activer le composant facultatif « Plateforme de machine virtuelle »Enable the 'Virtual Machine Platform' optional component

Avant d’installer WSL 2, vous devez activer la fonctionnalité facultative « Plateforme de machine virtuelle ».Before installing WSL 2, you must enable the "Virtual Machine Platform" optional feature.

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

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Redémarrez votre ordinateur pour terminer l’installation de WSL et mettre à jour vers WSL 2.Restart your machine to complete the WSL install and update to WSL 2.

Définir WSL 2 comme version par défautSet WSL 2 as your default version

Ouvrez PowerShell en tant qu’Administrateur et exécutez cette commande pour définir WSL 2 comme version par défaut lors de l’installation d’une nouvelle distribution Linux :Open PowerShell as Administrator and run this command to set WSL 2 as the default version when installing a new Linux distribution:

wsl --set-default-version 2

Ce message peut s’afficher après l’exécution de la commande suivante : WSL 2 requires an update to its kernel component. For information please visit https://aka.ms/wsl2kernel.You might see this message after running that command: WSL 2 requires an update to its kernel component. For information please visit https://aka.ms/wsl2kernel. Suivez le lien https://aka.ms/wsl2kernel, puis installez le MSI à partir de cette page dans notre documentation pour installer sur votre ordinateur un noyau Linux accessible à WSL 2.Please follow the link (https://aka.ms/wsl2kernel) and install the MSI from that page on our documentation to install a Linux kernel on your machine for WSL 2 to use. Une fois le noyau installé, réexécutez la commande. L’opération doit alors se dérouler correctement sans afficher le message.Once you have the kernel installed, please run the command again and it should complete successfully without showing the message.

Notes

L’exécution de la mise à jour de WSL 1 vers WSL 2 peut prendre plusieurs minutes en fonction de la taille de votre distribution ciblée.The update from WSL 1 to WSL 2 may take several minutes to complete depending on the size of your targeted distribution. Si vous exécutez une ancienne installation (héritée) de WSL 1 à partir de Windows 10 version Mise à jour anniversaire ou Creators Update, une erreur de mise à jour peut se produire.If you are running an older (legacy) installation of WSL 1 from Windows 10 Anniversary Update or Creators Update, you may encounter an update error. Suivez ces instructions pour désinstaller et supprimer les distributions héritées.Follow these instructions to uninstall and remove any legacy distributions.

Si wsl --set-default-version est considéré comme une commande non valide, entrez wsl --help.If wsl --set-default-version results as an invalid command, enter wsl --help. Si --set-default-version ne figure pas dans la liste, cela signifie que votre système d’exploitation ne le prend pas en charge et que vous devez effectuer une mise à jour vers la version 2004, build 19041 ou ultérieure.If the --set-default-version is not listed, it means that your OS doesn't support it and you need to update to version 2004, Build 19041 or higher.

Installer la distribution Linux de votre choixInstall your Linux distribution of choice

  1. Ouvrez le Microsoft Store et sélectionnez votre distribution Linux préférée.Open the Microsoft Store and select your favorite Linux distribution.

    Vue des distributions Linux dans le Microsoft Store

    Les liens suivants ouvrent la page Microsoft Store pour chaque distribution :The following links will open the Microsoft store page for each distribution:

  2. Dans la page de la distribution, sélectionnez « Obtenir ».From the distribution's page, select "Get".

    Distributions Linux dans le Microsoft Store

Configurer une nouvelle distributionSet up a new distribution

La première fois que vous lancez une distribution Linux nouvellement installée, une fenêtre de console s’ouvre et vous êtes invité à attendre une minute ou deux pour que les fichiers soient décompressés et stockés sur votre PC.The first time you launch a newly installed Linux distribution, a console window will open and you'll be asked to wait for a minute or two for files to de-compress and be stored on your PC. Tous les lancements ultérieurs doivent prendre moins d’une seconde.All future launches should take less than a second.

Vous devez ensuite créer un compte d’utilisateur et un mot de passe pour votre nouvelle distribution Linux.You will then need to create a user account and password for your new Linux distribution.

Décompression Ubuntu dans la console Windows

Définir votre version de distribution sur WSL 1 ou WSL 2Set your distribution version to WSL 1 or WSL 2

Vous pouvez vérifier la version WSL affectée à chacune des distributions Linux que vous avez installées en ouvrant la ligne de commande PowerShell et en entrant la commande (disponible uniquement dans la build Windows 19041 ou ultérieure) : wsl -l -vYou can check the WSL version assigned to each of the Linux distributions you have installed by opening the PowerShell command line and entering the command (only available in Windows Build 19041 or higher): wsl -l -v

wsl --list --verbose

Pour définir une distribution devant reposer sur l’une ou l’autre des versions WSL, exécutez :To set a distribution to be backed by either version of WSL please run:

wsl --set-version <distribution name> <versionNumber>

Veillez à remplacer <distribution name> par le vrai nom de votre distribution et <versionNumber> par le chiffre « 1 » ou « 2 ».Make sure to replace <distribution name> with the actual name of your distribution and <versionNumber> with the number '1' or '2'. 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

Cela permet de définir la version de toute nouvelle distribution installée sur WSL 2.This will set the version of any new distribution installed to WSL 2.

Résolution des problèmes liés à l’installationTroubleshooting installation

Vous trouverez ci-dessous des erreurs associées et des suggestions de correction.Below are related errors and suggested fixes. Reportez-vous à la page de résolution des problèmes WSL pour voir des erreurs courantes et leurs solutions.Refer to the WSL troubleshooting page for other common errors and their solutions.

  • Échec de l’installation avec l’erreur 0x80070003Installation failed with error 0x80070003

    • Le sous-système Windows pour Linux s’exécute uniquement sur votre lecteur système (en général, il s’agit de votre lecteur C:).The Windows Subsystem for Linux only runs on your system drive (usually this is your C: drive). Vérifiez que les distributions sont stockées sur votre lecteur système :Make sure that distributions are stored on your system drive:
    • Ouvrez Paramètres -> Stockage -> Autres paramètres de stockage : Modifier l’emplacement d’enregistrement du nouveau contenu Image des paramètres système pour installer les applications sur le lecteur C:Open Settings -> Storage -> More Storage Settings: Change where new content is saved Picture of system settings to install apps on C: drive
  • Échec de WslRegisterDistribution avec l’erreur 0x8007019eWslRegisterDistribution failed with error 0x8007019e

    • Le composant facultatif Sous-système Windows pour Linux n’est pas activé :The Windows Subsystem for Linux optional component is not enabled:
    • Ouvrez Panneau de configuration -> Programmes et fonctionnalités -> Activer ou désactiver des fonctionnalités Windows -> Cochez Sous-système Windows pour Linux ou utilisez l’applet de commande PowerShell mentionnée au début de cet article.Open Control Panel -> Programs and Features -> Turn Windows Feature on or off -> Check Windows Subsystem for Linux or using the PowerShell cmdlet mentioned at the beginning of this article.
  • É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 la version de build 19041 ou ultérieure de Windows.Please make sure that you have the Windows Subsystem for Linux enabled, and that you're using Windows Build version 19041 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.
  • Impossible de terminer l’opération demandée du fait d’une limitation du système de disque virtuel. Les fichiers de disque dur virtuel doivent être décompressés et déchiffrés, mais ne doivent pas être partiellement alloué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.

  • Le terme « wsl » n’est pas reconnu comme nom d’applet de commande, fonction, fichier de script ou programme exécutable.The term 'wsl' is not recognized as the name of a cmdlet, function, script file, or operable program.