Comandos básicos para WSL

Os comandos WSL abaixo são listados em um formato compatível com o PowerShell ou o Prompt de Comando do Windows. Para executar esses comandos de uma linha de comando de distribuição Bash/Linux, você deve substituir wsl por wsl.exe. Para obter uma lista completa de comandos, execute wsl --help. Se você ainda não fez isso, recomendamos atualizar para a versão do WSL instalada da Microsoft Store para receber atualizações do WSL assim que elas estiverem disponíveis. (Saiba mais sobre como instalar o WSL via Microsoft Store.).

Instalar

wsl --install

Instale o WSL e a distribuição padrão do Ubuntu do Linux. Saiba mais. Você também pode usar esse comando para instalar distribuições adicionais do Linux executando wsl --install <Distribution Name>. Para obter uma lista válida de nomes de distribuição, execute wsl --list --online.

As opções incluem:

• --distribution: especifique a distribuição do Linux a ser instalada. Você pode encontrar distribuições disponíveis executando wsl --list --online.
• --no-launch: instale a distribuição do Linux, mas não a inicie automaticamente.
• --web-download: instale de uma fonte online em vez de usar a Microsoft Store.

Quando o WSL não está instalado, as alternativas incluem:

• --inbox: instala o WSL usando o componente do Windows em vez de usar a Microsoft Store. (As atualizações do WSL serão recebidas por meio de atualizações do Windows, em vez de enviadas por push conforme disponível por meio da loja).
• --enable-wsl1: habilita o WSL 1 durante a instalação da versão da Microsoft Store do WSL habilitando também o componente opcional "Subsistema do Windows para Linux".
• --no-distribution: não instale uma distribuição ao instalar o WSL.

Nota

Se você executar o WSL no Windows 10 ou em uma versão mais antiga, talvez seja necessário incluir o sinalizador -d com o comando --install para especificar uma distribuição: wsl --install -d <distribution name>.

Listar distribuições disponíveis do Linux

wsl --list --online

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

Listar distribuições do Linux instaladas

wsl --list --verbose

Consulte uma lista das distribuições do Linux instaladas em seu computador Windows, incluindo o estado (se a distribuição está em execução ou interrompida) e a versão do WSL executando 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 de lista incluem: --all listar todas as distribuições, --running listar apenas distribuições que estão em execução no momento ou --quiet para mostrar apenas os nomes de distribuição.

Definir a 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. O WSL 2 só está disponível no Windows 11 ou Windows 10, versão 1903, Build 18362 ou posterior.

Aviso

Alternar entre o WSL 1 e o WSL 2 pode ser demorado e resultar em falhas devido às diferenças entre as duas arquiteturas. Para distribuições com projetos grandes, recomendamos fazer backup de arquivos antes de tentar uma conversão.

Definir a versão padrão do WSL

wsl --set-default-version <Version>

Para definir uma versão padrão do WSL 1 ou WSL 2, substitua <Version> pelo número 1 ou 2. Por exemplo, wsl --set-default-version 2. O número representa a versão do WSL a ser usada como padrão para novas instalações de distribuição do Linux. Comparação entre o WSL 1 e o WSL 2. O WSL 2 só está disponível no Windows 11 ou Windows 10, versão 1903, Build 18362 ou posterior.

Definir a distribuição padrão do Linux

wsl --set-default <Distribution Name>

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

Iniciar o WSL na casa do usuário

wsl ~

O ~ pode ser usado com o 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 do PowerShell ou do 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 distribuição preferencial do Linux (ou seja. Debian) e <User Name> com o nome de um usuário existente (ou seja, raiz). Se o usuário não existir na distribuição WSL, você receberá um erro. Para imprimir o nome de usuário atual, use o comando whoami.

Atualizar WSL

wsl --update

Atualize sua versão do WSL para a versão mais recente. As opções incluem:

• --web-download: baixe a atualização mais recente do GitHub em vez da Microsoft Store.

Verificar o status do WSL

wsl --status

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

Verificar a versão do WSL

wsl --version

Verifique as informações de versão sobre o WSL e seus componentes.

Comando de ajuda

wsl --help

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

Executar como um usuário específico

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 o logon de distribuição. O usuário já precisa 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 da distribuição do Ubuntu para o usuário "johndoe".

Nota

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

Aviso

Esse comando não funcionará para 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.

Desligamento

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 alterar os limites de uso de memória ou fazer uma alteração no arquivo .wslconfig .

Terminar

wsl --terminate <Distribution Name>

Para encerrar a distribuição especificada ou impedi-la de ser executada, substitua <Distribution Name> pelo nome da distribuição de destino.

Identificar o endereço IP

• wsl hostname -I: retorna o endereço IP da distribuição do Linux instalada por meio do WSL 2 (o endereço da VM do WSL 2)
• ip route show | grep -i default | awk '{ print $3}': retorna o endereço IP do computador Windows, conforme visto do WSL 2 (a VM do WSL 2)

Para obter uma explicação mais detalhada, consulte Acessando aplicativos de rede com WSL: identificar o endereço IP.

Exportar uma distribuição

wsl --export <Distribution Name> <FileName>

Exporta um instantâneo da distribuição especificada como um novo arquivo de distribuição. Padrões para o formato tar. O nome do arquivo pode ser - para entrada padrão. As opções incluem:

• --vhd: especifica que a distribuição de exportação deve ser um arquivo .vhdx em vez de um arquivo tar (isso só tem suporte usando o WSL 2)

Importar uma distribuição

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

Importa o arquivo tar especificado como uma nova distribuição. O nome do arquivo pode ser - para entrada padrão. As opções incluem:

• --vhd: especifica que a distribuição de importação deve ser um arquivo .vhdx em vez de um arquivo tar (isso só tem suporte usando o WSL 2)
• --version <1/2>: especifica se a distribuição deve ser importada como uma distribuição WSL 1 ou WSL 2

Importar uma distribuição em vigor

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

Importa o arquivo .vhdx especificado como uma nova distribuição. O disco rígido virtual deve ser formatado no tipo de sistema de arquivos ext4.

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 do repositório.

Para cancelar o registro e desinstalar uma distribuição 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. Cuidado: Uma vez não registrado, todos os dados, configurações e software 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. Executar 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 qualquer outro aplicativo de 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 WSL2 substituindo <DiskPath> pelo diretório\caminho do arquivo em que o disco está localizado. Consulte Montar um disco Linux no WSL 2. As opções incluem:

• --vhd: especifica que <Disk> se refere a um disco rígido virtual.
• --name: montar o disco usando um nome personalizado para o ponto de montagem
• --bare: anexe o disco ao WSL2, mas não o monte.
• --type <Filesystem>: tipo de sistema de arquivos a ser usado ao montar um disco, se não for especificado, o padrão será ext4. Esse comando também pode ser inserido como: wsl --mount -t <Filesystem>. Você pode detectar o tipo de sistema de arquivos usando o comando: blkid <BlockDevice>, por exemplo: blkid <dev/sdb1>.
• --partition <Partition Number>: Número de índice da partição a ser montada; se não especificado, por padrão, monta-se todo o disco.
• --options <MountOptions>: há algumas opções específicas do sistema de arquivos que podem ser incluídas ao montar 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 opções específicas do sistema de arquivos têm suporte no momento. Opções genéricas, como ro, rwou noatime, não têm suporte.

Nota

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

Desmontar discos

wsl --unmount <DiskPath>

Desmonte um disco especificado no caminho do disco; se nenhum caminho de disco for fornecido, esse comando desmontará e desanexará TODOS os discos montados.

Comandos WSL obsoletos

wslconfig.exe [Argument] [Options]

bash [Options]

lxrun /[Argument]

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