Comandos básicos para WSL

Los comandos de WSL siguientes se enumeran en un formato compatible con PowerShell o el símbolo del sistema de Windows. Para ejecutar estos comandos desde una línea de comandos de distribución de Bash o Linux, debe reemplazar wsl por wsl.exe.

Instalar

wsl --install

Instale WSL y la distribución de Ubuntu de Linux. Más información.

Instalación de una distribución de Linux específica

wsl --install --distribution <Distribution Name>

Designe una distribución de Linux para la instalación además de la predeterminada (Ubuntu) reemplazando <Distribution Name> por el nombre de la distribución. Este comando también se puede especificar como wsl -d <Distribution Name>.

Enumeración de las distribuciones de Linux disponibles

wsl --list --online

Consulte una lista de las distribuciones de Linux disponibles a través de la tienda en línea. Este comando también se puede especificar como wsl -l -o.

Enumeración de las distribuciones de Linux instaladas

wsl --list --verbose

Consulte una lista de las distribuciones de Linux instaladas en la máquina Windows, incluido el estado (si la distribución se está ejecutando o detenida) y la versión de WSL que ejecuta la distribución (WSL 1 o WSL 2). Comparación de WSL 1 con WSL 2. Este comando también se puede especificar como wsl -l -v. Entre las opciones adicionales que se pueden usar con el comando list se incluyen: --all para enumerar todas las distribuciones, --running para enumerar solo las distribuciones que se están ejecutando actualmente o --quiet para mostrar solo los nombres de la distribución.

Establecimiento de la versión de WSL en 1 o 2

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

Para designar la versión de WSL (1 o 2) en la que se ejecuta una distribución de Linux, reemplace <distribution name> por el nombre de la distribución y <versionNumber>, por 1 o 2. Comparación de WSL 1 con WSL 2.

Establecimiento de la versión de WSL predeterminada

wsl --set-default-version <Version>

Para establecer una versión predeterminada de WSL 1 o WSL 2, reemplace <Version> por el número 1 o 2 para representar la versión de WSL en la que desea que la instalación se establezca de forma predeterminada para las nuevas instalaciones de distribución de Linux. Por ejemplo: wsl --set-default-version 2. Comparación de WSL 1 con WSL 2.

Establecimiento de la distribución de Linux predeterminada

wsl --set-default <Distribution Name>

Para establecer la distribución de Linux predeterminada que usarán los comandos de WSL para ejecutarse, reemplace <Distribution Name> por el nombre de la distribución de Linux que prefiera.

Cambio al directorio principal

wsl ~

~ se puede usar con wsl para iniciar en el directorio principal del usuario. Para volver de cualquier directorio al principal desde un símbolo del sistema de WSL, puede usar el comando cd ~.

Ejecución de una distribución de Linux específica desde PowerShell o CMD

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

Para ejecutar una distribución de Linux específica con un usuario específico, reemplace <Distribution Name> por el nombre de la distribución de Linux que prefiera (por ejemplo, Debian) y <User Name>, por el nombre de un usuario existente (por ejemplo, raíz). Si el usuario no existe en la distribución de WSL, recibirá un error. Para imprimir el nombre de usuario actual, use el comando whoami.

Actualización de WSL

wsl --update

Actualice manualmente la versión del kernel de Linux de WSL. También puede usar el comando wsl --update rollback para revertir a una versión anterior del kernel de Linux de WSL.

Comprobación del estado de WSL

wsl --status

Consulte la información general sobre la configuración de WSL, como el tipo de distribución predeterminado, la distribución predeterminada y la versión del kernel.

Comando help

wsl --help

Consulte una lista de las opciones y los comandos disponibles con WSL.

Ejecutar como usuario específico

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

Para ejecutar WSL como usuario especificado, reemplace <Username> por el nombre de un usuario que exista en la distribución de WSL.

Cambio del usuario predeterminado para una distribución

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

Cambie el usuario predeterminado para el inicio de sesión de su distribución. El usuario ya debe existir dentro de la distribución para convertirse en el usuario predeterminado.

Por ejemplo: ubuntu config --default-user johndoe cambiaría el usuario predeterminado de la distribución de Ubuntu al usuario "johndoe".

Nota

Si tiene problemas para averiguar el nombre de la distribución, use el comando wsl -l.

Advertencia

Este comando no funcionará para las distribuciones importadas, ya que estas distribuciones no tienen un iniciador ejecutable. En su lugar, puede cambiar el usuario predeterminado para las distribuciones importadas mediante el archivo /etc/wsl.conf. Consulte las opciones de montaje automático en el documento Opciones de configuración avanzada.

Apagar

wsl --shutdown

Finaliza inmediatamente todas las distribuciones en ejecución y la máquina virtual de utilidad ligera de WSL 2. Este comando puede ser necesario en instancias que requieren que reinicie el entorno de máquina virtual de WSL 2, como cambiar los límites de uso de memoria o realizar un cambio en el archivo .wslconfig.

Terminate

wsl --terminate <Distribution Name>

Para finalizar la distribución especificada o detener su ejecución, reemplace <Distribution Name> por el nombre de la distribución de destino.

Exportar la distribución a un archivo TAR

wsl --export <Distribution Name> <FileName>

Exporta la distribución a un archivo tar. El nombre de archivo puede ser - para la salida estándar.

Importar una nueva distribución

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

Importa el archivo tar especificado como una nueva distribución. El nombre de archivo puede ser - para la entrada estándar. La opción --version también se puede usar con este comando para designar si la distribución importada se ejecutará en WSL 1 o WSL 2.

Anular el registro de una distribución de Linux o desinstalarla

Aunque las distribuciones de Linux se pueden instalar a través de Microsoft Store, no se pueden desinstalar a través de Store.

Para anular el registro y desinstalar una distribución de WSL:

wsl --unregister <DistributionName>

Al reemplazar <DistributionName> por el nombre de la distribución de Linux de destino, se anulará el registro de esa distribución de WSL para que se pueda reinstalar o limpiar. Precaución: Una vez que se ha anulado el registro, todos los datos, la configuración y el software asociados a esa distribución se perderán de manera permanente. Si se vuelve a instalar desde Store, se instalará una copia limpia de la distribución. Por ejemplo, wsl --unregister Ubuntu quitaría Ubuntu de las distribuciones disponibles en WSL. Al ejecutar wsl --list, se verá que ya no aparece en la lista.

También puede desinstalar la aplicación de distribución de Linux en la máquina Windows igual que cualquier otra aplicación de Store. Para reinstalar, busque la distribución en Microsoft Store y seleccione "Iniciar".

Montar un disco o dispositivo

wsl --mount <DiskPath>

Conecte y monte un disco físico en todas las distribuciones de WSL 2. Para ello, reemplace <DiskPath> por la ruta de acceso del directorio o el archivo donde se encuentra el disco. Consulte Montaje de un disco Linux en WSL 2. Las opciones son:

  • wsl --mount --bare: conecte el disco a WSL 2, pero no lo monte.
  • wsl --mount --type <Filesystem>: tipo de sistema de archivos que se va a usar al montar un disco. Si no se especifica, se establece de manera predeterminada en ext4. Este comando también se puede especificar como wsl --mount -t <Filesystem>. Puede detectar el tipo de sistema de archivos mediante el comando blkid <BlockDevice> como, por ejemplo: blkid <dev/sdb1>.
  • wsl --mount --partition <Partition Number>: número de índice de la partición que se va a montar. Si no se especifica, se establece de forma predeterminada en todo el disco.
  • wsl --mount --options <MountOptions>: hay algunas opciones específicas del sistema de archivos que se pueden incluir al montar un disco. Por ejemplo, opciones de montaje ext4, como wsl --mount -o "data-ordered" o wsl --mount -o "data=writeback. Sin embargo, en este momento solo se admiten las opciones específicas del sistema de archivos. No se admiten opciones genéricas, como ro, rw o noatime.
  • wsl --unmount <DiskPath>: desmonte y desconecte el disco de todas las distribuciones de WSL 2. Si no se incluye <DiskPath>, este comando desmontará y desconectará todos los discos montados.

Nota:

Si ejecuta un proceso de 32 bits para acceder a wsl.exe (una herramienta de 64 bits), puede que tenga que ejecutar el comando de la siguiente manera: C:\Windows\Sysnative\wsl.exe --command.

Comandos de WSL en desuso

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

Estos comandos eran la sintaxis wsl original para configurar las distribuciones de Linux instaladas con WSL, pero se han reemplazado por la sintaxis del comando wsl o wsl.exe.