31/07/2020 Instalar o WSL (Subsistema Windows para Linux) no Windows 10 | Microsoft Docs

Guia de instalação do Subsistema Windows

para Linux para Windows 10
12/05/2020 • 5 minutos para o fim da leitura •
Neste artigo
Instalar o Subsistema Windows para Linux
Atualizar para o WSL 2
Instalar a distribuição do Linux de sua escolha
Configurar uma nova distribuição
Definir a versão de distribuição para WSL 1 ou WSL 2
Como solucionar problemas de instalação

Instalar o Subsistema Windows para Linux

Antes de instalar as distribuições do Linux no Windows, você deverá habilitar o recurso
opcional "Subsistema do Windows para Linux".

Abra o PowerShell como administrador e execute:

PowerShell ＝ Copiar

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

Linux /all /norestart

Para instalar apenas o WSL 1, você deve reiniciar o computador e passar para Instalar a
distribuição do Linux de sua escolha, caso contrário, espere para reiniciar e passar para
a atualização para o WSL 2. Leia mais sobre a Comparação entre o WSL 2 e o WSL 1.

Atualizar para o WSL 2

Para atualizar para o WSL 2, você deve atender aos seguintes critérios:

Executar o Windows 10, atualizado para a versão 2004, Build 19041 ou

superiores.

Verifique sua versão do Windows selecionando a tecla do logotipo do Windows

+ R, digite winver, selecione OK. (Ou digite o comando ver no prompt de
comando do Windows). Faça a atualização para a última versão do Windows se o
build for anterior ao 19041. Obtenha o Assistente do Windows Update.

https://docs.microsoft.com/pt-br/windows/wsl/install-win10 1/7
31/07/2020 Instalar o WSL (Subsistema Windows para Linux) no Windows 10 | Microsoft Docs

Habilite o componente opcional "Plataforma de

máquina virtual"
Antes de instalar o WSL 2, você deve habilitar o recurso opcional "Plataforma de
Máquina Virtual".

Abra o PowerShell como administrador e execute:

PowerShell ＝ Copiar

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

/norestart

Reinicie o computador para concluir a instalação do WSL e a atualização para o WSL 2.

Definir o WSL 2 como sua versão padrão

Abra o PowerShell como administrador e execute este comando para definir o WSL 2
como a versão padrão ao instalar uma nova distribuição do Linux:

PowerShell ＝ Copiar

wsl --set-default-version 2

Você poderá ver esta mensagem depois de executar esse comando: WSL 2 requires an
update to its kernel component. For information please visit
https://aka.ms/wsl2kernel . Siga o link (https://aka.ms/wsl2kernel) e instale o MSI dessa
página em nossa documentação para instalar um kernel do Linux em seu computador
para o WSL 2 usar. Depois de instalar o kernel, execute o comando novamente e ele
deverá ser concluído com êxito sem mostrar a mensagem.

７ Observação

A atualização da WSL 1 para a WSL 2 pode levar vários minutos para ser concluída,
dependendo do tamanho da sua distribuição alvo. Se você estiver executando uma
instalação mais antiga (herdada) do WSL 1 da Atualização para Criadores ou da
Atualização de Aniversário do Windows 10, poderá encontrar um erro de
atualização. Siga estas instruções para desinstalar e remover as distribuições
herdadas.

Se wsl --set-default-version resultar como um comando inválido, insira wsl --

help . Se --set-default-version não está listado, isso significa que o sistema

https://docs.microsoft.com/pt-br/windows/wsl/install-win10 2/7
31/07/2020 Instalar o WSL (Subsistema Windows para Linux) no Windows 10 | Microsoft Docs

operacional não é compatível com ele, e você precisa atualizar para a versão 2004,
Build 19041 ou superior.

Instalar a distribuição do Linux de sua escolha

1. Abra a Microsoft Store e escolha sua distribuição do Linux favorita.

Os links a seguir abrirão a página da Microsoft Store para cada distribuição:

Ubuntu 16.04 LTS

Ubuntu 18.04 LTS
Ubuntu 20.04 LTS
OpenSUSE Leap 15.1
SUSE Linux Enterprise Server 12 SP5
SUSE Linux Enterprise Server 15 SP1
Kali Linux
Debian GNU/Linux
Fedora Remix para WSL
Pengwin
Pengwin Enterprise
Alpine WSL

2. Na página da distribuição, selecione "Obter".

https://docs.microsoft.com/pt-br/windows/wsl/install-win10 3/7
31/07/2020 Instalar o WSL (Subsistema Windows para Linux) no Windows 10 | Microsoft Docs

Configurar uma nova distribuição

Na primeira vez que você iniciar uma distribuição do Linux recém-instalada, uma janela
de console será aberta e será solicitado que você aguarde um ou dois minutos para que
os arquivos sejam descompactados e armazenados em seu PC. Todas as futuras
inicializações deverão levar menos de um segundo.

Em seguida, você precisará criar uma conta de usuário e uma senha para sua nova
distribuição do Linux.

https://docs.microsoft.com/pt-br/windows/wsl/install-win10 4/7
31/07/2020 Instalar o WSL (Subsistema Windows para Linux) no Windows 10 | Microsoft Docs

Definir a versão de distribuição para WSL 1 ou

WSL 2
Verifique a versão do WSL atribuída a cada uma das distribuições do Linux instaladas
abrindo a linha de comando do PowerShell e inserindo o comando (disponível somente
no Windows Build 19041 ou superiores): wsl -l -v

PowerShell ＝ Copiar

wsl --list --verbose

Para definir uma distribuição para ter suporte de qualquer versão do WSL, execute:

PowerShell ＝ Copiar

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

Assegure-se de substituir <distribution name> pelo nome real da sua distribuição e

<versionNumber> pelo número '1' ou '2'. Você pode retornar ao WSL 1 a qualquer
momento executando o mesmo comando acima, mas substituindo “2” por “1”.

Além disso, se quiser tornar o WSL 2 sua arquitetura padrão, você poderá fazê-lo com
este comando:

PowerShell ＝ Copiar

wsl --set-default-version 2
https://docs.microsoft.com/pt-br/windows/wsl/install-win10 5/7
31/07/2020 Instalar o WSL (Subsistema Windows para Linux) no Windows 10 | Microsoft Docs

Isso definirá a versão de qualquer nova distribuição instalada no WSL 2.

Como solucionar problemas de instalação

Veja abaixo erros relacionados e correções sugeridas. Consulte a página de solução de
problemas do WSL para ver outros erros comuns e suas soluções.

Falha na instalação com o erro 0x80070003

O Subsistema Windows para Linux é executado somente na unidade do sistema
(normalmente, a unidade C: ). Verifique se as distribuições estão armazenadas
na unidade do sistema:
Abra Configurações -> Armazenamento -> Mais Configurações de
Armazenamento: Altere onde o novo conteúdo é salvo

WslRegisterDistribution falhou com o erro 0x8007019e

O componente opcional do Subsistema Windows para Linux não está
habilitado:
Abra Painel de Controle -> Programas e Recursos -> Ativar ou Desativar
Recursos do Windows -> Selecione Subsistema do Windows para Linux ou
use o cmdlet PowerShell mencionado no início deste artigo.

Ocorreu falha na instalação com o erro 0x80070003 ou 0x80370102

Verifique se a virtualização está habilitada dentro do BIOS do seu computador.
As instruções para fazer isso variam de um computador para o outro e muito
provavelmente estarão sob opções relacionadas à CPU.

Erro ao tentar fazer upgrade: Invalid command line option: wsl --set-version
Ubuntu 2
Verifique se você tem o Subsistema do Windows para Linux habilitado e se está
usando o Windows, versão de Build 19041 ou superior. Para habilitar o WSL,
execute este comando em um prompt do PowerShell com privilégios de
administrador: Enable-WindowsOptionalFeature -Online -FeatureName
https://docs.microsoft.com/pt-br/windows/wsl/install-win10 6/7
31/07/2020 Instalar o WSL (Subsistema Windows para Linux) no Windows 10 | Microsoft Docs

Microsoft-Windows-Subsystem-Linux . Você pode encontrar as instruções de

instalação completas do WSL aqui.

A operação solicitada não pôde ser concluída devido a uma limitação do

sistema de disco virtual. Os arquivos do disco rígido virtual devem ser
descompactados e descriptografados e não devem ser esparsos.
Para obter informações atualizadas, verifique o thread 4103 do GitHub no WSL
em que esse problema está sendo acompanhado.

O termo 'wsl' não é reconhecido como nome de um cmdlet, uma função, um

arquivo de script ou um programa operável.
Verifique se o componente opcional do Subsistema do Windows para Linux
está instalado. Além disso, se você estiver usando um dispositivo ARM64 e
executar esse comando no PowerShell, receberá esse erro. Em vez disso,
execute wsl.exe no PowerShell Core ou no prompt de comando.

Esta página é útil?

 Yes  No

https://docs.microsoft.com/pt-br/windows/wsl/install-win10 7/7