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.exe
e 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 porStart-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 .