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

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.

Instale usando --installPath e --add 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.

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

• o --channelUri precisa apontar para o arquivo 'channelmanifest.json' no layout personalizado.
• Os administradores podem configurar como o layout personalizado "Canal Privado" é exibido na interface do usuário das Configurações de Atualização definindo as configurações do registro do cliente.

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:

• Oferecemos uma opção de suporte por meio do chat de instalação (somente em inglês) para problemas relacionados à instalação.
• Relate problemas do produto para nós por meio da ferramenta Relatar um Problema, exibida no Instalador do Visual Studio e no IDE do Visual Studio. Se você for Administrador de TI e não tiver o Visual Studio instalado, envie os comentários de Administrador de TI aqui.
• Sugira um recurso, acompanhe os problemas do produto e encontre respostas na Comunidade de Desenvolvedores do Visual Studio.

Conteúdo relacionado

• Guia do administrador do Visual Studio
• Usar parâmetros de linha de comando para instalar o Visual Studio
• Criar uma instalação de rede do Visual Studio
• IDs de carga de trabalho e de componente do Visual Studio