Compartilhar via

Exemplos de parâmetro de linha de comando para 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 você pode personalizar para atender às suas necessidades.

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

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 maneira não interativa, você pode usar--passive ou --quiet. Para obter mais informações sobre esses parâmetros, consulte os comandos e a página de parâmetros de linha de comando.

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 e --add juntamente com o carregador de inicialização

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

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

  • Instale uma instância de área de trabalho do Visual Studio silenciosamente, com o pacote de idiomas 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

Atualização

  • 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 do Visual Studio. Você precisa executar esses comandos em um prompt de comando com privilégios elevados, pois atualizar o instalador requer permissões de administrador. O exemplo a seguir simula a atualização de um cliente usando um carregador de inicialização 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 sua instância do Visual Studio em uma etapa usando o instalador no cliente. os usuários Standard, se receberem 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 em que o instalador reside.

"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 lote 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 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 outros parâmetros para aguardar a conclusão e obter o valor de retorno do instalador.

O parâmetro --wait só é compatível com o carregador de inicialização.

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 carregador de inicialização 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 utilizar o código de saída do instalador como 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 idiomas em 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 todo o produto

  • Inicie uma instalação interativa de todas as cargas de trabalho e componentes 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, em um computador com o Visual Studio Community Edition já instalado, com suporte para 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
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 qualquer que fosse o layout em que foi 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 padrão do Visual Studio instalada. Este exemplo usa o instalador já instalado no computador cliente. Usuários padrão com permissões apropriadas podem executar programaticamente o comando modificar usando o instalador, mas não têm permissão para usar o switch --passive ou --quiet. Observe que você não pode iniciar o instalador programaticamente no 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

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 do instalador mais recente, você pode modificar uma instalação e remover todos os componentes que fizeram a transição para um estado fora de 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 receberem as 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. Não é possível iniciar o instalador programaticamente no 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" (ferramenta de inicialização).

  • Use a instalação, o cache e os caminhos 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"

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"

Uso do parâmetro --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 no computador cliente. Usuários padrão com permissões apropriadas podem executar de forma programática o comando modificar 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 no 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 a ferramenta Gerenciador de Pacotes do Windows "winget" para instalar ou atualizar programaticamente 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 a opção --override do winget com o comando install do winget e passar em 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 arquivo .yaml 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