Informations de référence sur les commandes pour le sous-système Windows pour LinuxCommand Reference for Windows Subsystem for Linux

La commande wsl.exe offre le meilleur moyen d’interagir avec le sous-système Windows pour Linux.The best way to interact with the Windows Subsystem for Linux is to use the wsl.exe command.

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

Exécutez la commande suivante dans PowerShell pour définir WSL 2 comme version par défaut lors de l’installation d’une nouvelle distribution Linux :Run the following command in Powershell to set WSL 2 as the default version when installing a new Linux distribution:

wsl --set-default-version 2

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.

wsl.exe

Voici une liste complète des options pouvant être utilisées avec la commande wsl.exe à partir de la version 1903 de Windows.Below is a list containing all options when using wsl.exe as of Windows Version 1903.

Utilisation : wsl [Argument] [Options...] [CommandLine]Using: wsl [Argument] [Options...] [CommandLine]

Arguments pour l’exécution de commandes LinuxArguments for running Linux commands

  • Sans argumentWithout arguments

    Si aucune ligne de commande n’est fournie, wsl.exe lance le shell par défaut.If no command line is provided, wsl.exe launches the default shell.

  • --exec, -e <CommandLine>--exec, -e <CommandLine>

    Exécute la commande spécifiée sans utiliser le shell Linux par défaut.Execute the specified command without using the default Linux shell.

  • --

    Transmet le reste de la ligne de commande tel quel.Pass the remaining command line as is.

Les commandes ci-dessus acceptent également les options suivantes :The above commands also accept the following options:

  • --distribution, -d <Distro>--distribution, -d <Distro>

    Exécute la distribution spécifiée.Run the specified distribution.

  • --user, -u <UserName>--user, -u <UserName>

    Procède à l’exécution sous l’utilisateur spécifié.Run as the specified user.

Arguments pour la gestion du sous-système Windows pour LinuxArguments for managing Windows Subsystem for Linux

  • --export <Distro> <FileName>--export <Distro> <FileName>

    Exporte la distribution vers un fichier tar.Exports the distribution to a tar file. Le nom de fichier peut être - pour une sortie standard.The filename can be - for standard output.

  • --import <Distro> <InstallLocation> <FileName>--import <Distro> <InstallLocation> <FileName>

    Importe le fichier tar spécifié en tant que nouvelle distribution.Imports the specified tar file as a new distribution. Le nom de fichier peut être - pour une entrée standard.The filename can be - for standard input.

  • --list, -l [Options]--list, -l [Options]

    Liste les distributions.Lists distributions.

    Options :Options:

    • --all--all

      Liste toutes les distributions, y compris les distributions en cours d’installation ou de désinstallation.List all distributions, including distributions that are currently being installed or uninstalled.

    • --running--running

      Liste uniquement les distributions en cours d’exécution.List only distributions that are currently running.

  • --set-default, -s <Distro>--set-default, -s <Distro>

    Définit la distribution en tant que distribution par défaut.Sets the distribution as the default.

  • --terminate, -t <Distro>--terminate, -t <Distro>

    Met fin à la distribution spécifiée.Terminates the specified distribution.

  • --unregister <Distro>--unregister <Distro>

    Annule l’inscription de la distribution.Un-register the distribution.

  • --help Affiche des informations sur l’utilisation.--help Display usage information.

Commandes supplémentairesAdditional Commands

Certaines commandes historiques permettent également d’interagir avec le sous-système Windows pour Linux.There are also historic commands to interact with the Windows Subsystem for Linux. wsl.exe englobe leurs fonctionnalités, mais elles restent toujours à disposition.Their functionality is encompassed within wsl.exe, but they are still available for use.

wslconfig.exe

Cette commande vous permet de configurer votre distribution WSL.This command lets you configure your WSL distribution. Voici une liste des options correspondantes.Below is a list of its options.

Utilisation : wslconfig [Argument] [Options...]Using: wslconfig [Argument] [Options...]

ArgumentsArguments

  • /l, /list [Options]/l, /list [Options]

    Liste les distributions inscrites.Lists registered distributions.

Options :Options:

  • /all Liste toutes les distributions, y compris les distributions en cours d’installation ou de désinstallation (facultatif)./all Optionally list all distributions, including distributions that are currently being installed or uninstalled.

  • /running Liste uniquement les distributions en cours d’exécution./running List only distributions that are currently running.

  • /s, /setdefault <Distro> Définit la distribution en tant que distribution par défaut./s, /setdefault <Distro> Sets the distribution as the default.

  • /t, /terminate <Distro> Met fin à la distribution./t, /terminate <Distro> Terminates the distribution.

  • /u, /unregister <Distro> Désinscrit la distribution./u, /unregister <Distro> Un-registers the distribution.

  • /upgrade <Distro> Met à niveau la distribution avec le format du système de fichiers WslFs./upgrade <Distro> Upgrades the distribution to the WslFs file system format.

bash.exe

Cette commande permet de démarrer un shell Bash.This command is used to start a bash shell. Vous trouverez ci-dessous les options que vous pouvez utiliser avec cette commande.Below are the options you can use with this command.

Utilisation : bash [Options...]Using: bash [Options...]

  • Aucune option indiquéeNo Option given

    Lance le shell Bash dans le répertoire actif.Launches the Bash shell in the current directory. Si le shell Bash n’est pas installé, cette commande lance automatiquement lxrun /install.If the Bash shell is not installed automatically runs lxrun /install

  • ~

    bash ~ lance le shell Bash dans le répertoire de base de l’utilisateur.bash ~ launches the bash shell into the user's home directory. Cette option est similaire à cd ~.Similar to running cd ~.

  • -c "<command>"-c "<command>"

    Exécute la commande, affiche la sortie et revient à l’invite de commandes Windows.Runs the command, prints the output and exits back to the Windows command prompt.

    Par exemple : bash -c "ls".Example: bash -c "ls".

Commandes dépréciéesDeprecated Commands

lxrun.exe était la première commande utilisée pour installer et gérer le sous-système Windows pour Linux.The lxrun.exe was the first command used to install and manage the Windows Subsystem for Linux. Elle est dépréciée pour les versions 1803 et ultérieures de Windows 10.It is deprecated as of Windows 10 1803 and later.

La commande lxrun.exe peut être utilisée pour interagir directement avec le sous-système Windows pour Linux (WSL).The command lxrun.exe can be used to interact with the Windows Subsystem for Linux (WSL) directly. Ces commandes sont installées dans le répertoire \Windows\System32 et peuvent être exécutées dans une invite de commandes Windows ou dans PowerShell.These commands are installed into the \Windows\System32 directory and may be run within a Windows command prompt or in PowerShell.

CommandeCommand DescriptionDescription
lxrun La commande lxrun est utilisée pour gérer l’instance de WSL.The lxrun command is used to manage the WSL instance.
lxrun /install Démarre le processus de téléchargement et d’installation.Starts the download and install process.
/y peut être ajouté pour ignorer toutes les invites./y may be added to bypass all prompts. L’invite de confirmation est automatiquement acceptée et l’utilisateur par défaut est défini sur la racine.The confirmation prompt is automatically accepted and the default user is set to root.
lxrun /uninstall Désinstalle et supprime l’image Ubuntu.Uninstalls and deletes the Ubuntu image. Par défaut, le répertoire de base Ubuntu de l’utilisateur n’est pas supprimé.By default this does not remove the user's Ubuntu home directory.
/y peut être ajouté pour accepter automatiquement l’invite de confirmation./y may be added to automatically accept the confirmation prompt
/full désinstalle et supprime le répertoire de base Ubuntu de l’utilisateur./full uninstalls and deletes the user's Ubuntu home directory
lxrun /setdefaultuser <userName> Définit l’utilisateur Bash sur Ubuntu par défaut.Sets the default Bash on Ubuntu user. Demande un mot de passe si l’utilisateur spécifié n’existe pas.Will prompt for a password if the specified user does not exist. Pour plus d’informations, consultez : https://aka.ms/wslusers.For more information visit: https://aka.ms/wslusers.
/y ignore la demande de mot de passe./y Bypasses promping for the password. L’utilisateur sera créé sans mot de passe.The user will be created without a password.
lxrun /update Met à jour l’index du package du sous-système.Updates the subsystem's package index