Comandos básicos para o WSL

Os comandos do WSL abaixo são listados em um formato compatível com o Prompt de Comando do Windows ou PowerShell. Para executar esses comandos em uma linha de comando Bash/de distribuição do Linux, você deve substituir wsl por wsl.exe.

Instalar

wsl --install

Instale o WSL e a distribuição Ubuntu do Linux. Saiba mais.

Instalar uma distribuição do Linux específica

wsl --install --distribution <Distribution Name>

Para designar uma distribuição do Linux diferente da padrão (Ubuntu) para instalação, substitua <Distribution Name> pelo nome da distribuição. Esse comando também pode ser inserido como: wsl -d <Distribution Name>.

Listar as distribuições do Linux disponíveis

wsl --list --online

Veja uma lista das distribuições do Linux disponíveis na loja online. Esse comando também pode ser inserido como: wsl -l -o.

Listar distribuições do Linux instaladas

wsl --list --verbose

Veja uma lista das distribuições do Linux instaladas no seu computador Windows, incluindo o estado (se a distribuição está em execução ou parada) e a versão do WSL que executa a distribuição (WSL 1 ou WSL 2). Comparação entre o WSL 1 e o WSL 2. Esse comando também pode ser inserido como: wsl -l -v. Opções adicionais que podem ser usadas com o comando listar incluem: --all para listar todas as distribuições, --running para listar somente as distribuições que estão em execução no momento ou --quiet para mostrar somente nomes de distribuição.

Definir versão do WSL como 1 ou 2

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

Para designar a versão do WSL (1 ou 2) em que uma distribuição do Linux está em execução, substitua <distribution name> pelo nome da distribuição e substitua <versionNumber> por 1 ou 2. Comparação entre o WSL 1 e o WSL 2.

Definir versão padrão do WSL

wsl --set-default-version <Version>

Para definir uma versão padrão do WSL 1 ou do WSL 2, substituindo <Version> pelo número 1 ou 2 para representar para qual versão do WSL você deseja que a instalação seja padronizada em novas instalações de distribuição do Linux. Por exemplo, wsl --set-default-version 2. Comparação entre o WSL 1 e o WSL 2.

Definir distribuição padrão do Linux

wsl --set-default <Distribution Name>

Para definir a distribuição padrão do Linux que os comandos do WSL usarão para executar, substitua <Distribution Name> pelo nome da sua distribuição preferida do Linux.

Alterar o diretório para a página inicial

wsl ~

O ~ pode ser usado com wsl para iniciar no diretório base do usuário. Para ir de qualquer diretório de volta para a base de dentro de um prompt de comando do WSL, você pode usar este comando: cd ~.

Executar uma distribuição específica do Linux no PowerShell ou no CMD

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

Para executar uma distribuição específica do Linux com um usuário específico, substitua <Distribution Name> pelo nome da sua distribuição preferida do Linux (por exemplo Debian) e <User Name> pelo nome de um usuário existente (ou seja, raiz). Se o usuário não existir na distribuição do WSL, você receberá um erro. Para imprimir o nome de usuário atual, use o comando whoami.

Atualizar o WSL

wsl --update

Atualize manualmente a versão do kernel do Linux do WSL. Você também pode usar o comando: wsl --update rollback para reverter para uma versão anterior do kernel do Linux do WSL.

Verificar o status do WSL

wsl --status

Veja informações gerais sobre a configuração do WSL, como tipo de distribuição padrão, a distribuição padrão e a versão do kernel.

Comando Help

wsl --help

Veja uma lista de opções e comandos disponíveis com o WSL.

Execute como um usuário específico

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

Para executar o WSL como um usuário especificado, substitua <Username> pelo nome de um usuário que existe na distribuição do WSL.

Alterar o usuário padrão para uma distribuição

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

Altere o usuário padrão para seu logon de distribuição. O usuário já deve existir dentro da distribuição para se tornar o usuário padrão.

Por exemplo: ubuntu config --default-user johndoe alteraria o usuário padrão para a distribuição do Ubuntu para o usuário "davibarros".

Observação

Se você estiver tendo problemas para descobrir o nome da sua distribuição, use o comando wsl -l.

Aviso

Esse comando não funcionará em distribuições importadas, pois essas distribuições não têm um inicializador executável. Em vez disso, você pode alterar o usuário padrão para distribuições importadas usando o arquivo /etc/wsl.conf. Confira as opções de Montagem Automática no documento Definição de configurações avançadas.

Shutdown

wsl --shutdown

Encerra imediatamente todas as distribuições em execução e a máquina virtual do utilitário leve do WSL 2. Esse comando pode ser necessário em instâncias que exigem que você reinicie o ambiente de máquina virtual do WSL 2, como na alteração dos limites de uso de memória ou ao fazer uma alteração no arquivo .wslconfig.

Terminate

wsl --terminate <Distribution Name>

Para encerrar a distribuição especificada ou impedir que ela seja executada, substitua <Distribution Name> pelo nome da distribuição de destino.

Exportar uma distribuição para um arquivo TAR

wsl --export <Distribution Name> <FileName>

Exporta a distribuição para um arquivo tar. O nome de arquivo pode ser "-" para a saída padrão.

Importar uma nova distribuição

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

Importa o arquivo tar especificado como uma nova distribuição. O nome de arquivo pode ser "-" para a entrada padrão. A opção --version também pode ser usada com este comando para designar se a distribuição importada será executada no WSL 1 ou WSL 2.

Cancelar o registro ou desinstalar uma distribuição do Linux

Embora as distribuições do Linux possam ser instaladas por meio da Microsoft Store, elas não podem ser desinstaladas por meio da loja.

Para cancelar o registro e desinstalar uma distribuição do WSL:

wsl --unregister <DistributionName>

Substituir <DistributionName> pelo nome da distribuição do Linux de destino cancelará o registro dessa distribuição do WSL para que ela possa ser reinstalada ou limpa. Atenção: após o cancelamento do registro, todos os dados, configurações e softwares associados a essa distribuição serão permanentemente perdidos. A reinstalação pela loja instalará uma cópia limpa da distribuição. Por exemplo, wsl --unregister Ubuntu removeria o Ubuntu das distribuições disponíveis no WSL. A execução de wsl --list revelará que ele não está mais listado.

Você também pode desinstalar o aplicativo de distribuição do Linux em seu computador Windows assim como faz com qualquer outro aplicativo do repositório. Para reinstalar, localize a distribuição na Microsoft Store e selecione "Iniciar".

Montar um disco ou dispositivo

wsl --mount <DiskPath>

Anexe e monte um disco físico em todas as distribuições do WSL2 substituindo <DiskPath> pelo caminho diretório\arquivo em que o disco está localizado. Confira montar um disco do Linux no WSL 2. As opções incluem:

  • wsl --mount --bare: anexar o disco ao WSL2, mas não o montar.
  • wsl --mount --type <Filesystem>: tipo do sistema de arquivos a ser usado ao montar um disco. Caso não seja especificado, o padrão será ext4. Esse comando também pode ser inserido como: wsl --mount -t <Filesystem>. Você pode detectar o tipo do sistema de arquivos usando o comando: blkid <BlockDevice>, por exemplo: blkid <dev/sdb1>.
  • wsl --mount --partition <Partition Number>: número de índice da partição a ser montada; se não for especificado, o padrão será o disco inteiro.
  • wsl --mount --options <MountOptions>: há algumas opções específicas do sistema de arquivos que podem ser incluídas durante a montagem de um disco. Por exemplo, opções de montagem do ext4 como wsl --mount -o "data-ordered" ou wsl --mount -o "data=writeback. No entanto, somente as opções específicas do sistema de arquivos têm suporte no momento. Não há suporte para opções genéricas, como ro, rw ou noatime.
  • wsl --unmount <DiskPath>: desmonte e desanexe o disco de todas as distribuições do WSL 2. Se o <DiskPath> não estiver incluído, esse comando desmontará e desanexará TODOS os discos montados.

Observação

Se você estiver executando um processo de 32 bits para acessar o wsl.exe (uma ferramenta de 64 bits), talvez seja necessário executar o comando da seguinte maneira: C:\Windows\Sysnative\wsl.exe --command.

Comandos do WSL preteridos

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

Esses comandos eram a sintaxe wsl original para configurar as distribuições do Linux instaladas com o WSL, mas foram substituídas pela sintaxe de comando wsl ou wsl.exe.