Skip to content

Compatibilidade de versões do WSL ​

Se a sua versão do WSL for detectada fora do intervalo suportado pelo WSL Dashboard, o aplicativo exibirá um aviso. A execução em uma versão não suportada pode causar dois problemas:

  • Há risco para os seus dados: operações como compactar, VHD esparso, clonar, importar e exportar leem e gravam diretamente nos discos virtuais, o que pode causar corrupção de dados em uma versão não suportada.
  • Alguns recursos podem não funcionar corretamente: por exemplo, itens de configuração como [boot], [gpu] e [time] não são suportados em versões mais antigas.

Atualize o WSL para uma versão suportada antes de usar o conjunto completo de recursos.

1. Verificar a versão atual ​

Abra o PowerShell como administrador e execute:

powershell
wsl --version

Anote o valor da linha «WSL Version». Se o comando retornar erro ou essa linha estiver ausente, você está usando a versão antiga do WSL incluída no Windows — vá diretamente para as etapas de atualização abaixo.

2. Como atualizar ​

Opção 1: Baixar o instalador diretamente (recomendado — mais rápido e confiável) ​

Primeiro, acesse a página oficial de versões:

https://github.com/microsoft/WSL/releases/latest

Escolha a versão mais recente (ou uma atualmente suportada), baixe wsl.<version>.x64.msi (em dispositivos ARM64, escolha arm64) e clique duas vezes para instalar.

Requer Windows 10 21H2 ou posterior, com o recurso «Plataforma de Máquina Virtual» ativado em «Ativar ou desativar recursos do Windows».

Opção 2: Atualizar pela linha de comando ​

Abra o PowerShell como administrador e execute:

powershell
wsl --update

Se a Microsoft Store não estiver disponível, force o download:

powershell
wsl --update --web-download

3. Após a atualização ​

powershell
wsl --shutdown
wsl --version

Depois de confirmar que a versão está dentro do intervalo suportado, encerre completamente o WSL Dashboard e inicie-o novamente; o aviso desaparecerá.