Exemplos de parâmetros de linha de comando para 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.exee vs_community.exe representam a respetiva edição do bootstrapper do Visual Studio, que é o pequeno arquivo (~ 1MB) que inicia o processo de download. Se você estiver usando uma edição diferente, substitua o nome do bootstrapper apropriado.

Todos os comandos exigem elevação administrativa e um prompt de Controle de Conta de Usuário será exibido se o processo não for iniciado a partir de um prompt elevado.

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

Para executar comandos de forma não interativa, você pode usar--passive ou --quiet. Para obter mais informações sobre esses parâmetros, consulte a página de comandos de e parâmetros de linha de comando.

Para obter listas das cargas de trabalho e componentes que você pode instalar usando a linha de comando, consulte a página Visual Studio workload and component IDs.

Instale usando --installPath e --add ao lado do bootstrapper

• Instale uma instância mínima do Visual Studio, sem solicitações interativas, mas com o progresso exibido:

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

• Instale uma instância da área de trabalho do Visual Studio silenciosamente, 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 essa série 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 atualizar o instalador requer permissões de administrador. O exemplo a seguir simula a atualização de um cliente usando um bootstrapper contínuo 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 sua instância do Visual Studio em uma etapa usando o instalador no cliente. utilizadores Standard, se tiverem recebido permissões apropriadas, podem executar de forma programática o comando update 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 a partir do mesmo diretório em que o instalador reside.

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

Usando --wait

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

O parâmetro --wait só é suportado pelo programa de inicialização (bootstrapper).

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

O comando a seguir é um exemplo de uso do --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 é utilizado pelo bootstrapper do Visual Studio, e o segundo -Wait é utilizado pelo comando 'Start-Process' para esperar pela sua conclusão. O parâmetro -PassThru é usado por Start-Process para usar o código de saída do instalador para seu valor de retorno.

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 mais mínima do Visual Studio) e o pacote de idioma inglês. Mais exemplos de criação de layout podem ser encontrados 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 o produto completo

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

  vs_enterprise.exe --all
  

Usando --includeRecommended

• Instale uma segunda instância do Visual Studio Professional usando um nome alternativo numa máquina com o Visual Studio Community edition já instalado, com suporte para o desenvolvimento 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
Visual Studio 2022 17.0 canal LTSC	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 lançamento do Visual Studio 2019	https://aka.ms/vs/16/release/channel	VisualStudio.16.Release
Canal de lançamento 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 em que o layout foi baseado)

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

• O --channelUri deve 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 de 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 padrão instalada do Visual Studio. Este exemplo usa o instalador já instalado na máquina cliente. Os usuários padrão com permissões apropriadas podem executar programaticamente o comando modify 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 a partir do mesmo diretório em que o instalador reside.

  "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
  

Não é possível usá--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 de estado fora de suporte da instância padrão instalada do Visual Studio. Este exemplo usa o instalador já instalado na máquina cliente para definir a configuração removeOos. usuários Standard, se tiverem recebido permissões apropriadas, podem executar programaticamente o comando modify usando o instalador, mas não têm permissão para usar o switch --passive ou --quiet. Não é possível iniciar o instalador programaticamente a partir do mesmo diretório em que o instalador reside.

 "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 transferidos para um estado fora de 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, 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 apenas os caminhos de instalação e cache:

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

• Use apenas 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 apenas o caminho de instalação:

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

Utilizar a exportação

• Utilize a exportação para guardar a seleção de uma instalação. Este exemplo usa o instalador já instalado na máquina cliente.

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

• Utilize a função de exportar para guardar a seleção personalizada do zero. Este exemplo usa o instalador já instalado na máquina 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 as cargas de trabalho e os componentes 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 cargas de trabalho e componentes a uma instalação existente. Este exemplo usa o instalador já instalado na máquina cliente. Os usuários padrão com permissões apropriadas podem executar programaticamente o comando modify usando o instalador, mas não têm permissão para usar a opção --passive ou --quiet. Não é possível iniciar o instalador programaticamente a partir do mesmo diretório em que o instalador reside.

  "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 o Gestor de Pacotes do Windows "winget" para instalar ou atualizar de forma programática o Visual Studio nos seus computadores, juntamente com outros pacotes geridos pelo winget. Para personalizar a instalação e especificar outras cargas de trabalho e componentes, podes usar o switch --override do winget juntamente com o comando install, e passar um arquivo vsconfig exportado desta forma:

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

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

Suporte ou solução de problemas

Por vezes, as coisas podem correr mal. Se a instalação do Visual Studio falhar, consulte Solucionar problemas de instalação e atualização do Visual Studio para obter orientação passo a passo.

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

• Utilize a opção de suporte de chat de instalação (apenas em inglês) para problemas relacionados à instalação.
• Comunique-nos problemas de produto usando a ferramenta Report a Problem que aparece no Visual Studio Installer e no IDE do Visual Studio. Se for um administrador de TI e não tiver o Visual Studio instalado, poderá enviar feedback do administrador de TI.
• Sugira um recurso, acompanhe problemas do produto e encontre respostas no da 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
• A carga de trabalho do Visual Studio e IDs de componentes