Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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 executandowsl --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"
ouwsl --mount -o "data=writeback
. No entanto, somente opções específicas do sistema de arquivos têm suporte no momento. Opções genéricas, comoro
,rw
ounoatime
, 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
.
Windows Subsystem for Linux