Material de referencia de comandos del subsistema de Windows para LinuxCommand Reference for Windows Subsystem for Linux

La mejor manera de interactuar con el subsistema de Windows para Linux es usar el comando wsl.exe.The best way to interact with the Windows Subsystem for Linux is to use the wsl.exe command.

wsl.exe

A continuación, se muestra una lista con todas las opciones cuando se usa wsl.exe a partir de la versión 1903 de Windows.Below is a list containing all options when using wsl.exe as of Windows Version 1903.

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

Argumentos para la ejecución de archivos binarios de LinuxArguments for running Linux binaries

  • Sin argumentosWithout arguments

    Si no se proporciona ninguna línea de comandos, wsl.exe inicia el shell predeterminado.If no command line is provided, wsl.exe launches the default shell.

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

    Ejecuta el comando especificado sin usar el shell de Linux predeterminado.Execute the specified command without using the default Linux shell.

  • --

    Pasa el resto de la línea de comandos como está.Pass the remaining command line as is.

Los comandos anteriores también aceptan las siguientes opciones:The above commands also accept the following options:

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

    Ejecuta la distribución especificada.Run the specified distribution.

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

    Ejecuta como el usuario especificado.Run as the specified user.

Argumentos para administrar el subsistema de Windows para LinuxArguments for managing Windows Subsystem for Linux

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

    Exporta la distribución a un archivo tar.Exports the distribution to a tar file. El nombre de archivo puede ser - para la salida estándar.The filename can be - for standard output.

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

    Importa el archivo tar especificado como una nueva distribución.Imports the specified tar file as a new distribution. El nombre de archivo puede ser - para la entrada estándar.The filename can be - for standard input.

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

    Enumera distribuciones.Lists distributions.

    Opciones:Options:

    • --all--all

      Enumera todas las distribuciones, incluidas aquellas que se están instalando o desinstalando actualmente.List all distributions, including distributions that are currently being installed or uninstalled.

    • --running--running

      Enumera solo las distribuciones que están actualmente en ejecución.List only distributions that are currently running.

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

    Establece la distribución como predeterminada.Sets the distribution as the default.

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

    Finaliza la distribución especificada.Terminates the specified distribution.

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

    Anula el registro de la distribución.Unregisters the distribution.

  • --help Muestra información de uso.--help Display usage information.

Comandos adicionalesAdditional Commands

También hay comando históricos para interactuar con el subsistema de Windows para Linux.There are also historic commands to interact with the Windows Subsystem for Linux. Su funcionalidad se incluye en wsl.exe, pero siguen estando disponibles para su uso.Their functionality is encompassed within wsl.exe, but they are still available for use.

wslconfig.exe

Este comando te permite configurar la distribución de WSL.This command lets you configure your WSL distribution. A continuación, se muestra una lista de sus opciones.Below is a list of its options.

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

ArgumentsArguments

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

    Enumera las distribuciones registradas.Lists registered distributions.

    Opciones:Options:

    • /all/all

      Opcionalmente, enumera todas las distribuciones, incluidas aquellas que se están instalando o desinstalando actualmente.Optionally list all distributions, including distributions that are currently being installed or uninstalled.

    • /running/running

      Enumera solo las distribuciones que están actualmente en ejecución.List only distributions that are currently running.

  • /s, /setdefault <Distro>/s, /setdefault <Distro>

    Establece la distribución como predeterminada.Sets the distribution as the default.

  • /t, /terminate <Distro>/t, /terminate <Distro>

    Finaliza la distribución.Terminates the distribution.

  • /u, /unregister <Distro>/u, /unregister <Distro>

    Anula el registro de la distribución.Unregisters the distribution.

  • /upgrade <Distro>/upgrade <Distro>

    Actualiza la distribución al formato del sistema de archivos de WslFs.Upgrades the distribution to the WslFs file system format.

bash.exe

Este comando se usa para iniciar un shell de Bash.This command is used to start a bash shell. A continuación, se muestran las opciones que se pueden usar con este comando.Below are the options you can use with this command.

Con bash [Options...]Using: bash [Options...]

  • No se ha especificado ninguna opciónNo Option given

    Inicia el shell de Bash en el directorio actual.Launches the Bash shell in the current directory. Si el shell de Bash no se instala automáticamente, se ejecuta lxrun /install.If the Bash shell is not installed automatically runs lxrun /install

  • ~

    bash ~ inicia el shell de Bash en el directorio particular del usuario.bash ~ launches the bash shell into the user's home directory. Similar a la ejecución de cd ~.Similar to running cd ~.

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

    Ejecuta el comando, imprime la salida y vuelve a salir del símbolo del sistema de Windows.Runs the command, prints the output and exits back to the Windows command prompt.

    Ejemplo: bash -c "ls".Example: bash -c "ls".

Comandos en desusoDeprecated Commands

lxrun.exe fue el primer comando usado para instalar y administrar el subsistema de Windows para Linux.The lxrun.exe was the first command used to install and manage the Windows Subsystem for Linux. Está en desuso desde la versión 1803 de Windows 10 y versiones posteriores.It is deprecated as of Windows 10 1803 and later.

El comando lxrun.exe se puede usar para interactuar con el subsistema de Windows para Linux (WSL) directamente.The command lxrun.exe can be used to interact with the Windows Subsystem for Linux (WSL) directly. Estos comandos se instalan en el directorio \Windows\System32 y se pueden ejecutar en un símbolo del sistema de Windows o en PowerShell.These commands are installed into the \Windows\System32 directory and may be run within a Windows command prompt or in PowerShell.

ComandoCommand DescripciónDescription
lxrun El comando lxrun se usa para administrar la instancia de WSL.The lxrun command is used to manage the WSL instance.
lxrun /install Inicia el proceso de descarga e instalación.Starts the download and install process.
/y se puede agregar para omitir todos los mensajes./y may be added to bypass all prompts. El mensaje de confirmación se acepta automáticamente y el usuario predeterminado se establece en raíz.The confirmation prompt is automatically accepted and the default user is set to root.
lxrun /uninstall Desinstala y elimina la imagen de Ubuntu.Uninstalls and deletes the Ubuntu image. De manera predeterminada, no se quita el directorio particular de Ubuntu del usuario.By default this does not remove the user's Ubuntu home directory.
/y se puede agregar para aceptar automáticamente el mensaje de confirmación./y may be added to automatically accept the confirmation prompt
/full desinstala y elimina el directorio particular de Ubuntu del usuario./full uninstalls and deletes the user's Ubuntu home directory
lxrun /setdefaultuser <userName> Establece el valor predeterminado de Bash en el usuario de Ubuntu.Sets the default Bash on Ubuntu user. Solicitará una contraseña si el usuario especificado no existe.Will prompt for a password if the specified user does not exist. Para obtener más información, visita https://aka.ms/wslusers.For more information visit: https://aka.ms/wslusers.
/y omite la solicitud de confirmación de la contraseña./y Bypasses promping for the password. El usuario se creará sin contraseña.The user will be created without a password.
lxrun /update Actualiza el índice de paquetes del subsistema.Updates the subsystem's package index