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. Pour obtenir la liste complète des commandes, exécutez wsl --help. Si vous ne l’avez pas encore fait, nous vous recommandons de procéder à la mise à jour vers la version de WSL installée à partir du Microsoft Store pour recevoir les mises à jour WSL dès qu’elles sont disponibles. (En savoir plus sur l’installation de WSL via le Microsoft Store.).

Installer

wsl --install

Installez WSL et la distribution Ubuntu par défaut de Linux. Plus d’informations Vous pouvez également utiliser cette commande pour installer des distributions Linux supplémentaires en exécutant wsl --install <Distribution Name>. Pour obtenir une liste valide de noms de distribution, exécutez wsl --list --online.

Options disponibles :

• --distribution : Spécifiez la distribution Linux à installer. Vous pouvez trouver les distributions disponibles en exécutant wsl --list --online.
• --no-launch : Installez la distribution Linux, mais ne la lancez pas automatiquement.
• --web-download : Effectuez l’installation depuis une source en ligne plutôt que d’utiliser le Microsoft Store.

Lorsque WSL n’est pas installé, les options sont les suivantes :

• --inbox : Installe WSL à l’aide du composant Windows au lieu d’utiliser le Microsoft Store. (Les mises à jour WSL sont reçues via les mises à jour Windows, plutôt qu’envoyées quand elles sont disponibles via le Store).
• --enable-wsl1 : Active WSL 1 lors de l’installation de la version Microsoft Store de WSL en activant également le composant facultatif « Sous-système Windows pour Linux ».
• --no-distribution : N’installez pas de distribution lors de l’installation de WSL.

Remarque

Si vous exécutez WSL sur Windows 10 ou antérieur, il peut être nécessaire d’inclure l’indicateur -d avec la commande --install pour spécifier une distribution : wsl --install -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. WSL 2 est uniquement disponible dans Windows 11 ou Windows 10, version 1903, build 18362 ou ultérieure.

Avertissement

Le basculement entre WSL 1 et WSL 2 peut prendre du temps et entraîner des défaillances en raison des différences entre les deux architectures. Pour les distributions avec des projets volumineux, nous vous recommandons de sauvegarder des fichiers avant de tenter une conversion.

Définir la version de WSL par défaut

wsl --set-default-version <Version>

Pour définir une version par défaut de WSL 1 ou WSL 2, remplacez <Version> par le nombre 1 ou 2. Par exemple : wsl --set-default-version 2. Le nombre représente la version de WSL par défaut pour les nouvelles installations de distribution Linux. Comparaison entre WSL 1 et WSL 2. WSL 2 est uniquement disponible dans Windows 11 ou Windows 10, version 1903, build 18362 ou ultérieure.

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 à jour votre version WSL avec la dernière version. Options disponibles :

• --web-download : Téléchargez la dernière mise à jour à partir de GitHub plutôt que du Microsoft Store.

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.

Vérifier la version WSL

wsl --version

Vérifiez les informations de version sur WSL et ses composants.

Commande help

wsl --help

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

Exécuter en tant qu’utilisateur spécifique

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.

Identifier l’adresse IP

• wsl hostname -i pour l’adresse IP de votre distribution Linux installée via WSL 2 (l’adresse de machine virtuelle WSL 2)
• cat /etc/resolv.conf pour l’adresse IP de la machine Windows telle que vue à partir de WSL 2 (la machine virtuelle WSL 2)

Exporter une distribution

wsl --export <Distribution Name> <FileName>

Exporte un instantané de la distribution spécifiée en tant que nouveau fichier de distribution. La valeur par défaut est le format tar. Le nom de fichier peut être - pour une entrée standard. Options disponibles :

• --vhd : spécifie que la distribution d’exportation doit être un fichier .vhdx au lieu d’un fichier tar (pris en charge seulement avec WSL 2)

Importer une 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. Options disponibles :

• --vhd : spécifie que la distribution d’importation doit être un fichier .vhdx au lieu d’un fichier tar (pris en charge seulement avec WSL 2)
• --version <1/2> : spécifie s’il faut importer la distribution en tant que distribution WSL 1 ou WSL 2

Importer une distribution sur place

wsl --import-in-place <Distribution Name> <FileName>

Importe le fichier .vhdx spécifié en tant que nouvelle distribution. Le disque dur virtuel doit être mis en forme dans le type de système de fichiers ext4.

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 :

• --vhd : Spécifie que <Disk> fait référence à un disque dur virtuel.
• --name : Montez le disque à l’aide d’un nom personnalisé pour le point de montage.
• --bare : Attachez le disque à WSL2, mais ne le montez pas.
• --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>.
• --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.
• --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.

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.

Démonter les disques

wsl --unmount <DiskPath>

Démontez un disque donné dans le chemin de disque. Si aucun chemin de disque n’est donné, cette commande démonte et détache TOUS les disques montés.

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.