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

Aplica-se a:yes Visual Studio noVisual Studio para Mac noVisual Studio Code

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 de linha de comando. Disponível desde o Visual Studio 2015.

    Screenshot of the Developer Command Prompt for Visual Studio 2019 showing clrver tool.

    Screenshot of the Developer Command Prompt for Visual Studio 2022 that shows the clrver tool.

  • PowerShell do Desenvolvedor do Visual Studio – mais avançado 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 Prompt de Comando do Desenvolvedor. Disponível desde o Visual Studio 2019.

    Screenshot of the Developer PowerShell tool in Visual Studio 2022.

A partir do Visual Studio 2019 versão 16.5, 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 sobre o Terminal do Windows. Para abrir o terminal no Visual Studio, selecione Exibir>Terminal.

Screenshot of the Visual Studio terminal pane that shows multiple tabs.

Screenshot of the Visual Studio terminal showing multiple tabs.

Quando você abre um dos shells de desenvolvedor do Visual Studio, seja 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 Criar um projeto ou solução
clrver Uma ferramenta .NET Framework para CLR
ildasm Uma ferramenta .NET Framework para desmontar
dotnet Um comando da CLI do .NET
dotnet run Um comando da CLI do .NET
CL Ferramenta de compilação C/C++
NMAKE Ferramenta de compilação C/C++
LIB Ferramenta de build C/C++
DUMPBIN Ferramenta de build C/C++

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 oPrompt de Comando do Desenvolvedor de Linha > deComandodas Ferramentas> ou o PowerShell do Desenvolvedor.

    Screenshot of the Command Line menu in Visual Studio 2022.

    Screenshot of the Command Line menu in Visual Studio 2019.

Iniciar no menu do Windows

Outra maneira de iniciar os shells é no menu Iniciar. Você pode ter vários prompts de comando, dependendo da versão do Visual Studio e de quaisquer SDKs e cargas de trabalho adicionais que você instalou.

Windows 11

  1. Selecione IniciarScreenshot of the Start button in Windows 11. e, em seguida, no Tipo aqui para pesquisar a caixa de diálogo, insira ou developer command promptdeveloper powershell.

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

Windows 10

  1. Selecione IniciarScreenshot of the Start button in 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 o Prompt de Comando do Desenvolvedor para VS 2019 ou o PowerShell do Desenvolvedor para VS 2019. Se você estiver executando o Visual Studio 2022, selecione o Prompt de Comando do Desenvolvedor para VS 2022 ou o 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 quando a lista de resultados começar a exibir as correspondências de pesquisa.

    An animation that shows the search behavior in Windows 10.

Windows 8.1

  1. Vá para a tela Inicial pressionando a tecla Screenshot of the Windows logo key on the keyboard. de logotipo do Windows no teclado, por exemplo.

  2. Na tela Inicial , pressione Ctrl+Tab para abrir a lista 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 o Prompt de Comando do Desenvolvedor para VS 2019 ou o PowerShell do Desenvolvedor para VS 2019. Se você estiver executando o Visual Studio 2022, selecione o Prompt de Comando do Desenvolvedor para VS 2022 ou o PowerShell do Desenvolvedor para VS 2022.

Windows 7

  1. Selecione Iniciar e expanda Todos os Programas.

  2. Selecione o Prompt de Comando do Desenvolvedor deFerramentas> do Visual Studio 2019>para o VS 2019 ou o PowerShell do Desenvolvedor para VS 2019. (Se você estiver executando o Visual Studio 2022, procure os mesmos itens que incluem "2022" em vez de "2019".)

    Screenshot of the Windows 7 Start menu with the command prompt highlighted.

Se você tiver outros SDKs instalados, como o SDK do Windows 10 ou versões anteriores, poderá ver prompts de comando adicionais. Consulte a documentação das ferramentas individuais para determinar qual versão do prompt de comando você deve usar.

Iniciar do navegador de arquivos

Normalmente, os atalhos para os shells instalados são colocados na pasta Menu Iniciar para Visual Studio, como em %ProgramData%\Microsoft\Windows\Menu Iniciar\Programas\Visual Studio 2019\Visual Studio Tools. Mas 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 o nome do arquivo de prompt de comando, que é VsDevCmd.batou vá para a pasta Ferramentas do Visual Studio, como %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\Tools (alterações de caminho 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:

"%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"

Dica

Edite o caminho para corresponder à versão do Visual Studio que você está usando.

PowerShell do desenvolvedor

Pesquise 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 é 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 seguinte comando em um prompt do Windows PowerShell ou do PowerShell 6:

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

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

Dica

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

O Launch-VsDevShell.ps1 script funciona localizando o módulo do 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 PowerShell do Desenvolvedor interativamente ou para a automação de build de script.

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 o padrão será 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 -Arquitetura de destino de arco <>
PowerShell do desenvolvedor -Arquitetura do host Host Do Host 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 arquitetura de host.

Arquitetura Arquitetura de destino Arquitetura do host
x86 Padrão Padrão
amd64 Yes Yes
arm Sim No
arm64 Sim No

Dica

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

Exemplos

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

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

Inicie o PowerShell do Desenvolvedor para a Edição community do Visual Studio 2022 versão 17.1 ou posterior em um computador de 64 bits, criando saídas de build direcionadas para arm64:

& 'C:\Program Files (x86)\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 é o Local 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 -SkipAutomaticLocationde linha de comando. Isso pode ser útil se você quiser que o shell permaneça no diretório atual após a inicialização.

O Local do Projeto pode ser ajustado noLocal do Projeto deSoluções de Projetos de Opções de Ferramentas&>.>>

Dica

Os argumentos -Arch-HostArchde linha de comando e -SkipAutomaticLocation têm suporte tanto pelo Launch-VsDevShell.ps1 script quanto pelo Enter-VsDevShell cmdlet.

Confira também