Comandos básicos para WSL

Os comandos WSL abaixo estão listados em um formato suportado pelo PowerShell ou pelo Prompt de Comando do Windows. Para executar esses comandos a partir 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 ainda não o fez, recomendamos que atualize para a versão do WSL instalada através da Microsoft Store para receber atualizações do WSL assim que estiverem disponíveis. (Saiba mais sobre como instalar o WSL através da 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 este comando para instalar distribuições Linux adicionais 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 Linux a ser instalada. Você pode encontrar distribuições disponíveis executando wsl --list --online.
• --no-launch: Instale a distribuição Linux, mas não a inicie automaticamente.
• --web-download: Instale a partir de uma fonte online em vez de usar a Microsoft Store.
• --location: Especifique em que pasta gostaria de instalar a distribuição WSL.

Quando o WSL não está instalado, as opções incluem:

• --inbox: Instala o WSL usando o componente Windows em vez de usar a Microsoft Store. (as atualizações do WSL serão recebidas através das atualizações do Windows, em vez de serem disponibilizadas pela 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 Windows para Linux".
• --no-distribution: Não instale uma distribuição ao instalar o WSL.

Listar distribuições Linux disponíveis

wsl --list --online

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

Listar distribuições Linux instaladas

wsl --list --verbose

Veja uma lista das distribuições Linux instaladas em sua máquina Windows, incluindo o estado (se a distribuição está em execução ou parada) e a versão do WSL executando a distribuição (WSL 1 ou WSL 2). Comparando WSL 1 e WSL 2. Este comando também pode ser inserido como: wsl -l -v. As opções adicionais que podem ser usadas com o comando list incluem: --all listar todas as distribuições, --running listar apenas as distribuições que estão em execução no momento ou --quiet mostrar apenas nomes de distribuição.

Definir a versão 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 Linux está sendo executada, substitua <distribution name> pelo nome da distribuição e substitua <versionNumber> por 1 ou 2. Comparando WSL 1 e WSL 2. O WSL 2 só está disponível no Windows 11 ou Windows 10, Versão 1903, Build 18362 ou posterior.

Definir 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 padrão do WSL para novas instalações de distribuição Linux. Comparando WSL 1 e WSL 2. O WSL 2 só está disponível no Windows 11 ou Windows 10, Versão 1903, Build 18362 ou posterior.

Definir distribuição Linux padrão

wsl --set-default <Distribution Name>

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

Iniciar o WSL no diretório pessoal do utilizador

wsl ~

O ~ pode ser utilizado com o wsl para iniciar no diretório pessoal do utilizador. Para saltar de qualquer diretório de volta para a página inicial a partir de um prompt de comando WSL, você pode usar o comando: cd ~.

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

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

Para executar uma distribuição Linux específica com um usuário específico, substitua <Distribution Name> pelo nome da sua distribuição Linux preferida (ou seja, Debian) e <User Name> com o nome de um usuário existente (ou seja, root). 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 da WSL

wsl --status

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

Verifique a versão do WSL

wsl --version

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

Comando de Ajuda

wsl --help

Veja 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 WSL.

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

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

Altere o usuário padrão para seu login 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 mudaria o usuário padrão para a distribuição do Ubuntu para o usuário "johndoe".

Encerramento

wsl --shutdown

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

Encerrar

wsl --terminate <Distribution Name>

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

Identificar endereço IP

• wsl hostname -I: Retorna o endereço IP da sua distribuição Linux instalada via WSL 2 (o endereço da VM WSL 2)
• ip route show | grep -i default | awk '{ print $3}': Retorna o endereço IP da máquina Windows como visto do WSL 2 (a VM do WSL 2)

Para obter uma explicação mais detalhada, consulte Acessando aplicativos de rede com WSL: identificar endereços 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. Por padrão, utiliza 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ó é suportado usando 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ó é suportado usando 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 no local

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 Linux

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

wsl --unregister <DistributionName>

Substituir <DistributionName> pelo nome da sua distribuição Linux de destino cancelará o registro dessa distribuição da 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 perdidos permanentemente. A reinstalação a partir da loja online 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 Linux em sua máquina Windows como qualquer outro aplicativo da loja. 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 caminho diretório\arquivo onde o disco está localizado. Veja Montar um disco Linux no WSL 2. As opções incluem:

• --vhd: Especifica que <Disk> se refere a um disco rígido virtual.
• --name: Monte o disco usando um nome personalizado para o ponto de montagem
• --bare: Conecte o disco ao WSL2, mas não o monte.
• --type <Filesystem>: Tipo de sistema de ficheiros a ser usado ao montar um disco, se não especificado padroniza-se para ext4. Este comando também pode ser inserido como: wsl --mount -t <Filesystem>. Você pode detetar 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 montar. Se não for especificado, monta-se o disco inteiro.
• --options <MountOptions>: Existem algumas opções específicas do sistema de arquivos que podem ser incluídas ao montar um disco. Por exemplo, opções de montagem ext4 como: wsl --mount -o "data-ordered" ou wsl --mount -o "data=writeback. No entanto, apenas opções específicas do sistema de arquivos são suportadas no momento. Opções genéricas, como ro, rwou noatime, não são suportadas.

Desmontar discos

wsl --unmount <DiskPath>

Desmonte um disco localizado no caminho especificado, se nenhum caminho for fornecido, este comando desmontará e desconectará 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 Linux instaladas com WSL, mas foram substituídos pela sintaxe de comando wsl ou wsl.exe.