Exemplos de parâmetros de linha de comando para a instalação do Visual Studio

  • Artigo

Para ilustrar como usar parâmetros de linha de comando para instalar o Visual Studio, aqui estão vários exemplos que podem ser personalizados para atender às suas necessidades.

Em cada exemplo, vs_enterprise.exe, vs_professional.exe e vs_community.exe representam a respectiva edição do bootstrapper do Visual Studio, que é o arquivo pequeno (aproximadamente 1 MB) que inicia o processo de download. Se você estiver usando uma edição diferente, substitua o nome do bootstrapper adequado.

Todos os comandos exigem elevação administrativa e um prompt do Controle de Conta de Usuário será exibido se o processo não for iniciado em um prompt com privilégios elevados.

Você pode usar o caractere ^ no final de uma linha de comando para concatenar várias linhas em um único comando. Como alternativa, é possível colocar essas linhas juntas em uma única linha. No PowerShell, o equivalente é o caractere de acento grave (`).

Para listas de cargas de trabalho e componentes que você pode instalar usando a linha de comando, confira a página IDs de carga de trabalho e de componente do Visual Studio.

Instalar usando --installPath junto com o bootstrapper

  • Instale uma instância mínima do Visual Studio sem prompts interativos, mas com o progresso exibido:

    vs_enterprise.exe --installPath C:\minVS ^
--add Microsoft.VisualStudio.Workload.CoreEditor ^
--passive --norestart

  • Instale silenciosamente, uma instância da área de trabalho do Visual Studio com o pacote de idioma francês, retornando somente quando o produto estiver instalado.

    vs_enterprise.exe --installPath C:\desktopVS ^
--addProductLang fr-FR ^
--add Microsoft.VisualStudio.Workload.ManagedDesktop ^
--includeRecommended --quiet --wait

Atualizar

  • Atualize uma instância do Visual Studio por meio da linha de comando com progresso exibido e sem prompts interativos. Você pode executar essas séries de comandos em duas etapas usando um bootstrapper encontrado no cliente ou em um layout. O primeiro comando atualiza o instalador no cliente e o segundo comando atualiza o produto Visual Studio. Você precisa executar esses comandos em um prompt de comando elevado, porque a atualização do instalador requer permissões de administrador. O exemplo a seguir simula a atualização de um cliente usando um bootstrapper evergreen no layout.

    \\layoutserver\share\path\vs_enterprise.exe --update --quiet --wait
\\layoutserver\share\path\vs_enterprise.exe update --wait --passive --norestart --installPath "C:\installPathVS"

Como alternativa, você também pode atualizar a instância do Visual Studio em uma etapa usando o instalador no cliente. Os usuários Standard, se tiverem recebido permissões apropriadas, poderão executar programaticamente o comando de atualização usando o instalador, mas não poderão usar a opção --passive ou --quiet. Observe que você não pode iniciar o instalador programaticamente no mesmo diretório no qual está o instalador.

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" update --passive --norestart --installPath "C:\installPathVS"

Em uso – Aguarde

  • Use --wait em arquivos ou scripts em lotes para aguardar a conclusão do comando inicial para que o próximo comando seja executado. Para arquivos em lote, uma variável de ambiente %ERRORLEVEL% contém o valor retornado do comando, conforme documentado na página Usar parâmetros de linha de comando para instalar o Visual Studio. Alguns utilitários de comando exigem que outros parâmetros aguardem a conclusão e obtenham o valor retornado do instalador.

O parâmetro --wait só é compatível com o bootstrapper.

start /wait vs_professional.exe --installPath "C:\VS" --passive --wait > nul
echo %errorlevel%

O comando a seguir é um exemplo de como usar --wait com o comando de script do PowerShell Start-Process:

$process = Start-Process -FilePath vs_enterprise.exe -ArgumentList "--installPath", "C:\VS", "--passive", "--wait" -Wait -PassThru
Write-Output $process.ExitCode

ou

 $startInfo = New-Object System.Diagnostics.ProcessStartInfo
 $startInfo.FileName = "vs_enterprise.exe"
 $startInfo.Arguments = "--all --quiet --wait"
 $process = New-Object System.Diagnostics.Process
 $process.StartInfo = $startInfo
 $process.Start()
 $process.WaitForExit()
  • O primeiro --wait é usado pelo bootstrapper do Visual Studio e o segundo -Wait é usado pelo 'Start-Process' para aguardar a conclusão. O parâmetro -PassThru é usado por Start-Process para usar o código de saída do instalador como o valor retornado.

Usando --layout para criar um layout de rede ou um cache local

  • Crie um layout que inclua apenas o editor principal do Visual Studio (a configuração mínima do Visual Studio) e o pacote de idiomas em inglês. Veja mais exemplos de criação de layout na página Criar uma instalação de rede do Visual Studio.

    vs_professional.exe --layout "C:\VS" ^
--lang en-US ^
--add Microsoft.VisualStudio.Workload.CoreEditor ^

Usando --all para adquirir todo o produto

  • Inicie uma instalação interativa de todas as cargas de trabalho e componentes que estão disponíveis no Visual Studio Enterprise Edition:

    vs_enterprise.exe --all

Usando --includeRecommended

  • Instale uma segunda instância do Visual Studio Professional usando um apelido em um computador com o Visual Studio Community Edition já instalado, com suporte para o desenvolvimento do Node.js:

    vs_professional.exe --installPath C:\VSforNode ^
--add Microsoft.VisualStudio.Workload.Node --includeRecommended --nickname VSforNode

Usando --channelURI

Usando o instalador mais recente, é possível configurar onde o Visual Studio procura atualizações. O --channelUri também é conhecido como o canal de atualização ou o local de origem das atualizações. A tabela a seguir fornece valores de exemplo para channelId e channelUri e o que eles significam.

Nome do Canal --channelUri --channelId
Canal atual do Visual Studio 2022 https://aka.ms/vs/17/release/channel VisualStudio.17.Release
Canal LTSC do Visual Studio 2022 17.0 https://aka.ms/vs/17/release.LTSC.17.0/channel VisualStudio.17.Release.LTSC.17.0
Canal de visualização do Visual Studio 2022 https://aka.ms/vs/17/pre/channel VisualStudio.17.Preview
Canal de versão do Visual Studio 2019 https://aka.ms/vs/16/release/channel VisualStudio.16.Release
Canal de versão do Visual Studio 2017 https://aka.ms/vs/15/release/channel VisualStudio.15.Release
Layout personalizado – Canal Privado \\layoutserver\share\path\channelmanifest.json VisualStudio.17.Release (ou seja qual for o layout baseado)

Se você optar por usar um layout personalizado como o canal de atualização, lembre-se das seguintes diretrizes:

Usando --remove

  • Remova o componente Ferramentas de Criação de Perfil da instância do Visual Studio instalada por padrão. Este exemplo usa o instalador já instalado no computador cliente. Os usuários padrão com permissões podem executar programaticamente o comando de modificação usando o instalador, mas não têm permissão para usar a opção --passive ou --quiet. Observe que você não pode iniciar o instalador programaticamente no mesmo diretório no qual está o instalador.

    "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify ^
--installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise" ^
--remove Microsoft.VisualStudio.Component.DiagnosticTools ^
--passive

Você não pode usar --remove no mesmo comando que --layout. Em outras palavras, não é possível remover componentes de um layout.

Usando --removeOos

Usando o instalador mais recente, você pode modificar uma instalação e remover todos os componentes que fizeram a transição para um estado sem suporte da instância padrão do Visual Studio instalada. Este exemplo usa o instalador já instalado no computador cliente para definir a configuração removeOos. Os usuários Standard, se tiverem recebido permissões apropriadas, poderão executar programaticamente o comando de modificação usando o instalador, mas não poderão usar a opção --passive ou --quiet. Você não pode iniciar o instalador programaticamente a partir do mesmo diretório no qual está o instalador.

 "C:\Program Files (x86)\Microsoft Visual studio\Installer\setup.exe" modify ^
 --installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise" ^
 --removeOos true ^
 --passive

  • Ajuste as configurações de atualização para remover persistentemente todos os componentes transicionados para um estado sem suporte sempre que o produto for atualizado:

    "C:\Program Files (x86)\Microsoft Visual studio\Installer\setup.exe" modify ^
--channelURI https://aka.ms/vs/17/release.LTSC.17.0/channel ^
--productID Microsoft.VisualStudio.Product.Enterprise ^
--newChannelURI \\layoutserver\share\path\channelmanifest.json ^
--removeOos true ^
--quiet

Usando --path

Todos esses exemplos pressupõem que você esteja instalando um novo produto usando um bootstrapper.

  • Use os caminhos de instalação, de cache e compartilhados:

    vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path cache="C:\VS\cache" --path shared="C:\VS\shared"

  • Use somente os caminhos de instalação e de cache:

    vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path cache="C:\VS\cache"

  • Use somente os caminhos de instalação e compartilhados:

    vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path shared="C:\VS\shared"

  • Use somente o caminho de instalação:

    vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS"

Usando a exportação

  • Use a exportação para salvar a seleção de uma instalação. Este exemplo usa o instalador já instalado no computador cliente.

    "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" export --installPath "C:\VS" --config "C:\my.vsconfig"

  • Use a exportação para salvar a seleção personalizada do zero. Este exemplo usa o instalador já instalado no computador cliente.

    "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" export --channelId VisualStudio.17.Release --productId Microsoft.VisualStudio.Product.Enterprise --add Microsoft.VisualStudio.Workload.ManagedDesktop --includeRecommended --config "C:\my.vsconfig"

Usando --config

  • Use --config para instalar os componentes e as cargas de trabalho de um arquivo de configuração de instalação salvo anteriormente:

    vs_enterprise.exe --config "C:\my.vsconfig" --installPath "C:\VS"

  • Use --config para adicionar os componentes e as cargas de trabalho a uma instalação existente. Este exemplo usa o instalador já instalado no computador cliente. Os usuários padrão com permissões podem executar programaticamente o comando de modificação usando o instalador, mas não têm permissão para usar a opção --passive ou --quiet. Você não pode iniciar o instalador programaticamente a partir do mesmo diretório no qual está o instalador.

    "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "C:\VS" --config "C:\my.vsconfig"

  • Use --config para configurar o conteúdo de um layout:

    vs_enterprise.exe --layout C:\layout --config "C:\my.vsconfig"

Usando winget

Use a ferramenta "winget" do Gerenciador de Pacotes do Windows para instalar ou atualizar por meio de programação o Visual Studio em seus computadores, juntamente com outros pacotes gerenciados pelo winget. Para personalizar a instalação e especificar outras cargas de trabalho e componentes, você pode usar o switch --override do winget junto com o comando install do winget e transmitir um arquivo vsconfig exportado como este:

winget install --id Microsoft.VisualStudio.2022.Community --override "--passive --config C:\my.vsconfig"

Você também pode usar winget configure e passar um .yaml arquivo para modificar uma instalação existente do Visual Studio. Essa abordagem usa o provedor DSC do Visual Studio PowerShelldocumentado aqui.

Suporte ou solução de problemas

Às vezes, as coisas podem dar errado. Se a instalação do Visual Studio falhar, confira Solução de problemas de instalação e atualização do Visual Studio para obter diretrizes passo a passo.

Aqui estão algumas outras opções de suporte:

Conteúdo relacionado