Guía de instalación del Subsistema de Windows para Linux para Windows 10Windows Subsystem for Linux Installation Guide for Windows 10

Instalar el Subsistema de Windows para LinuxInstall the Windows Subsystem for Linux

Antes de instalar distribuciones de Linux en Windows, debes habilitar la característica opcional "Subsistema de Windows para Linux".Before installing any Linux distributions on Windows, you must enable the "Windows Subsystem for Linux" optional feature.

Abre PowerShell como administrador y ejecuta:Open PowerShell as Administrator and run:

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

Para instalar solo WSL 1, debes reiniciar la máquina ahora y pasar a la sección Instalación de la distribución de Linux que quieras. De lo contrario, espera a que se reinicie y avanza para actualizar a WSL 2.To only install WSL 1, you should now restart your machine and move on to Install your Linux distribution of choice, otherwise wait to restart and move on to update to WSL 2. Obtén más información sobre la Comparación de WSL 2 con WSL 1.Read more about Comparing WSL 2 and WSL 1.

Actualización a WSL 2Update to WSL 2

Para actualizar a WSL 2, debe cumplir los siguientes criterios:To update to WSL 2, you must meet the following criteria:

Habilitación del componente opcional "Plataforma de máquina virtual"Enable the 'Virtual Machine Platform' optional component

Antes de instalar WSL 2, tienes que habilitar la característica opcional "Plataforma de máquina virtual".Before installing WSL 2, you must enable the "Virtual Machine Platform" optional feature.

Abre PowerShell como administrador y ejecuta:Open PowerShell as Administrator and run:

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Reinicia la máquina para completar la instalación de WSL y la actualización a WSL 2.Restart your machine to complete the WSL install and update to WSL 2.

Definición de WSL 2 como versión predeterminadaSet WSL 2 as your default version

Abra PowerShell como Administrador y ejecute este comando para establecer WSL 2 como versión predeterminada al instalar una nueva distribución de Linux:Open PowerShell as Administrator and run this command to set WSL 2 as the default version when installing a new Linux distribution:

wsl --set-default-version 2

Es posible que vea este mensaje después de ejecutar el comando: WSL 2 requires an update to its kernel component. For information please visit https://aka.ms/wsl2kernel.You might see this message after running that command: WSL 2 requires an update to its kernel component. For information please visit https://aka.ms/wsl2kernel. Siga el vínculo (https://aka.ms/wsl2kernel) e instale MSI desde esa página en nuestra documentación para instalar un kernel de Linux en la máquina para que lo use WSL 2.Please follow the link (https://aka.ms/wsl2kernel) and install the MSI from that page on our documentation to install a Linux kernel on your machine for WSL 2 to use. Una vez instalado el kernel, vuelva a ejecutar el comando, que debería completarse correctamente sin mostrar el mensaje.Once you have the kernel installed, please run the command again and it should complete successfully without showing the message.

Nota

La actualización de WSL 1 a WSL 2 puede tardar varios minutos en completarse, en función del tamaño de la distribución de destino.The update from WSL 1 to WSL 2 may take several minutes to complete depending on the size of your targeted distribution. Si ejecuta una instalación anterior (heredada) de WSL 1 de la Actualización de aniversario de Windows 10 o de Creators Update, es posible que se produzca un error de actualización.If you are running an older (legacy) installation of WSL 1 from Windows 10 Anniversary Update or Creators Update, you may encounter an update error. Siga estas instrucciones para desinstalar y quitar las distribuciones heredadas.Follow these instructions to uninstall and remove any legacy distributions.

Si wsl --set-default-version resulta en un comando no válido, especifique wsl --help.If wsl --set-default-version results as an invalid command, enter wsl --help. Si --set-default-version no aparece, significa que el sistema operativo no lo admite y debe actualizar a la versión 2004, compilación 19041 o posterior.If the --set-default-version is not listed, it means that your OS doesn't support it and you need to update to version 2004, Build 19041 or higher.

Instalación de la distribución de Linux que quierasInstall your Linux distribution of choice

  1. Abre Microsoft Store y selecciona tu distribución de Linux favorita.Open the Microsoft Store and select your favorite Linux distribution.

    Vista de las distribuciones de Linux en Microsoft Store

    En los vínculos siguientes se abrirá la página de Microsoft Store para cada distribución:The following links will open the Microsoft store page for each distribution:

  2. En la página de la distribución, selecciona "Obtener".From the distribution's page, select "Get".

    Distribuciones de Linux en Microsoft Store

Configuración de una nueva distribuciónSet up a new distribution

La primera vez que inicies una distribución de Linux recién instalada, se abrirá una ventana de la consola y se te pedirá que esperes un minuto o dos para que los archivos se descompriman y se almacenen en tu equipo.The first time you launch a newly installed Linux distribution, a console window will open and you'll be asked to wait for a minute or two for files to de-compress and be stored on your PC. Todos los inicios posteriores deberían tardar menos de un segundo en completarse.All future launches should take less than a second.

Tendrás que crear una cuenta de usuario y una contraseña para la nueva distribución de Linux.You will then need to create a user account and password for your new Linux distribution.

Desempaquetado de Ubuntu en la consola de Windows

Definición de la versión de la distribución en WSL 1 o WSL 2Set your distribution version to WSL 1 or WSL 2

Para comprobar la versión de WSL asignada a cada una de las distribuciones de Linux que tienes instaladas, abre la línea de comandos de PowerShell y escribe el comando (solo disponible en Windows, compilación 19041 o posterior) wsl -l -v.You 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

Para establecer que una distribución esté respaldada por una de las dos versiones de WSL, ejecuta:To set a distribution to be backed by either version of WSL please run:

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

Asegúrate de reemplazar <distribution name> por el nombre real de tu distribución, y <versionNumber> por el número "1" o "2".Make sure to replace <distribution name> with the actual name of your distribution and <versionNumber> with the number '1' or '2'. Puedes volver a cambiar a WSL 1 en cualquier momento; para ello, ejecuta el mismo comando que antes, pero reemplaza "2" por "1".You can change back to WSL 1 at anytime by running the same command as above but replacing the '2' with a '1'.

Además, si quieres que WSL 2 sea la arquitectura predeterminada, puedes hacerlo con este comando:Additionally, if you want to make WSL 2 your default architecture you can do so with this command:

wsl --set-default-version 2

De este modo, se establecerá la versión de cualquier nueva distribución instalada en WSL 2.This will set the version of any new distribution installed to WSL 2.

Solución de problemas de instalaciónTroubleshooting installation

A continuación, se muestran errores relacionados y las correcciones sugeridas.Below are related errors and suggested fixes. Consulta la página de solución de problemas de WSL para ver otros errores generales y sus soluciones.Refer to the WSL troubleshooting page for other common errors and their solutions.

  • Error 0x80070003 en la instalaciónInstallation failed with error 0x80070003

    • El Subsistema de Windows para Linux solo se ejecuta en la unidad del sistema (normalmente se trata de la unidad C:).The Windows Subsystem for Linux only runs on your system drive (usually this is your C: drive). Asegúrate de que las distribuciones estén almacenadas en la unidad del sistema:Make sure that distributions are stored on your system drive:
    • Abre Configuración -> Almacenamiento -> Más opciones de almacenamiento: Cambia el lugar donde se guarda el nuevo contenido Imagen de la configuración del sistema para instalar aplicaciones en la unidad C:Open Settings -> Storage -> More Storage Settings: Change where new content is saved Picture of system settings to install apps on C: drive
  • Error 0x8007019e de WslRegisterDistributionWslRegisterDistribution failed with error 0x8007019e

    • El componente opcional del Subsistema de Windows para Linux no está habilitado:The Windows Subsystem for Linux optional component is not enabled:
    • Abre el Panel de control -> Programas y características -> Activa o desactiva la característica de Windows -> Selecciona Subsistema de Windows para Linux o usa el cmdlet de PowerShell mencionado al comienzo de este artículo.Open Control Panel -> Programs and Features -> Turn Windows Feature on or off -> Check Windows Subsystem for Linux or using the PowerShell cmdlet mentioned at the beginning of this article.
  • Error en la instalación 0x80070003 o 0x80370102Installation failed with error 0x80070003 or error 0x80370102

    • Asegúrate de que la virtualización está habilitada dentro del BIOS del equipo.Please make sure that virtualization is enabled inside of your computer's BIOS. Las instrucciones sobre cómo hacerlo variarán de un equipo a otro y lo más probable es que esta característica esté en opciones relacionadas con la CPU.The instructions on how to do this will vary from computer to computer, and will most likely be under CPU related options.
  • Error al intentar actualizar: Invalid command line option: wsl --set-version Ubuntu 2Error when trying to upgrade: Invalid command line option: wsl --set-version Ubuntu 2

    • Asegúrate de que tienes el Subsistema de Windows para Linux habilitado y de que estás usando la compilación 19041 de Windows o posterior.Please make sure that you have the Windows Subsystem for Linux enabled, and that you're using Windows Build version 19041 or higher. Para habilitar WSL, ejecute este comando en un símbolo del sistema de PowerShell con privilegios de administrador: Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux.To enable WSL run this command in a PowerShell prompt with admin privileges: Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux. Puedes encontrar las instrucciones de instalación de WSL completas aquí.You can find the full WSL install instructions here.
  • La operación solicitada no se pudo completar debido a una limitación del sistema de disco virtual. Los archivos de disco duro virtual deben estar sin comprimir y sin cifrar y no deben ser dispersos.The requested operation could not be completed due to a virtual disk system limitation. Virtual hard disk files must be uncompressed and unencrypted and must not be sparse.

  • El término 'wsl' no se reconoce como nombre de cmdlet, función, archivo de script o programa ejecutable.The term 'wsl' is not recognized as the name of a cmdlet, function, script file, or operable program.