Comandos básicos para WSL

Los siguientes comandos de WSL se muestran en un formato compatible con PowerShell y el símbolo del sistema de Windows. Para ejecutar estos comandos desde una línea de comandos de una distribución de Linux con Bash, debe reemplazar wsl por wsl.exe. Para obtener una lista completa de comandos, ejecute wsl --help. Si aún no lo has hecho, te recomendamos actualizar a la versión de WSL instalada desde Microsoft Store para recibir actualizaciones de WSL tan pronto como estén disponibles. (Obtenga más información sobre cómo instalar WSL a través de Microsoft Store.

Instalar

wsl --install

Instale WSL y la distribución predeterminada de Ubuntu de Linux. Más información. También puede usar este comando para instalar distribuciones de Linux adicionales mediante la ejecución wsl --install <Distribution Name>de . Para obtener una lista válida de nombres de distribución, ejecute wsl --list --online.

Entre las opciones se incluyen:

• --distribution: especifique la distribución de Linux que se va a instalar. Puede encontrar distribuciones disponibles ejecutando wsl --list --online.
• --no-launch: instale la distribución de Linux, pero no la inicie automáticamente.
• --web-download: instale desde un origen en línea en lugar de usar Microsoft Store.

Cuando WSL no está instalado las opciones incluyen:

• --inbox: instala WSL con el componente de Windows en lugar de usar Microsoft Store. (Las actualizaciones de WSL se recibirán a través de las actualizaciones de Windows, en lugar de insertarlas como disponibles a través de la tienda).
• --enable-wsl1: habilita WSL 1 durante la instalación de la versión de Microsoft Store de WSL habilitando también el componente opcional "Subsistema de Windows para Linux".
• --no-distribution: no instale una distribución al instalar WSL.

Nota:

Si ejecuta WSL en Windows 10 o una versión anterior, es posible que tenga que incluir la -d bandera con el --install comando para especificar una distribución: wsl --install -d <distribution name>.

Enumerar 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 escribir como: wsl -l -o.

Enumeración de distribuciones de Linux instaladas

wsl --list --verbose

Vea 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 y WSL 2. Este comando también se puede escribir 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 distribución.

Establezca 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 reemplace <versionNumber> por 1 o 2. Comparación de WSL 1 y WSL 2. WSL 2 solo está disponible en Windows 11 o Windows 10, versión 1903, compilación 18362 o posterior.

Advertencia

El cambio entre WSL 1 y WSL 2 puede llevar mucho tiempo y provocar errores debido a las diferencias entre las dos arquitecturas. En el caso de las distribuciones con proyectos grandes, se recomienda realizar copias de seguridad de archivos antes de intentar una conversión.

Establecimiento de la versión predeterminada de WSL

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. Por ejemplo: wsl --set-default-version 2. El número representa la versión de WSL a la que se va a establecer de forma predeterminada para las nuevas instalaciones de distribución de Linux. Comparación de WSL 1 y WSL 2. WSL 2 solo está disponible en Windows 11 o Windows 10, versión 1903, compilación 18362 o posterior.

Establecimiento de la distribución predeterminada de Linux

wsl --set-default <Distribution Name>

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

Iniciar WSL en el directorio personal del usuario

wsl ~

~ se puede usar con wsl para comenzar en el directorio de inicio del usuario. Para volver a tu directorio raíz desde cualquier otro directorio usando un símbolo del sistema en WSL, puedes usar el comando: cd ~.

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

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

Para ejecutar una distribución específica de Linux con un usuario específico, reemplace por <Distribution Name> el nombre de la distribución de Linux preferida (es decir, Debian) y <User Name> con el nombre de un usuario existente (es decir, 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 la versión de WSL a la versión más reciente. Entre las opciones se incluyen:

• --web-download: descargue la actualización más reciente de GitHub en lugar de Microsoft Store.

Verificar estado de WSL

wsl --status

Consulte 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.

Comprobar versión de WSL

wsl --version

Verifique la información de versión sobre WSL y sus componentes.

Comando help

wsl --help

Consulte una lista de opciones y comandos disponibles con WSL.

Ejecutar como usuario específico

wsl --user <Username>

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

Cambiar el usuario predeterminado de una distribución

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

Cambie el usuario predeterminado para el inicio de sesión de 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 para 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 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 /etc/wsl.conf archivo . Consulte las opciones de montaje automático en el documento Configuración de configuración avanzada .

apagado

wsl --shutdown

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

Baja

wsl --terminate <Distribution Name>

Para finalizar la distribución especificada, o impedir que se ejecute, reemplace por <Distribution Name> el nombre de la distribución de destino.

Identificación de la dirección IP

• wsl hostname -I: devuelve la dirección IP de la distribución de Linux instalada a través de WSL 2 (la dirección de máquina virtual WSL 2)
• ip route show | grep -i default | awk '{ print $3}': devuelve la dirección IP de la máquina Windows como se ve en WSL 2 (la máquina virtual WSL 2)

Para obtener una explicación más detallada, consulte Acceso a aplicaciones de red con WSL: Identificación de la dirección IP.

Exportación de una distribución

wsl --export <Distribution Name> <FileName>

Exporta una instantánea de la distribución especificada como un nuevo archivo de distribución. Por defecto, utiliza el formato tar. El nombre de archivo puede ser - para la entrada estándar. Entre las opciones se incluyen:

• --vhd: especifica que la distribución de exportación debe ser un archivo .vhdx en lugar de un archivo tar (esto solo se admite mediante WSL 2)

Importación de una 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. Entre las opciones se incluyen:

• --vhd: especifica que la distribución de importación debe ser un archivo .vhdx en lugar de un archivo tar (esto solo se admite mediante WSL 2)
• --version <1/2>: especifica si se va a importar la distribución como una distribución WSL 1 o WSL 2.

Importación de una distribución en contexto

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

Importa el archivo .vhdx especificado como una nueva distribución. El disco duro virtual debe tener formato en el tipo de sistema de archivos ext4.

Anulación del registro o desinstalación de una distribución de Linux

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

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 volver a instalar o limpiar. Cautela: Una vez anulado el registro, todos los datos, la configuración y el software asociados a esa distribución se perderán permanentemente. La reinstalación desde la tienda instalará una copia limpia de la distribución. Por ejemplo, wsl --unregister Ubuntu quitaría Ubuntu de las distribuciones disponibles en WSL. La ejecución wsl --list revelará 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 la tienda. Para reinstalar, busque la distribución en Microsoft Store y seleccione "Iniciar".

Montaje de un disco o dispositivo

wsl --mount <DiskPath>

Conecte y monte un disco físico en todas las distribuciones de WSL2 reemplazando <DiskPath> por la ruta del directorio o archivo donde se encuentra el disco. Consulte Montaje de un disco Linux en WSL 2. Entre las opciones se incluyen:

• --vhd: especifica que <Disk> hace referencia a un disco duro virtual.
• --name: monte el disco con un nombre personalizado para el punto de montaje.
• --bare: conecte el disco a WSL2, pero no lo monte.
• --type <Filesystem>: tipo de sistema de archivos que se va a usar al montar un disco, si no se especifican valores predeterminados para ext4. Este comando también se puede escribir como: wsl --mount -t <Filesystem>. Puede detectar el tipo de sistema de archivos mediante el comando : blkid <BlockDevice>, por ejemplo: blkid <dev/sdb1>.
• --partition <Partition Number>: número de índice de la partición que se va a montar, si no se especifican valores predeterminados para todo el disco.
• --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 opciones específicas del sistema de archivos. No se admiten opciones genéricas, como ro, rwo noatime.

Nota:

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

Desmontar discos

wsl --unmount <DiskPath>

Desmontar un disco dado en la ruta de acceso del disco, y si no se da ninguna ruta de acceso de disco, este comando desmontará y desconectará todos los discos montados.

Comandos WSL obsoletos

wslconfig.exe [Argument] [Options]

bash [Options]

lxrun /[Argument]

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