Usar parâmetros de linha de comando para instalar, atualizar e gerenciar o Visual Studio

Ao instalar o Visual Studio programaticamente ou a partir do prompt de comando, você pode usar vários parâmetros de linha de comando para controlar ou personalizar a instalação para executar as seguintes ações:

• Iniciar a instalação no cliente com determinadas opções e comportamentos pré-selecionados.
• Automatizar o processo de instalação ou atualização.
• Criar ou manter um layout de rede dos arquivos de produtos para instalar ou atualizar os computadores cliente.

Os seguintes verbos e parâmetros de linha de comando podem ser usados com os seguintes executáveis ou programas:

• O bootstrapper de instalação, que é o arquivo pequeno (cerca de 1 MB) (por exemplo, vs_enterprise.exe) que inicia o processo de download e a instalação inicial.
• O instalador do Visual Studio, que pode já estar instalado no computador e está localizado na pasta C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe. Você precisa iniciar o instalador programaticamente em um diretório diferente em que está o instalador. O instalador é normalmente usado para atualizar ou modificar comandos.
• Com um comando winget usando a opção --override do winget.
• Com um pacote de Atualização do Administrador, que está disponível para download no Catálogo do Microsoft Update, para atualizar programaticamente o layout de rede. Você pode encontrar mais informações no artigo Atualizar ou modificar o layout.

Nem todos os comandos ou parâmetros funcionam em todas essas situações, e quaisquer advertências ou exceções especiais são documentadas. Além disso, em alguns cenários, você pode não ter acesso a todos esses executáveis descritos anteriormente. Por exemplo, computadores clientes poderão ter o instalador disponível para execução programática apenas se o Visual Studio foi instalado por meio de um layout.

Para obter os bootstrappers mais recentes do Visual Studio 2022 que sempre instalarão a versão mais recente do canal Atual, faça o download de um dos arquivos seguintes. Como alternativa, para instalar uma versão específica ou um canal específico do Visual Studio 2022, consulte a página Histórico de Versões do Visual Studio 2022. Esta página tem links para os bootstrappers de versão fixa para cada versão de manutenção.

Edição	Bootstrapper
Visual Studio 2022 Enterprise	vs_enterprise.exe
Visual Studio 2022 Professional	vs_professional.exe
Visual Studio 2022 Community	vs_community.exe
Ferramentas de Build do Visual Studio 2022	vs_buildtools.exe

Dica

Se você baixou anteriormente um arquivo de bootstrapper e deseja verificar qual versão ele instalará, confira como fazer. No Windows, abra o Explorador de Arquivos, clique com o botão direito do mouse no arquivo bootstrapper, escolha Propriedades e escolha a guia Detalhes. O campo Versão do produto descreverá o canal e a versão que o bootstrapper instalará. O número de versão sempre deve ser lido como "versão de manutenção mais recente do que é especificado", e o canal é Atual, a menos que especificado explicitamente. Portanto, um bootstrapper com uma Versão de produto do LTSC 17.0 instalará a versão de manutenção 17.0.x mais recente disponível no canal LTSC 17.0. Um bootstrapper com uma Versão de produto que simplesmente diz que o Visual Studio 2022 instalará a versão mais recente do Visual Studio 2022 no canal Atual.

Parâmetros de linha de comando e comandos Instalar, Atualizar, Modificar, Reparar, Desinstalar e Exportar

Ao invocar o bootstrapper do Visual Studio ou o instalador programaticamente para instalar o produto ou manter um layout:

• O primeiro parâmetro é o comando (o verbo) que descreve a operação a ser executada.
• Os parâmetros de linha de comando opcionais subsequentes, todos prefixados por dois traços (--), definem ainda mais como essa operação deve acontecer.

Todos os parâmetros de linha de comando do Visual Studio não diferenciam maiúsculas de minúsculas e você pode encontrar mais exemplos na página Exemplos de parâmetro de linha de comando.

Exemplo de sintaxe: vs_enterprise.exe [command] <optional parameters>...

Comando	Descrição
(blank)	O comando padrão instala o produto e é usado para todas as operações de manutenção de layout.
modify	Modifica um produto instalado.
update	Atualiza um produto instalado.
updateall	Atualiza todos os produtos instalados em ordem sequencial. Funciona com os parâmetros --quiet e --passive.
repair	Repara um produto instalado.
uninstall	Desinstala um produto instalado.
export	Exporta a configuração de instalação para um arquivo *.vsconfig.

Importante

Ao especificar várias cargas de trabalho, componentes ou idiomas, é necessário repetir a opção de linha de comando --add ou --remove para cada item.

Parâmetros	Descrição
--installPath <dir>	Para o comando de instalação padrão, esse parâmetro é Opcional e descreve onde a instância é instalada no computador cliente. Para outros comandos, como atualizar ou modificar, esse parâmetro é Obrigatório e indica o diretório de instalação para a instância agir.
--productId <id>	Opcional: a ID da instância do produto que é modificada e usada com --channelId. O productID é algo como "Microsoft.VisualStudio.Product.Enterprise".
--channelUri	Opcional: durante um comando de atualização, você pode passar um novo --channelUri para alterar o local das configurações de atualização. É recomendável emparelhar com o parâmetro --installPath para que fique bem explícito qual instância do Visual Studio você está configurando. Veja exemplos de sintaxe de --channelUri
--channelId <id>	A ID do canal, por exemplo, VisualStudio.17.Release. Veja exemplos de sintaxe de --channelId. channelId é necessário para operações de modificação, juntamente com um --productID ou --installPath.
--add <one or more workload or component IDs>	Opcional: durante um comando de instalação ou modificação, esse parâmetro repetível especifica uma ou mais IDs de carga de trabalho ou de componente a serem adicionadas. Os componentes obrigatórios do artefato são instalados, mas não os componentes recomendados ou opcionais. Você pode controlar outros componentes globalmente usando os parâmetros --includeRecommended e/ou --includeOptional. Para incluir várias cargas de trabalho ou componentes, repita o comando --add (por exemplo, --add Workload1 --add Workload2). Para ter um controle mais refinado, você pode acrescentar ;includeRecommended ou ;includeOptional à ID (por exemplo, --add Workload1;includeRecommended ou --add Workload2;includeRecommended;includeOptional). Para saber mais, confira a página IDs de carga de trabalho e de componente.
--all	Opcional: durante um comando de instalação ou modificação, esse parâmetro faz com que todas as cargas de trabalho e componentes do produto sejam instalados.
--allWorkloads	Opcional: durante um comando de instalação ou modificação, esse parâmetro instala todas as cargas de trabalho e componentes, mas nenhum componente recomendado ou opcional.
--includeRecommended	Opcional: durante um comando de instalação ou modificação, esse parâmetro inclui os componentes recomendados para todas as cargas de trabalho instaladas. Não inclui os componentes opcionais. As cargas de trabalho são especificadas com --allWorkloads ou --add. Observe que, usando o parâmetro --includeRecommended, você ativará a caixa de diálogo Configurações de atualização para "adicionar componentes recomendados para cargas de trabalho instaladas na atualização". Consulte Personalizar configurações de atualização para alterar essa configuração.
--includeOptional	Opcional: durante um comando de instalação ou modificação, esse parâmetro inclui os componentes opcionais para todas as cargas de trabalho instaladas. Não inclui os componentes recomendados. As cargas de trabalho são especificadas com --allWorkloads ou --add.
--addProductLang <language-locale>	Opcional: durante um comando de instalação ou modificação, esse parâmetro repetível especifica os pacotes de idiomas da interface do usuário que devem ser instalados com o produto. Se não estiver presente, a instalação usará o pacote de idiomas que corresponde à localidade do computador. Para obter mais informações, consulte a seção [Lista de localidades de idioma]
--remove <one or more workload or component IDs>	Opcional: durante um comando de modificação, esse parâmetro repetível especifica uma ou mais IDs de carga de trabalho ou de componente a serem removidas. Ele complementa e se comporta de forma semelhante ao parâmetro --add.
(#list-of-language-locales) nesta página.
--removeProductLang <language-locale>	Opcional: durante um comando de instalação ou modificação, esse parâmetro repetível determina os pacotes de idiomas da interface do usuário que devem ser removidos do produto. Ele complementa e se comporta de forma semelhante ao parâmetro --addProductLang.
--in <path>	Opcional: o URI ou o caminho para um arquivo de resposta, que pode conter definições de configuração.
--quiet	Opcional: usado com qualquer comando, esse parâmetro impede que qualquer interface do usuário seja exibida enquanto o comando está sendo executado. Não está disponível para uso programaticamente por usuários padrão, independentemente de como a política AllowStandardUserControl está definida.
--passive, -p	Opcional: esse parâmetro faz com que a interface do usuário seja exibida de maneira não interativa. Esse parâmetro é mutuamente exclusivo (e, de fato, substitui) do parâmetro --quiet. Também não está disponível para uso programaticamente por usuários padrão, independentemente de como a política AllowStandardUserControl está definida.
--norestart	Opcional: esse parâmetro deve ser emparelhado com os parâmetros --passive ou --quiet. Durante um comando de instalação, atualização ou modificação, a adição do parâmetro --norestart atrasa qualquer reinicialização necessária.
--force	Opcional: esse parâmetro força o Visual Studio a fechar, mesmo que o processo do Visual Studio esteja em uso. Forçar o Visual Studio a fechar pode causar perda de trabalho, portanto, use-o com cuidado.
--installWhileDownloading	Opcional: durante um comando de instalação, atualização ou modificação, esse parâmetro permite que o Visual Studio faça o download e instale o produto em paralelo. Essa é a experiência padrão.
--downloadThenInstall	Opcional: durante um comando de instalação, atualização ou modificação, esse parâmetro força o Visual Studio a fazer o download de todos os arquivos antes de instalá-los. Ele é mutuamente exclusivo do parâmetro --installWhileDownloading.
--nickname <name>	Opcional: durante um comando de instalação, esse parâmetro define o apelido a ser atribuído a um produto instalado. O apelido não pode ter mais de 10 caracteres.
--productKey	Opcional: durante um comando de instalação, esse parâmetro define a chave do produto (Product Key) a ser atribuída a um produto instalado. A chave do produto é composta por 25 caracteres alfanuméricos no formato xxxxxxxxxxxxxxxxxxxxxxxxx.
--removeOos true	Opcional: durante um comando de instalação, atualização ou modificação, este parâmetro, seguido por true ou false, informa ao Instalador do Visual Studio se todos os componentes instalados devem ser removidos e transferidos para um estado sem suporte. Esse comportamento é aplicável a um único evento. Se você quiser tornar esse comportamento persistente, aplique esse parâmetro ao comando modifySettings, descrito posteriormente, ou configure a política global removeOOS. Útil para ajudar a manter o computador seguro.
--config <path to *.vsconfig file>	Opcional: durante uma operação de instalação ou modificação, você pode passar um arquivo de configuração usando o --config parâmetro para especificar as cargas de trabalho, os componentes ou as extensões a serem adicionadas com base em um arquivo de configuração de instalação salvo anteriormente. Esta operação é apenas aditiva; ele não remove nada não especificado no arquivo. Além disso, os itens especificados no arquivo de configuração que não se aplicam ao produto não são adicionados. É altamente recomendável que você especifique o caminho totalmente qualificado para o arquivo de configuração. Durante uma operação de exportação, esse parâmetro determina a localização para salvar o arquivo de configuração de instalação.
--allowUnsignedExtensions	Opcional: durante uma operação de instalação ou modificação executada em um contexto --passive ou --quiet usando um arquivo --config, se as extensões forem especificadas no arquivo de configuração, esse parâmetro será necessário para carregar extensões sem uma assinatura digital.
--installerOnly	Opcional: durante uma operação de instalação ou atualização, esse parâmetro informa ao instalador do Visual Studio para instalar apenas a si mesmo (o instalador) e não o produto Visual Studio. Sua funcionalidade é equivalente ao parâmetro --update, porém mais intuitiva. Destinado a ser usado ao preparar e pré-configurar máquinas cliente.
--help, --?, -h, -?	Exibe uma versão offline desta página.

Comando de layout e parâmetros de linha de comando

Todas as operações de gerenciamento de layout, como criar ou atualizar um layout, são executadas usando o bootstrapper exe e pressupõem que o comando é a instalação padrão (em branco). Todas as operações de gerenciamento de layout devem começar com o parâmetro inicial --layout necessário. A tabela a seguir descreve os outros parâmetros que você pode usar para criar ou atualizar um layout usando a linha de comando.

Parâmetros de layout	Descrição
--layout <dir>	Especifica um diretório para criar ou atualizar um cache de instalação offline. Para obter mais informações, consulte Criar uma instalação baseada em rede do Visual Studio.
--lang <one or more language-locales>	Opcional: usado com --layout para preparar um cache de instalação offline com pacotes de recursos com um ou mais idiomas especificados. Para obter mais informações, consulte a seção Lista de localidades de idioma nesta página.
--add <one or more workload or component IDs>	Opcional: uma ou mais IDs de carga de trabalho ou de componente a serem adicionadas. Os componentes obrigatórios do artefato são instalados, mas não os componentes recomendados ou opcionais. Você pode controlar mais componentes globalmente usando --includeRecommended e/ou --includeOptional. Para ter um controle mais refinado, você pode acrescentar ;includeRecommended ou ;includeOptional à ID (por exemplo, --add Workload1;includeRecommended ou --add Workload2;includeOptional). Para saber mais, confira a página IDs de carga de trabalho e de componente. Observação: se --add for usado, somente as cargas de trabalho especificadas e os componentes e suas dependências serão baixados. Se --add não for especificado, todas as cargas de trabalho e componentes serão baixados para o layout.
--includeRecommended	Opcional: inclui os componentes recomendados para as cargas de trabalho que estão instaladas, mas não os componentes opcionais. As cargas de trabalho são especificadas com --allWorkloads ou --add.
--includeOptional	Opcional: inclui os componentes recomendados e opcionais para quaisquer cargas de trabalho incluídas no layout. As cargas de trabalho são especificadas com --add.
--wait	Opcional: o processo aguardará até que a instalação seja concluída, antes de retornar um código de saída. wait é útil ao automatizar instalações onde é necessário aguardar a conclusão da instalação para lidar com o código de retorno dessa instalação. O parâmetro --wait só pode ser passado para o bootstrapper, o instalador (setup.exe) não o suporta. É útil ao atualizar layouts. Mais exemplos podem ser encontrados aqui.
--useLatestInstaller	Opcional: funcionalidade herdada que só é aplicável para bootstrappers do Visual Studio anteriores a abril de 2023. Qualquer coisa enviada após abril de 2023 usa o instalador mais recente por padrão. Se esse parâmetro estiver presente, a versão mais recente do Instalador do Visual Studio será incluída em seu layout, mesmo que pertença a uma versão principal mais recente do produto. O instalador mais recente pode ser útil se você quiser aproveitar novos recursos ou correções de bugs disponíveis em sua versão mais recente. Para obter mais informações, confira Configurar o layout para sempre usar a documentação mais recente do instalador.
--config <path to *.vsconfig file>	Opcional: se presente, o Visual Studio usará o conteúdo do arquivo de configuração para configurar o layout. Certifique-se de especificar o caminho totalmente qualificado para o arquivo de configuração.
--noWeb	Opcional: se presente, a instalação do Visual Studio usa os arquivos no diretório de layout para instalar o Visual Studio e não baixa nenhum pacote da Web. Se o usuário tentar instalar componentes que não estejam no layout, a instalação falhará. Não use esse parâmetro se você estiver tentando implantar um layout hospedado em um site interno da intranet. Para obter mais informações, confira Instalar em um cliente que não tem acesso à Internet. Importante: o parâmetro --noWeb não impede que o Instalador do Visual Studio em um computador cliente conectado à Internet verifique se há atualizações quando o cliente está configurado para examinar os servidores hospedados pela Microsoft em busca de atualizações. Nesse caso, --noWeb simplesmente impede que o cliente baixe os pacotes do produto.
--verify	Opcional: verifique o conteúdo de um layout. Todos os arquivos corrompidos ou ausentes são listados.
--fix	Opcional: verifique o conteúdo de um layout. Se algum arquivo estiver corrompido ou ausente, ele será baixado novamente. Para corrigir um layout, é necessário acesso à Internet.
--clean <one or more paths to catalogs>	Opcional: remove versões antigas dos componentes de um layout atualizado para uma versão mais recente.

Parâmetros de layout avançado	Descrição
--channelId <id>	Opcional: a ID do canal para a instância a ser instalada, representada como VisualStudio.17.Release. channelId é necessário para o comando de instalação e ignorado para outros comandos, se --installPath estiver especificado. Confira exemplos de sintaxe de --channelId.
--channelUri <uri>	Opcional: o URI do manifesto do canal. Esse valor rege o local de origem das atualizações e o valor inicial é configurado no arquivo response.json do layout. Confira os exemplos de sintaxe de --channelUri para obter os valores possíveis. Se não desejar as atualizações, --channelUri poderá apontar para um arquivo inexistente (por exemplo, --channelUri C:\doesntExist.chman). Este parâmetro pode ser usado para o comando de instalação; outros comandos o ignoram.
--installChannelUri <uri>	Opcional: o URI do manifesto do canal a ser usado para a instalação. O URI especificado por --channelUri (que deve ser especificado quando --installChannelUri for especificado) é usado para detectar atualizações. Este parâmetro pode ser usado para o comando de instalação; outros comandos o ignoram.
--installCatalogUri <uri>	Opcional: o URI do manifesto do catálogo a ser usado para a instalação. Se especificado, o gerente de canal tenta baixar o manifesto do catálogo desse URI antes de usar o URI no manifesto do canal de instalação. Esse parâmetro é usado para dar suporte a instalação offline, em que o cache de layout é criado com o catálogo de produtos que já foi baixado. Este parâmetro pode ser usado para o comando de instalação; outros comandos o ignoram.
--productId <id>	Opcional: a ID do produto para a instância que é instalada. Esse parâmetro será preenchido previamente em condições normais de instalação. O productID é algo como "Microsoft.VisualStudio.Product.Enterprise".
--arch all	Opcional: por padrão, os layouts são criados com apenas binários de produtos x64. Para incluir binários do ARM para cargas de trabalho aplicáveis junto com os binários de x64 em um layout, use o parâmetro --arch all ou --arch *. Para criar um layout apenas de binários do ARM, use --arch arm64
--keepLayoutVersion	Opcional: aplique as alterações ao layout sem atualizar a versão do produto incluída no layout.
--locale <language-locale>	Opcional: alterar o idioma de exibição da interface do usuário do próprio instalador. A configuração será mantida. Para obter mais informações, consulte a seção Lista de localidades de idioma nesta página.
--cache	Opcional: caso presentes, os pacotes serão mantidos após a instalação para reparos subsequentes. Isso substitui a configuração de política global a ser usada para instalações, reparos ou modificações subsequentes. A política padrão é armazenar pacotes em cache. Isso é ignorado para o comando de desinstalação. Leia sobre como desabilitar ou mover o cache do pacote para obter mais informações.
--nocache	Opcional: caso presentes, os pacotes serão ser excluídos depois de serem instalados ou reparados. Serão feitos os downloads novamente apenas se for necessário e excluídos após o uso. Isso substitui a configuração de política global a ser usada para instalações, reparos ou modificações subsequentes. A política padrão é armazenar pacotes em cache. Isso é ignorado para o comando de desinstalação. Leia sobre como desabilitar ou mover o cache do pacote para obter mais informações.
--noUpdateInstaller	Opcional: se existir, impede que instalador atualize a si próprio quando o modo silencioso é especificado. O comando do instalador falhará e retornará um código de saída diferente de zero se noUpdateInstaller for especificado como silencioso quando uma atualização do instalador for necessária.
--path <name>=<path>	Opcional: usado para especificar caminhos de instalação personalizados para a instalação. Os nomes de caminho com suporte são shared, cache e install.
--path cache=<path>	Opcional: usa o local especificado para baixar os arquivos de instalação. Este local só pode ser definido na primeira vez em que o Visual Studio é instalado. Exemplo: --path cache="C:\VS\cache"
--path shared=<path>	Opcional: contém arquivos compartilhados para instalações do Visual Studio lado a lado. Algumas ferramentas e SDKs fazem instalações em um local nessa unidade, enquanto outros podem substituir essa configuração e fazer a instalação em outra unidade. Exemplo: --path shared="C:\VS\shared" Importante: isso pode ser definido apenas uma vez e na primeira vez que o Visual Studio é instalado.
--path install=<path>	Opcional: equivalente a –-installPath. Especificamente, --installPath "C:\VS" e --path install="C:\VS" são equivalentes. Apenas um destes comandos pode ser usado por vez.

Parâmetros de linha de comando e comando ModifySettings

Você pode modificar as configurações de atualização e configurar programaticamente o local de origem das atualizações para uma determinada instância do Visual Studio usando o instalador ou o bootstrapper no computador cliente e passando o comando modifySettings e o canal de atualização desejado.

Comando	Descrição
modifySettings	Verbo usado para modificar as configurações de atualização de uma instância específica do Visual Studio.

Parâmetros modifySettings	Descrição
--installPath <dir>	É recomendável usar para especificar em qual instância do Visual Studio deve-se agir.
--newChannelUri	Obrigatório: o URI do manifesto do canal. Esse valor especifica onde será o próximo local de origem das atualizações. Confira os exemplos de sintaxe de --channelUri para obter os valores possíveis. Se não desejar as atualizações, --channelUri poderá apontar para um arquivo inexistente (por exemplo, --channelUri C:\doesntExist.chman).
--channelUri	O URI do antigo manifesto do canal. Pode ser usado se o --installPath não for conhecido. Deve ser usado em conjunto com productID para identificar a instância certa para agir.
--productId <id>	Deve ser usado se --channelUri for especificado e for usado para identificar a instância certa para agir. O productID é algo como "Microsoft.VisualStudio.Product.Enterprise".
--includeRecommended	Opcional: durante um comando modifySettings, esse parâmetro (que deve ter a palavra true ou false logo depois dele) informa ao instalador do Visual Studio para desabilitar a funcionalidade "adicionar componentes recomendados para cargas de trabalho instaladas na atualização" na caixa de diálogo Configuração de atualização.
--quiet	Opcional: esse parâmetro impede que qualquer interface do usuário seja exibida enquanto o comando está sendo executado. Não disponível para ser utilizado programaticamente por usuários standard.
--removeOos true	Opcional: durante um comando modifySettings, esse parâmetro (que deve ter a palavra true ou false imediatamente após ele) informa ao instalador do Visual Studio para remover persistentemente (ou não remover) todos os componentes instalados que passaram para um estado sem suporte. Útil para ajudar a manter o computador seguro.

Exemplos de sintaxe:

C:\>"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modifySettings --installPath "C:\Program Files\Microsoft\Visual Studio\2022\Enterprise" --newChannelUri https://aka.ms/vs/17/release.LTSC.17.0/channel --removeOos true

 C:\>"C:\Program Files\Microsoft\Visual Studio\2022\Enterprise\vs_enterprise.exe" modifySettings --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

Parâmetros de comando e de linha de comando de reversão

A partir do Visual Studio 2022, você pode reverter a atualização programaticamente usando o instalador no computador cliente e passando o comando de reversão junto com a instância do caminho de instalação.

Comando	Descrição
rollback	Comando para reverter uma instância específica do Visual Studio para a atualização instalada anteriormente. Esse comando não funcionará se o DisableRollback estiver habilitado.

parâmetros de reversão	Descrição
--installPath <dir>	É recomendável usar para especificar em qual instância do Visual Studio deve-se agir.

Exemplos de sintaxe:

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" rollback -–installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise"

Parâmetros de comando e de linha de comando de Atualização de Administrador

Você pode fazer download de uma Atualização de Administrador no Catálogo do Microsoft Update e usá-la para atualizar a instalação do cliente ou o layout.

Atualizar o layout

Se você estiver atualizando um layout para uma versão específica do Visual Studio, basta fazer download da Atualização de Administrador para o computador que hospeda o layout, abrir um prompt de comando nesse computador e executar um comando como este:

visualstudioupdate-17.0.0to17.1.5.exe layout --layoutPath c:\VSLayout

Atualizar o cliente

No cliente, se você baixar a Atualização de Administrador no diretório de instalação do computador cliente, basta clicar duas vezes no arquivo para aplicar a atualização. Você também pode abrir uma janela de comando e passar alguns dos parâmetros abaixo para alterar o comportamento padrão.

Configurar a Atualização de Administrador no SCCM

Se você estiver implantando a atualização de administrador por meio do SCCM (Microsoft Endpoint Manager), modifique o pacote para ajustar o comportamento usando os parâmetros abaixo. Você também pode controlar os parâmetros por meio de um arquivo de configuração no computador cliente. Para obter mais informações, confira Métodos para configurar uma atualização de administrador

Observe que todos os parâmetros de Atualização de Administrador são executados por padrão no contexto de "atualização", a menos que o verbo de layout seja especificado.

Parâmetros de atualização de administrador	Descrição
--installerUpdateArgs [optional parameters]	Esse parâmetro funciona como uma "matriz de passagem" de parâmetros específicos relevantes para cenários de atualização de administrador. Os parâmetros opcionais habilitados para essa finalidade são: --quiet: essa é a experiência padrão para atualizações de administrador e está listada aqui para integridade. --passive: esse parâmetro substitui o parâmetro --quiet. Isso faz com que a interface do usuário apareça de maneira não interativa. --norestart: esse parâmetro deve ser usado em conjunto com --quiet ou --passive e faz com que todas as reinicializações necessárias sejam atrasadas. --noWeb: esse parâmetro impede que o Visual Studio verifique na Internet se há atualizações do produto. --force: esse parâmetro força o Visual Studio a fechar mesmo que o Visual Studio esteja em uso. Use esse parâmetro com cuidado, pois pode causar perda de trabalho. Esse parâmetro só deve ser usado quando a Atualização de administrador é executada no contexto do usuário; ele será ignorado se a Atualização de administrador for executada no contexto do sistema. --installWhileDownloading: esse parâmetro permite que o Visual Studio faça o download e instale o produto em paralelo. Essa é a experiência padrão para atualizações de administrador e está listada aqui para integridade. --keepWindowsUpdateOn: esse parâmetro impede que o instalador desative o agente Windows Update no cliente. Você deverá usar esse parâmetro se estiver importando uma Atualização de Administrador do Catálogo no SCCM. Talvez você também precise definir o tempo limite do pacote SCCM para ser maior do que os 10 minutos padrão. Alterar o tipo de implantação do SCCM para ser Obrigatório torna esse parâmetro desnecessário. --downloadThenInstall: esse parâmetro força o Visual Studio a fazer download de todos os arquivos antes de instalá-los. Ele é mutuamente exclusivo do parâmetro --installWhileDownloading.
--checkPendingReboot	A atualização será anulada se houver uma reinicialização pendente no computador, independentemente de qual aplicativo possa tê-la causado. O padrão é não verificar se há reinicializações pendentes.

Exemplo de sintaxe para passar parâmetros para uma Atualização de Administrador:

visualstudioupdate-16.9.0to16.9.4.exe --installerUpdateArgs=--force,--noWeb,--keepWindowsUpdateOn --checkPendingReboot

Parâmetros de comando e de linha de comando de remoção

Canais que estão disponíveis para atualização são armazenados em cache no cliente e, com o tempo, podem desordenar as coisas. Você pode remover manualmente os canais de atualização acessando o Instalador do Visual Studio, indo para a guia Disponível e clicando no X no canto superior direito do cartão do produto. Você pode remover canais programaticamente (por exemplo, locais de layout mais antigos) usando o comando removeChannel. Você pode executar vswhere programaticamente no computador cliente para determinar quais canais são armazenados em cache no computador cliente.

Comando	Descrição
removeChannel	Comando para remover um canal do computador cliente.

parâmetros removeChannel	Descrição
--channelUri	Obrigatório: o URI do antigo manifesto do canal.
--quiet	Opcional: esse parâmetro impede que qualquer interface do usuário seja exibida enquanto o comando está sendo executado.
--passive	Opcional: esse parâmetro substitui o parâmetro --quiet. Isso faz com que a interface do usuário apareça de maneira não interativa.

Exemplo de sintaxe:

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" removeChannel --channelUri "\\\\server\\share\\layoutdirectory\\ChannelManifest.json"

Usar winget para instalar ou modificar o Visual Studio

Você pode usar a ferramenta "winget" do Gerenciador de Pacotes do Windows para instalar, modificar ou atualizar por meio de programação o Visual Studio em seu computador, juntamente com outros pacotes gerenciados pelo winget.

Por padrão, o winget instala apenas a carga de trabalho principal do Visual Studio.

winget install --id Microsoft.VisualStudio.2022.Community

No entanto, se você quiser personalizar a instalação e especificar cargas de trabalho e componentes adicionais a serem adquiridos durante a instalação inicial, poderá usar a opção --override do winget ao lado do comando install do winget e passar um arquivo vsconfig exportado que contém as cargas de trabalho e os componentes a serem adicionados:

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

Você também pode apenas incluir componentes diretamente durante a instalação inicial, desta forma:

 winget install --id Microsoft.VisualStudio.2022.Community --override "--quiet --add Microsoft.Visualstudio.Workload.Azure"

Se você já tiver o Visual Studio instalado em seu computador, será possível usar o configure comando do winget junto com o provedor DSC do Visual Studio PowerShell, um arquivo yaml e um arquivo .vsconfig para adicionar componentes a uma instalação existente do Visual Studio. O comando configure do Winget atua essencialmente como uma operação de "modificação" do Visual Studio. Consulte como criar um arquivo de configuração do WinGet para saber como criar uma configuração winget.

Não é possível usar a opção --override ou o provedor DSC do Visual Studio junto com o comando upgrade do winget, pois upgrade essencialmente atua apenas como uma operação de "atualização" do Visual Studio e instala a versão mais recente dos componentes que você já selecionou. Você não pode adicionar componentes por meio de uma atualização/atualização. Você precisa usar o configure do winget para adicionar componentes.

Observe que as operações do Instalador do Visual Studio no momento exigem privilégios de administrador, portanto, o winget solicitará que você eleve seus privilégios, se necessário, para concluir o comando. Além disso, atualmente não é possível usar o winget para instalar várias edições (ou seja, SKUs diferentes) ou várias instâncias do mesmo SKU ao mesmo tempo em um computador cliente. Por fim, o Visual Studio deverá ser fechado se você quiser configurá-lo (modificá-lo) para adicionar componentes ou atualizá-lo para a versão mais recente.

Lista de IDs de carga de trabalho e IDs de componente

Confira uma lista de IDs de componente e de carga de trabalho classificadas por produto do Visual Studio na página IDs de componente e de carga de trabalho do Visual Studio.

Lista de localidades de idioma

Localidade de idioma	Idioma
Cs-cz	Tcheco
De-de	Alemão
En-us	Inglês
Es-es	Espanhol
Fr-fr	Francês
It-it	Italiano
Ja-jp	Japonês
Ko-kr	Coreano
Pl-pl	Polonês
Pt-br	Português - Brasil
Ru-ru	Russo
Tr-tr	Turco
Zh-cn	Chinês - Simplificado
Zh-tw	Chinês - Tradicional

Códigos de erro

Dependendo do resultado da operação, a variável de ambiente %ERRORLEVEL% será definida como um dos valores a seguir:

Valor	Resultado
0	A operação foi concluída com êxito
740	Elevação necessária
1001	O processo do instalador do Visual Studio está em execução
1003	O Visual Studio está em uso
1602	A operação foi cancelada
1618	Outra instalação em execução
1641	A operação foi concluída com êxito e a reinicialização foi iniciada
3010	A operação foi concluída com êxito, mas a instalação requer a reinicialização antes de ser usada
5003	O inicializador falhou ao baixar o instalador
5004	A operação foi cancelada
5005	Erro de análise de linha de comando do inicializador
5007	A operação foi bloqueada – o computador não atende aos requisitos
8001	Falha na verificação do computador Arm
8002	Falha de pré-verificação de download em segundo plano
8003	Falha selecionável sem suporte
8004	Falha no diretório de destino
8005	Falha de verificação de conteúdo de origem
8006	Processos do Visual Studio em execução
8010	Sistema operacional sem suporte. Consulte os Requisitos do Sistema
-1073720687	Falha de conectividade
–1073741510	O Instalador do Microsoft Visual Studio foi terminado (por usuário ou processo externo)
Outro (por exemplo: -1, 1, 1.603)	Condição de falha ocorreu. Verifique os logs para obter mais informações

Cada operação gera vários arquivos de log no diretório %TEMP% que indicam o progresso da instalação. Classifique a pasta por data e procure arquivos começando com dd_bootstrapper, dd_client e dd_setup para o bootstrapper, o aplicativo instalador e o mecanismo de instalação, respectivamente.

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

• Exemplos de parâmetros de linha de comando para a instalação do Visual Studio
• Criar uma instalação offline do Visual Studio
• Automatizar a instalação do Visual Studio com um arquivo de resposta
• IDs de carga de trabalho e de componente do Visual Studio