Prompt de comando do desenvolvedor do Visual Studio e PowerShell do desenvolvedor

O Visual Studio inclui dois shells de linha de comando para desenvolvedores, um prompt de comando e uma instância do PowerShell, da seguinte maneira:

• Visual Studio Developer Command Prompt: um prompt de comando padrão com determinadas variáveis de ambiente definidas para facilitar o uso de ferramentas de desenvolvedor de linha de comando.

  

• Visual Studio Developer PowerShell: mais poderoso do que um prompt de comando. Por exemplo, você pode passar a saída de um comando, conhecido como cmdlet, para outro cmdlet. Esse shell tem as mesmas variáveis de ambiente definidas como o Prompt de Comando do Desenvolvedor. Disponível desde o Visual Studio 2019.

  

A partir do Visual Studio 2019, o Visual Studio inclui um terminal integrado que pode hospedar qualquer um desses shells de linha de comando. Você também pode abrir várias abas de cada shell. O terminal do Visual Studio é construído sobre Terminal do Windows. Para abrir o terminal no Visual Studio, selecione Exibir >Terminal.

Dica

Esta página descreve como usar os shells de linha de comando no Visual Studio. Se procurar o equivalente em Visual Studio Code— também conhecido como VS Code— consulte Interface de Linha de Comando (CLI) e Noções Básicas do Terminal.

Quando você abre um dos shells de desenvolvedor do Visual Studio, como um aplicativo separado ou na janela Terminal, ele é aberto para o diretório da sua solução atual (se você tiver uma solução carregada). Esse comportamento torna conveniente executar comandos na solução ou em seus projetos.

Ambos os shells têm variáveis de ambiente específicas que permitem que você use ferramentas de desenvolvedor de linha de comando com mais facilidade. Depois de abrir um desses shells, você pode inserir os comandos para diferentes utilitários sem ter que saber onde eles estão localizados.

Comandos populares	Descrição
MSBuild	Criar um projeto ou solução
dotnet	Um comando .NET CLI
dotnet run	Um comando .NET CLI
clrver	Uma ferramenta do .NET Framework para o CLR
ildasm	Uma ferramenta .NET Framework para desassemblador
CL	Ferramenta de compilação C/C++
NMAKE	Ferramenta de compilação C/C++
LIB	Ferramenta de compilação C/C++
DUMPBIN	Ferramenta de compilação C/C++

Iniciar no Visual Studio

Siga estas etapas para abrir o Prompt de Comando do Desenvolvedor ou o Developer PowerShell de dentro do Visual Studio:

1. Abra o Visual Studio.

2. Na barra de menus, selecione Ferramentas >Linha de Comando>Prompt de Comando do Desenvolvedor ou Developer PowerShell.

   

Iniciar a partir do menu do Windows

Outra maneira de iniciar os shells é a partir do menu Iniciar. Você pode ter vários prompts de comando, dependendo da versão do Visual Studio e de quaisquer outros SDKs e cargas de trabalho instalados.

Windows 11

1. Selecione Iniciar e, em seguida, na caixa de diálogo Digite aqui para pesquisar , digite um developer command prompt ou developer powershell.

2. Selecione o resultado do aplicativo associado ao texto da pesquisa.

Windows 10

1. Selecione Iniciar e, em seguida, desloque-se para a letra V.

2. Expanda o Visual Studio 2019 ou pasta de do Visual Studio 2022.

3. Se você estiver executando o Visual Studio 2019, selecione Prompt de Comando do Desenvolvedor para VS 2019 ou Developer PowerShell para VS 2019. Se você estiver executando o Visual Studio 2022, selecione Prompt de Comando do Desenvolvedor para VS 2022 ou Developer PowerShell para VS 2022.

   Como alternativa, você pode começar a digitar o nome do shell na caixa de pesquisa na barra de tarefas e selecionar o resultado desejado quando a lista de resultados começar a exibir as correspondências de pesquisa.

   

Iniciar a partir do navegador de ficheiros

Normalmente, os atalhos para os shells instalados são colocados na pasta Menu Iniciar do Visual Studio, como em%ProgramData%\Microsoft\Windows\Start Menu\Programs\Visual Studio 2019\Visual Studio Tools. Mas se a pesquisa pelo prompt de comando não produzir os resultados esperados, você pode tentar localizar manualmente os arquivos em sua máquina.

Prompt de comando do desenvolvedor

Procure o nome do arquivo de prompt de comando, que é VsDevCmd.bat, ou vá para a pasta Ferramentas do Visual Studio, como %ProgramFiles%\Microsoft Visual Studio\2022\Community\Common7\Tools (o caminho muda de acordo com sua versão, edição e local de instalação do Visual Studio).

Depois de localizar o arquivo de prompt de comando, abra-o inserindo o seguinte comando em uma janela de prompt de comando regular:

Desde o Visual Studio 2015, o Prompt de Comando do Desenvolvedor define a variável de VSCMD_VER ambiente, que contém as informações de versão do Visual Studio (por exemplo: 17.14.8). Se você precisar detetar se o Prompt de Comando do Desenvolvedor já foi executado no console, é recomendável verificar se VSCMD_VER foi definido ou não.

Dica

Certifique-se de editar o caminho para corresponder à versão ou edição do Visual Studio que você está usando.

Desenvolvedor PowerShell

Procure um arquivo de script do PowerShell chamado Launch-VsDevShell.ps1ou vá para a pasta Ferramentas do Visual Studio, como %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\Tools. O caminho muda de acordo com sua versão, edição e local de instalação do Visual Studio. Depois de localizar o arquivo do PowerShell, execute-o inserindo o seguinte comando em um prompt do Windows PowerShell ou PowerShell 6.

Para o Visual Studio 2022:

& 'C:\Program Files\Microsoft Visual Studio\18\Community\Common7\Tools\Launch-VsDevShell.ps1'

Para o Visual Studio 2019:

& 'C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\Common7\Tools\Launch-VsDevShell.ps1'

Por padrão, o Developer PowerShell que é executado está configurado para a instalação do Visual Studio cujo caminho contém o arquivo Launch-VsDevShell.ps1.

Dica

A política de execução deve ser definida para que o cmdlet seja executado.

O script Launch-VsDevShell.ps1 funciona localizando o módulo Microsoft.VisualStudio.DevShell.dll PowerShell no caminho de instalação do Visual Studio, carregando-o e invocando o Enter-VsDevShell cmdlet. Os atalhos instalados, como os do menu Iniciar, carregam o módulo e invocam o cmdlet diretamente. Launch-VsDevShell.ps1 é a maneira recomendada de inicializar o Developer PowerShell interativamente ou para criar scripts de automação de compilação.

Argumentos de linha de comando

Você pode usar argumentos de linha de comando em qualquer um dos shells: Developer Command Prompt ou Developer PowerShell.

Arquitetura de destino e arquitetura de host

Para ferramentas de compilação, como o compilador C++, que criam saídas direcionadas a arquiteturas de CPU específicas, os shells do desenvolvedor podem ser configurados usando o argumento de linha de comando apropriado. A arquitetura dos binários da ferramenta de compilação também pode ser configurada usando argumentos de linha de comando. Isso é útil quando a máquina de compilação é uma arquitetura diferente da arquitetura de destino.

Dica

A partir do Visual Studio 2022, o msbuild padrão é um binário de 64 bits msbuild.exe, independentemente da arquitetura do host.

Shell	Argumento
Prompt de comando do desenvolvedor	-arch=<Arquitetura de destino>
Prompt de comando do desenvolvedor	-host_arch=<Arquitetura do Anfitrião>
Desenvolvedor PowerShell	-Arquitetura Arch <Target>
Desenvolvedor PowerShell	-Arquitetura de host HostArch <>

Importante

Argumentos -Arch do PowerShell do desenvolvedor e -HostArch só estão disponíveis a partir do Visual Studio 2022 versão 17.1.

A tabela a seguir lista quais arquiteturas são suportadas e se elas podem ser usadas para argumentos de Arquitetura de Destino ou Arquitetura de Host.

Arquitetura	Arquitetura de destino	Arquitetura do host
x86	Padrão	Padrão
AMD64	Sim	Sim
braço	Sim	Não
arm64	Sim	Não

Dica

Se você definir apenas Arquitetura de Destino, os shells tentarão fazer com que a Arquitetura de Host corresponda. Isso pode resultar em erros quando apenas a Arquitetura de Destino é definida como um valor que também não é suportado pela Arquitetura de Host.

Exemplos

Inicie o prompt de comando do desenvolvedor para Visual Studio 2019 Community Edition em uma máquina de 64 bits, criando saídas de compilação destinadas a 64 bits:

"%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\Tools\VsDevCmd.bat" -arch=amd64

Inicie o prompt de comando do desenvolvedor para Visual Studio 2019 Community Edition em uma máquina de 64 bits, criando saídas de compilação destinadas ao ARM:

"%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\Tools\VsDevCmd.bat" -arch=arm -host_arch=amd64

Inicie o PowerShell do desenvolvedor para a Community Edition do Visual Studio 2022 versão 17.1 ou posterior em uma máquina de 64 bits, criando saídas de compilação destinadas ao ARM64:

& 'C:\Program Files\Microsoft Visual Studio\2022\Community\Common7\Tools\Launch-VsDevShell.ps1' -Arch arm64 -HostArch amd64

Ignorar Localização Automática

Para o Developer PowerShell, o diretório inicial do shell é o Local do Projeto do Visual Studio. Essa localidade padrão substitui quaisquer outros caminhos, como o diretório de trabalho. Esse comportamento pode ser desativado usando o argumento de linha de comando -SkipAutomaticLocation. Isso pode ser útil se você quiser que o shell permaneça no diretório atual após a inicialização.

A Localização do Projeto pode ser ajustada no painel Ferramentas>Opções na secção Todas as Definições>Projetos e Soluções>Localizações.

Dica

Os argumentos de linha de comando -Arch, -HostArche -SkipAutomaticLocation são suportados pelo script Launch-VsDevShell.ps1 e pelo cmdlet Enter-VsDevShell.

Conteúdo relacionado

• O que é o Terminal Windows?
• Ferramentas do .NET Framework
• Use o conjunto de ferramentas do Microsoft C++ na linha de comando