Commandes de base pour WSL

Les commandes WSL de base ci-dessous sont listées dans un format pris en charge par PowerShell ou par l’invite de commandes Windows. Pour exécuter ces commandes à partir d’une ligne de commande de distribution Bash/Linux, vous devez remplacer wsl par wsl.exe.

Installer

wsl --install

Installez WSL et la distribution Ubuntu de Linux. Plus d’informations

Installer une distribution Linux spécifique

wsl --install --distribution <Distribution Name>

Désignez une distribution de Linux à installer en dehors de celle par défaut (Ubuntu) en remplaçant <Distribution Name> par le nom de la distribution. Cette commande peut également être entrée en tant que : wsl -d <Distribution Name>.

Lister les distributions Linux disponibles

wsl --list --online

Consultez la liste des distributions Linux disponibles par le biais du magasin en ligne. Cette commande peut également être entrée en tant que : wsl -l -o.

Lister les distributions Linux installées

wsl --list --verbose

Consultez la liste des distributions Linux installées sur votre ordinateur Windows, dont l’état (si la distribution est en cours d’exécution ou arrêtée) et la version de WSL exécutant la distribution (WSL 1 ou WSL 2). Comparaison entre WSL 1 et WSL 2. Cette commande peut également être entrée en tant que : wsl -l -v. Les options supplémentaires qui peuvent être utilisées avec la commande list sont --all pour lister toutes les distributions, --running pour lister uniquement les distributions en cours d’exécution ou --quiet pour afficher uniquement les noms des distributions.

Définir la version 1 ou 2 de WSL

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

Pour désigner la version de WSL (1 ou 2) sur laquelle une distribution Linux s’exécute, remplacez <distribution name> par le nom de la distribution et <versionNumber> par 1 ou 2. Comparaison entre WSL 1 et WSL 2.

Définir la version de WSL par défaut

wsl --set-default-version <Version>

Pour définir la version WSL 1 ou WSL 2 par défaut, remplacez <Version> par le chiffre 1 ou 2 pour représenter la version de WSL par défaut souhaitée pour les installations des nouvelles distributions Linux. Par exemple : wsl --set-default-version 2. Comparaison entre WSL 1 et WSL 2.

Définir la distribution Linux par défaut

wsl --set-default <Distribution Name>

Pour définir la distribution Linux par défaut qui sera utilisée par les commandes WSL pour l’exécution, remplacez <Distribution Name> par le nom de votre distribution Linux préférée.

Accéder au répertoire de base

wsl ~

Le ~ peut être utilisé avec WSL pour démarrer dans le répertoire de base de l’utilisateur. Pour passer d’un répertoire à l’accueil à partir d’une invite de commandes WSL, vous pouvez utiliser la commande : cd ~.

Exécuter une distribution Linux spécifique à partir de PowerShell ou de CMD

wsl --distribution <Distribution Name> --user <User Name>

Pour exécuter une distribution Linux spécifique avec un utilisateur donné, remplacez <Distribution Name> par le nom de votre distribution Linux préférée (par exemple, Debian) et <User Name> par le nom d’un utilisateur existant (par exemple, racine). Si l’utilisateur n’existe pas dans la distribution WSL, vous recevrez une erreur. Pour imprimer le nom d’utilisateur actuel, utilisez la commande whoami.

Mettre à jour WSL

wsl --update

Mettez manuellement à jour la version de votre noyau Linux WSL. Vous pouvez également utiliser la commande wsl --update rollback pour revenir à une version antérieure du noyau Linux WSL.

Vérifier l’état de WSL

wsl --status

Consultez des informations générales sur votre configuration WSL, comme le type de distribution par défaut, la distribution par défaut et la version du noyau.

Commande help

wsl --help

Consultez la liste des options et des commandes disponibles avec WSL.

Exécuter en tant qu’utilisateur spécifique

wsl -u <Username>`, `wsl --user <Username>

Pour exécuter WSL en tant qu’utilisateur spécifié, remplacez <Username> par le nom d’un utilisateur qui existe dans la distribution WSL.

Changer l’utilisateur par défaut pour une distribution

<DistributionName> config --default-user <Username>

Changez l’utilisateur par défaut pour la connexion de votre distribution. L’utilisateur doit déjà exister dans la distribution pour pouvoir devenir l’utilisateur par défaut.

Par exemple : ubuntu config --default-user johndoe va changer l’utilisateur par défaut de la distribution Ubuntu pour l’utilisateur « johndoe ».

Notes

Si vous avez des difficultés à déterminer le nom de votre distribution, utilisez la commande wsl -l.

Avertissement

Cette commande ne fonctionne pas pour les distributions importées, car ces distributions n’ont pas de lanceur exécutable. À la place, vous pouvez changer l’utilisateur par défaut pour les distributions importées en utilisant le fichier /etc/wsl.conf. Consultez les options de montage automatique dans la documentation Configuration des paramètres avancés.

Éteindre

wsl --shutdown

Met immédiatement fin à toutes les distributions en cours d’exécution et à la machine virtuelle utilitaire légère WSL 2. Cette commande peut être nécessaire dans les instances qui nécessitent le redémarrage de l’environnement de machine virtuelle WSL 2, par exemple pour modifier les limites d’utilisation de la mémoire ou apporter une modification à votre fichier .wslconfig.

Terminate

wsl --terminate <Distribution Name>

Pour mettre fin à la distribution spécifiée ou arrêter son exécution, remplacez <Distribution Name> par le nom de la distribution ciblée.

Exporter une distribution vers un fichier TAR

wsl --export <Distribution Name> <FileName>

Exporte la distribution vers un fichier tar. Le nom de fichier peut être - pour une sortie standard.

Importer une nouvelle distribution

wsl --import <Distribution Name> <InstallLocation> <FileName>

Importe le fichier tar spécifié en tant que nouvelle distribution. Le nom de fichier peut être - pour une entrée standard. L’option --version peut également être utilisée avec cette commande pour indiquer si la distribution importée s’exécutera sur WSL 1 ou WSL 2.

Désinscrire ou désinstaller une distribution Linux

Les distributions Linux peuvent être installées via le Microsoft Store, mais elles ne peuvent pas être désinstallées via celui-ci.

Pour désinscrire et désinstaller une distribution WSL :

wsl --unregister <DistributionName>

Remplacez <DistributionName> par le nom de votre distribution Linux ciblée pour désinscrire cette distribution de WSL ; vous pourrez ensuite la réinstaller ou la nettoyer. Attention : Une fois qu’une distribution est désinscrite, toutes les données, paramètres et logiciels associés à celle-ci sont définitivement perdus. La réinstallation à partir du Store installe une nouvelle copie de la distribution. Par exemple : wsl --unregister Ubuntu va supprimer Ubuntu des distributions disponibles dans WSL. L’exécution de wsl --list montre qu’elle ne figure plus dans la liste.

Vous pouvez également désinstaller l’application de distribution Linux sur votre ordinateur Windows comme n’importe quelle autre application du Windows Store. Pour la réinstaller, recherchez la distribution dans le Microsoft Store, puis sélectionnez « Lancer ».

Monter un disque ou un appareil

wsl --mount <DiskPath>

Attachez et montez un disque physique dans toutes les distributions WSL2 en remplaçant <DiskPath> par le chemin du répertoire\fichier où se trouve le disque. Consultez Monter un disque Linux dans WSL 2. Options disponibles :

  • wsl --mount --bare : Attachez le disque à WSL2, mais ne le montez pas.
  • wsl --mount --type <Filesystem> : Type de système de fichiers à utiliser lors du montage d’un disque. S’il n’est pas spécifié, la valeur par défaut est ext4. Cette commande peut également être entrée en tant que : wsl --mount -t <Filesystem>. Vous pouvez détecter le type de système de fichiers à l’aide de la commande blkid <BlockDevice>, par exemple blkid <dev/sdb1>.
  • wsl --mount --partition <Partition Number> : Numéro d’index de la partition à monter. S’il n’est pas spécifié, il s’agit par défaut de l’ensemble du disque.
  • wsl --mount --options <MountOptions> : Il existe des options spécifiques au système de fichiers qui peuvent être incluses lors du montage d’un disque. Par exemple, des options de montage ext4 comme wsl --mount -o "data-ordered" ou wsl --mount -o "data=writeback. Toutefois, seules les options spécifiques au système de fichiers sont prises en charge pour l’instant. Les options génériques, telles que ro, rw ou noatime, ne sont pas prises en charge.
  • wsl --unmount <DiskPath> : Démontez et détachez le disque de toutes les distributions WSL 2. Si <DiskPath> n’est pas inclus, cette commande démonte et détache TOUS les disques montés.

Notes

Si vous exécutez un processus 32 bits pour accéder à wsl.exe (outil 64 bits), vous devrez peut-être exécuter la commande de la manière suivante : C:\Windows\Sysnative\wsl.exe --command.

Commandes WSL dépréciées

wslconfig.exe [Argument] [Options]
bash [Options]
lxrun /[Argument]

Ces commandes constituaient la syntaxe wsl d’origine pour la configuration des distributions Linux installées avec WSL, mais ont été remplacées par la syntaxe de commande wsl ou wsl.exe.