Prompt de Comando do Desenvolvedor do Visual Studio e PowerShell do Desenvolvedor

  • Artigo

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:

  • Prompt de Comando do Desenvolvedor do Visual Studio – um prompt de comando padrão com determinadas variáveis de ambiente definidas para facilitar o uso de ferramentas de desenvolvedor da linha de comando.

    Captura de tela do Prompt de Comando do Desenvolvedor para Visual Studio 2019 mostrando a ferramenta clrver.

    Captura de tela do Prompt de Comando do Desenvolvedor para Visual Studio 2022 que mostra a ferramenta clrver.

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

    Captura de tela da ferramenta PowerShell do Desenvolvedor no Visual Studio 2022.

A partir do Visual Studio 2019, o Visual Studio inclui um terminal integrado que pode hospedar qualquer um desses shells (Prompt de Comando do Desenvolvedor e PowerShell do Desenvolvedor). Você também pode abrir várias guias de cada shell. O terminal do Visual Studio é criado com base em Terminal do Windows. Para abrir o terminal no Visual Studio, selecione Exibir>Terminal.

Captura de tela do painel do terminal do Visual Studio que mostra várias guias.

Captura de tela do terminal do Visual Studio mostrando várias guias.

Dica

Essa página descreve como usar os shells de linha de comando no Visual Studio. Se você estiver procurando 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 definidas 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 utilitários diferentes sem precisar saber onde eles estão localizados.

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

Iniciar no Visual Studio

Siga estas etapas para abrir o Prompt de Comando do Desenvolvedor ou o PowerShell do Desenvolvedor 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 PowerShell do Desenvolvedor.

    Captura de tela do menu Linha de Comando no Visual Studio 2022.

    Captura de tela do menu Linha de Comando no Visual Studio 2019.

Iniciar a partir do menu do Windows

Outra maneira de iniciar os shells é a partir do menu Iniciar. É possível que haja vários prompts de comando, dependendo da versão do Visual Studio e quaisquer SDKs adicionais e cargas de trabalho que você instalou.

Windows 11

  1. Selecione Iniciar Captura de tela do botão Iniciar no Windows 11. e, em seguida, na caixa de diálogo Digite aqui para pesquisar insira developer command prompt ou developer powershell.

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

Windows 10

  1. Selecione Iniciar Captura de tela do botão Iniciar no Windows 10. e role até a letra V.

  2. Expanda a pasta Visual Studio 2019 ou Visual Studio 2022.

  3. Se você estiver executando o Visual Studio 2019, selecione Prompt de Comando do Desenvolvedor para VS 2019 ou PowerShell do Desenvolvedor para VS 2019. Se você estiver executando o Visual Studio 2022, selecione Prompt de Comando do Desenvolvedor para VS 2022 ou PowerShell do Desenvolvedor 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 à medida que a lista de resultados começa a exibir as correspondências de pesquisa.

    Uma animação que mostra o comportamento de pesquisa no Windows 10.

Windows 8.1

  1. Vá para a tela Iniciar pressionando a tecla do logotipo do Windows Captura de tela da tecla do logotipo do Windows no teclado. no teclado, por exemplo.

  2. Na tela Iniciar, pressione Ctrl+Tab para abrir a lista de Aplicativos e pressione V. Isso apresenta uma lista que inclui todos os prompts de comando do Visual Studio instalados.

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

Iniciar a partir do navegador de arquivos

Normalmente, os atalhos para os shells que você instalou serão colocados na pasta Menu Iniciar do Visual Studio, como em %ProgramData%\Microsoft\Windows\Start Menu\Programs\Visual Studio 2019\Visual Studio Tools. Porém, se a pesquisa do prompt de comando não produzir os resultados esperados, você poderá tentar localizar manualmente os arquivos em seu computador.

Prompt de Comando do Desenvolvedor

Pesquise pelo nome do arquivo do prompt de comando, que é VsDevCmd.bat, ou acesse a pasta Ferramentas do Visual Studio, como %ProgramFiles%\Microsoft Visual Studio\2022\Community\Common7\Tools (o caminho muda conforme seu local de instalação, edição e versão do Visual Studio).

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

"%ProgramFiles%\Microsoft Visual Studio\2022\Community\Common7\Tools\VsDevCmd.bat"

Ou insira o seguinte comando na caixa de diálogo Executar do Windows:

%comspec% /k "C:\Program Files\Microsoft Visual Studio\2022\Community\Common7\Tools\VsDevCmd.bat"

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

Ou insira o seguinte comando na caixa de diálogo Executar do Windows:

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\Common7\Tools\VsDevCmd.bat"

Desde o Visual Studio 2015, o prompt de comando do desenvolvedor define a variável de ambiente VSCMD_VER que contém as informações de versão para o Visual Studio (por exemplo: 17.9.0). Caso precise detectar 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.

PowerShell do Desenvolvedor

Pesquise um arquivo de script do PowerShell chamado Launch-VsDevShell.ps1ou acesse a pasta Ferramentas do Visual Studio, como %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\Tools. (O caminho é alterado 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 comando a seguir em um prompt do Windows PowerShell ou do PowerShell 6.

Para o Visual Studio 2022:

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

Para Visual Studio 2019:

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

Por padrão, o PowerShell do Desenvolvedor que inicia é configurado para a instalação do Visual Studio cujo caminho de instalação é onde o arquivo Launch-VsDevShell.ps1 está localizado.

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 do PowerShell no caminho de instalação do Visual Studio, carregando-o e invocando o cmdlet Enter-VsDevShell. 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 PowerShell do Desenvolvedor interativamente ou para a automação de build de scripts.

Argumentos de linha de comando

Você pode usar argumentos de linha de comando para qualquer um dos shells, Prompt de Comando do Desenvolvedor ou PowerShell do Desenvolvedor.

Arquitetura de destino e arquitetura de host

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

Dica

A partir do Visual Studio 2022, msbuild será o padrão de um binário de msbuild.exe de 64 bits, 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 host>
PowerShell do Desenvolvedor -Arch <Arquitetura de destino>
PowerShell do Desenvolvedor -HostArch <Arquitetura do host>

Importante

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

A tabela a seguir lista quais arquiteturas têm suporte e se elas podem ser usadas para argumentos de arquitetura de destino ou de arquitetura do host.

Arquitetura Arquitetura de destino Arquitetura do Host
x86 Padrão Padrão
amd64 Sim Sim
arm Sim Não
arm64 Sim No

Dica

Se você definir somente a Arquitetura de Destino, os shells tentarão fazer com que a Arquitetura do Host seja correspondente. Isso pode resultar em erros quando apenas a Arquitetura de Destino é definida como um valor que também não tem suporte da Arquitetura do Host.

Exemplos

Inicie o Prompt de Comando do Desenvolvedor para Visual Studio 2019 Community Edition em um computador de 64 bits, criando saídas de build direcionadas 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 um computador de 64 bits, criando saídas de build direcionadas 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 um computador de 64 bits, criando saídas de build direcionadas ao arm64:

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

SkipAutomaticLocation

Para o PowerShell do Desenvolvedor, o diretório inicial do shell é a Localização do Projeto do Visual Studio. Essa localidade padrão substitui quaisquer outros caminhos, como 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 em Ferramentas>Opções>Projetos e Soluções>Localização do Projeto.

A localização do projeto pode ser ajustada em Ferramentas>, Opções>, Projetos e soluções>, Locais.

Dica

Os argumentos da linha de comando -Arch, -HostArch e -SkipAutomaticLocation têm suporte do script Launch-VsDevShell.ps1 e do cmdlet Enter-VsDevShell.

Conteúdo relacionado