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.).
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écutantwsl --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.
Notes
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>
.
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
.
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.
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.
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.
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.
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 ~
.
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
.
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.
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.
wsl --version
Vérifiez les informations de version sur WSL et ses composants.
wsl --help
Consultez la liste des options et des commandes disponibles avec WSL.
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.
<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.
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.
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.
wsl hostname -I
: retourne l’adresse IP de votre distribution Linux installée via WSL 2 (adresse de machine virtuelle WSL 2)ip route show | grep -i default | awk '{ print $3}'
: retourne l’adresse IP de la machine Windows telle que vue à partir de WSL 2 (machine virtuelle WSL 2)
Pour obtenir une explication plus détaillée, consultez Accès aux applications réseau avec WSL : Identifier l’adresse IP.
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)
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
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.
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 ».
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 commandeblkid <BlockDevice>
, par exempleblkid <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 commewsl --mount -o "data-ordered"
ouwsl --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 quero
,rw
ounoatime
, 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
.
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.
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
.
Commentaires sur Windows Subsystem for Linux
Windows Subsystem for Linux est un projet open source. Sélectionnez un lien pour fournir des commentaires :