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

Quando você instala o Visual Studio programaticamente ou a partir de um 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:

• Inicie a instalação no cliente com determinadas opções e comportamentos pré-selecionados.
• Automatize o processo de instalação ou atualização.
• Crie ou mantenha um layout de rede dos arquivos do produto para instalar ou atualizar máquinas 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 é um pequeno arquivo (~1 MB) (por exemplo, vs_enterprise.exe) que inicia o processo de download e a instalação propriamente dita.
• O instalador do Visual Studio que já pode estar instalado na máquina e está localizado na pasta C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe. Você deve iniciar o instalador programaticamente a partir de um diretório diferente no qual o instalador reside. O instalador é normalmente usado para atualizar ou modificar comandos.
• Com um comando do tipo 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 seu layout de rede. Mais informações podem ser encontradas no artigo Atualizar ou modificar o layout.

Nem todos os comandos ou parâmetros funcionam em cada uma dessas 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, máquinas cliente só podem ter o instalador disponível para execução programática se o Visual Studio foi instalado por meio de um layout.

Para obter os bootstrappers mais recentes para o Visual Studio 2022 que sempre instalam a versão mais recente do canal atual, baixe um dos arquivos na tabela a seguir. 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 Profissional	vs_professional.exe
Comunidade do Visual Studio 2022	vs_community.exe
Ferramentas de compilação do Visual Studio 2022	vs_buildtools.exe

Dica

Se você baixou anteriormente um arquivo de bootstrapper e deseja verificar qual versão ele será instalado, veja como. No Windows, abra o Explorador de Ficheiros, clique com o botão direito do rato no ficheiro de bootstrapper, escolha Propriedades e, em seguida, escolha o separador Detalhes do . O campo Versão do Produto descreverá o canal e a versão que o bootstrapper instalará. O número da versão deve ser interpretado sempre como "última versão de manutenção do que é especificado", e o canal é Atual, a menos que especificado explicitamente. Assim, um bootstrapper com uma versão de produto LTSC 17.0 instalará a versão de serviço 17.0.x mais recente que estiver disponível no canal LTSC 17.0. Um bootstrapper com uma versão do Produto que simplesmente diz Visual Studio 2022 instalará a versão mais recente do Visual Studio 2022 no Canal Atual.

Instalar, atualizar, modificar, reparar, desinstalar e exportar comandos e parâmetros de linha de comando

Ao invocar o bootstrapper do Visual Studio ou o instalador de forma programática para instalar o produto ou manter um layout.

• O primeiro parâmetro é o comando (o verbo) que descreve a operação a executar.
• Os parâmetros de linha de comando opcionais subsequentes, todos prefixados por dois traços (--), definem melhor 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 mais exemplos podem ser encontrados na página Exemplos de parâmetros de linha de comando.

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

Comando	Descrição
(em branco)	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 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 distintos, você deve 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 está instalada na máquina cliente. Para outros comandos, como atualizar ou modificar, esse parâmetro é Required e indica o diretório de instalação para a instância agir.
--productId <id>	Opcional: o ID da instância do produto que é modificado e utilizado com --channelId. O productID é algo como "Microsoft.VisualStudio.Product.Enterprise".
--channelUri	opcional: Durante um comando de atualização, você pode passar uma nova --channelUri para alterar o local das configurações de atualização. Recomenda-se emparelhar com o parâmetro --installPath para tornar explícito qual instância do Visual Studio está a configurar. Veja exemplos de sintaxe de --channelUri
--channelId <id>	O ID do canal, por exemplo, VisualStudio.17.Release. Veja os exemplos de sintaxe de --channelId. channelId é necessário para modificar operações, juntamente com --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 componente a serem adicionadas. Os componentes necessários do artefato são instalados, mas não os componentes recomendados ou opcionais. Você pode controlar outros componentes globalmente usando 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 um controle mais refinado, você pode acrescentar ;includeRecommended ou ;includeOptional ao ID (por exemplo, --add Workload1;includeRecommended ou --add Workload2;includeRecommended;includeOptional). Para obter mais informações, consulte a página Workload and component IDs.
--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 , você ativará a caixa de diálogo Configurações de Atualização do 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 da máquina. Para obter mais informações, consulte a [Lista de localidades de idiomas]
--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 componente a serem removidas. Complementa e comporta-se de forma semelhante ao parâmetro --add.
(#lista-de-línguas-locais) em esta 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. Complementa e comporta-se de forma semelhante ao parâmetro --addProductLang.
--in <path>	opcional: O URI ou caminho para um arquivo de resposta , que pode conter definições de configuração.
--quiet	Opcional: Usado com qualquer comando, este parâmetro impede que qualquer interface do usuário seja exibida enquanto o comando está sendo executado. Não está disponível para uso programático por usuários padrão, independentemente de como o de política AllowStandardUserControl está definido.
--passive, -p	opcional: Este parâmetro faz com que a interface do usuário seja exibida de maneira não interativa. Este parâmetro é mutuamente exclusivo em relação ao parâmetro --quiet (e de facto, substitui-o). Também não está disponível para uso programático por utilizadores padrão, independentemente de como a política AllowStandardUserControl está definida.
--norestart	opcional: Este parâmetro deve ser emparelhado com os parâmetros --passive ou --quiet. Durante um comando de instalação, atualização ou modificação, adicionar o parâmetro --norestart atrasa qualquer reinicialização necessária.
--force	opcional: Este parâmetro força o Visual Studio a fechar mesmo se qualquer processo do Visual Studio estiver 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 baixe e instale o produto em paralelo. É 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 baixar todos os arquivos antes de instalá-los. É mutuamente exclusivo do parâmetro --installWhileDownloading.
--nickname <name>	opcional: Durante um comando de instalação, este parâmetro define o apelido a ser atribuído a um produto instalado. A alcunha 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 usada para um produto instalado. A chave do produto (Product Key) é composta por 25 caracteres alfanuméricos no formato xxxxxxxxxxxxxxxxxxxxxxxxx.
--removeOos true	opcional: Durante um comando de instalação, atualização ou modificação, esse parâmetro, seguido por true ou false, informa ao instalador do Visual Studio se deve remover todos os componentes instalados em transição para um estado fora de 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 política global removeOOS. Útil para ajudar a manter a máquina segura.
--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 parâmetro --config para especificar as cargas de trabalho, componentes ou extensões a serem adicionados 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 o local 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, mas mais intuitiva. Destina-se a ser usado durante a preparação e pré-configuração de 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 assumem que o comando é o padrão Install (em branco). Todas as operações de gerenciamento de layout devem começar com o parâmetro necessário --layout inicial. 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 secção Lista de localidades de idiomas nesta página.
--add <one or more workload or component IDs>	opcional: uma ou mais IDs de carga de trabalho ou componente a serem adicionadas. Os componentes necessá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 um controle mais refinado, você pode acrescentar ;includeRecommended ou ;includeOptional ao ID (por exemplo, --add Workload1;includeRecommended ou --add Workload2;includeOptional). Para obter mais informações, consulte a página Workload and component IDs. Nota: Se --add for usado, somente as cargas de trabalho e componentes especificados 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 quaisquer cargas de trabalho instaladas, mas não os componentes opcionais. As cargas de trabalho são especificadas com --allWorkloads ou --add.
--includeOptional	opcional: Inclui os componentes e opcionais recomendados para todas as cargas de trabalho incluídas no layout. As cargas de trabalho são especificadas com --add.
--wait	opcional: O processo aguarda até que a instalação seja concluída antes de retornar um código de saída. wait é útil ao automatizar instalações em que é 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 Visual Studio Installer será incluída no 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 os novos recursos ou correções de bugs que estão disponíveis em sua versão mais recente. Para obter mais informações, consulte a documentação Configurar o layout para sempre usar o instalador mais recente.
--config <path to *.vsconfig file>	opcional: Se presente, o Visual Studio usa o conteúdo do arquivo de configuração para configurar seu layout. Certifique-se de especificar o caminho totalmente qualificado para o arquivo de configuração.
--noWeb	opcional: Se estiver presente, a instalação do Visual Studio usa os arquivos em seu diretório de layout para instalar o Visual Studio e não baixa nenhum pacote da Web. Se um usuário tentar instalar componentes que não estão no layout, a instalação falhará. Não use esse parâmetro se estiver tentando implantar um layout hospedado em um site de intranet interno. Para obter mais informações, consulte Instalar num cliente que não tem acesso à internet. importante: O parâmetro --noWeb não impede que o instalador do Visual Studio em uma máquina cliente conectada à Internet verifique se há atualizações se o cliente estiver configurado para examinar os servidores hospedados da Microsoft em busca de atualizações. Neste 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. O acesso à Internet é necessário para corrigir um layout.
--clean <one or more paths to catalogs>	opcional: Remove versões antigas de componentes de um layout atualizado para uma versão mais recente.

Parâmetros avançados de layout	Descrição
--channelId <id>	Opcional: O ID do canal para a instância a ser instalada, representado como VisualStudio.17.Release. channelId é necessário para o comando install e ignorado para outros comandos se --installPath for especificado. Consulte 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. Consulte os exemplos de sintaxe de de --channelUri para possíveis valores. Se as atualizações não forem desejadas, --channelUri pode apontar para um arquivo inexistente (por exemplo, --channelUri C:\doesntExist.chman). Este parâmetro pode ser usado para o comando install; outros comandos ignoram-no.
--installChannelUri <uri>	opcional: A URI do manifesto do canal a utilizar para a instalação. O URI especificado por --channelUri (que deve ser especificado quando --installChannelUri é especificado) é usado para detetar atualizações. Este parâmetro pode ser usado para o comando install; outros comandos ignoram-no.
--installCatalogUri <uri>	Opcional: O URI do manifesto do catálogo a ser usado para a instalação. Se especificado, o gestor de canal tenta descarregar o manifesto do catálogo a partir deste URI antes de utilizar o URI no manifesto do canal de instalação. Este parâmetro é usado para dar suporte à instalação offline, onde o cache de layout é criado com o catálogo de produtos já baixado. Este parâmetro pode ser usado para o comando install; outros comandos ignoram-no.
--productId <id>	Opcional: O ID do produto para a instância instalada. Este parâmetro é pré-preenchido 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 apenas com binários de produto x64. Para incluir binários ARM para cargas de trabalho aplicáveis ao lado dos binários x64 em um layout, use o parâmetro --arch all ou --arch *. Para criar um layout apenas de binários ARM, use --arch arm64
--keepLayoutVersion	opcional: aplique alterações ao layout sem atualizar a versão do produto incluída no layout.
--locale <language-locale>	opcional: altere o idioma de exibição da interface do usuário para o próprio instalador. A configuração será mantida. Para obter mais informações, consulte a seção Lista de locais de idiomas nesta página.
--cache	opcional: Se existirem, os pacotes serão mantidos após serem instalados para reparos subsequentes. Isso substitui a configuração de política global que será usada para as instalações, reparações ou modificações subsequentes. A política padrão é armazenar pacotes em cache. Isso é ignorado para o comando de desinstalação. Leia como desativar ou mover o cache de pacotes para obter mais informações.
--nocache	opcional: Se existirem, os pacotes serão eliminados depois de serem instalados ou reparados. Eles serão baixados novamente somente se necessário e excluídos novamente 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 desativar ou mover o cache de pacotes para mais informações.
--noUpdateInstaller	opcional: Se estiver presente, impede o instalador de se atualizar quando o modo silencioso é especificado. O instalador falhará no comando e retornará um código de saída diferente de zero se a opção noUpdateInstaller for especificada com a opção quiet 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 suportados são compartilhados, armazenados em cache e instalados.
--path cache=<path>	Opcional: Usa o local especificado para baixar arquivos de instalação. Esse local só pode ser definido na primeira vez que o Visual Studio é instalado. Exemplo: --path cache="C:\VS\cache"
--path shared=<path>	opcional: contém arquivos compartilhados para instalações lado a lado do Visual Studio. Algumas ferramentas e SDKs são instalados num local neste drive, enquanto alguns outros podem alterar essa configuração e instalar noutro drive. 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 desses comandos pode ser usado de cada vez.

Comando ModifySettings e parâmetros de linha de comando

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 na máquina cliente e passando o comando modifySettings e o canal de atualização desejado.

de 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 de modificarConfigurações	Descrição
--installPath <dir>	É recomendado utilizar para especificar em qual instância do Visual Studio agir.
--newChannelUri	Obrigatório: O URI do manifesto do canal. Esse valor especifica onde estará o próximo local de origem das atualizações. Consulte exemplos de sintaxe de --channelUri para valores possíveis. Se as atualizações não forem desejadas, --channelUri pode apontar para um arquivo inexistente (por exemplo, --channelUri C:\doesntExist.chman).
--channelUri	A URI do antigo manifesto do canal. Pode ser usado se o --installPath não for conhecido. Deve ser utilizado em conjunto com o ID do produto para identificar a instância correta para atuar.
--productId <id>	Deve ser usado se --channelUri for especificado e for utilizado para identificar a instância certa sobre a qual atuar. O productID é algo como "Microsoft.VisualStudio.Product.Enterprise".
--includeRecommended	opcional: Durante um comando modifySettings, este parâmetro (que deve ser seguido imediatamente pela palavra true ou false) informa ao instalador do Visual Studio para desativar a funcionalidade "adicionar componentes recomendados para as cargas de trabalho instaladas na atualização" na caixa de diálogo Configuração de Atualização.
--quiet	opcional: Este parâmetro impede que qualquer interface do usuário seja exibida enquanto o comando está sendo executado. Não está disponível para uso programático por usuários padrão.
--removeOos true	opcional: Durante um comando modifySettings, este parâmetro (que deve ter a palavra true ou false logo após) indica ao instalador do Visual Studio para de forma persistente remover (ou não remover) todos os componentes instalados que transitaram para um estado sem suporte. Útil para ajudar a manter a máquina segura.

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

Comando de reversão e parâmetros de linha de comando

A partir do Visual Studio 2022, você pode reverter uma atualização programaticamente usando o instalador na máquina cliente e passando o comando rollback 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. Este comando não funcionará se o DisableRollback estiver ativado.

parâmetros de reversão	Descrição
--installPath <dir>	Recomenda-se usar para especificar em que instância do Visual Studio atuar.

Exemplos de sintaxe:

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

Comando de atualização do administrador e parâmetros de linha de comando

Você pode baixar um de Atualização do Administrador do do Catálogo do Microsoft Update e usá-lo para atualizar a instalação do cliente ou o layout.

Atualizando um layout

Se você estiver atualizando um layout para uma versão específica do Visual Studio, basta baixar a Atualização do administrador para o computador que está hospedando 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

Atualizando um cliente

No cliente, se você baixar a Atualização do administrador para o diretório de instalação na máquina 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.

Configurando a Atualização do Administrador no SCCM

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

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

Administrador atualizar parâmetros	Descrição
--installerUpdateArgs [optional parameters]	Este parâmetro funciona como uma "matriz de passagem" de parâmetros específicos que são relevantes para cenários de atualização do administrador. Os parâmetros opcionais habilitados para essa finalidade são: --quiet: Esta é a experiência padrão para atualizações de administrador e está listada aqui para integridade. --passive: Este parâmetro substitui o parâmetro --quiet. Isso faz com que a interface do usuário apareça de maneira não interativa. --norestart: Este parâmetro deve ser usado em conjunto com --quiet ou --passive e faz com que todas as reinicializações necessárias sejam adiadas. --noWeb: Este parâmetro impede que o Visual Studio verifique na Internet se há atualizações para o produto. --force: Este parâmetro força o Visual Studio a fechar mesmo se o Visual Studio estiver em uso. Use este parâmetro com cuidado, pois pode causar perda de trabalho. Este parâmetro só deve ser usado quando a atualização do administrador é executada no contexto do usuário; ele será ignorado se a atualização do administrador for executada no contexto do sistema. --installWhileDownloading: Este parâmetro permite que o Visual Studio baixe e instale o produto em paralelo. É a experiência padrão para atualizações de administrador e está listada aqui para integridade. --keepWindowsUpdateOn: Este parâmetro impede que o instalador desative o agente do Windows Update no cliente. Você deve usar esse parâmetro se estiver importando uma atualização do Administrador do Catálogo para o SCCM. Também pode ser necessário 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 Obrigatório torna esse parâmetro desnecessário. --downloadThenInstall: Este parâmetro força o Visual Studio a baixar todos os arquivos antes de instalá-los. É mutuamente exclusivo do parâmetro --installWhileDownloading.
--checkPendingReboot	A atualização será abortada se houver uma reinicialização pendente na máquina, 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 do administrador:

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

Remover comando do canal e parâmetros de linha de comando

Os canais que estão disponíveis para atualização são armazenados em cache no cliente e, com o tempo, podem bagunçar as coisas. Você pode remover manualmente canais de atualização abrindo o Visual Studio Installer, alternando para a guia Disponível e clicando no X no canto superior direito do cartão de produto. Você pode remover canais programaticamente (por exemplo, locais de layout mais antigos) usando o comando removeChannel. Você pode executar vswhere programaticamente na máquina cliente para determinar quais canais são armazenados em cache na máquina cliente.

Comando	Descrição
removeChannel	Comando para remover um canal da máquina cliente.

parâmetros removeChannel	Descrição
--channelUri	Obrigatório O URI do manifesto do canal antigo.
--quiet	opcional Este parâmetro impede que qualquer interface do usuário seja exibida enquanto o comando está sendo executado.
--passive	Opcional Este 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"

Use o winget para instalar ou modificar o Visual Studio

Você pode usar o Gerenciador de Pacotes do Windows ferramenta "winget" para instalar, modificar ou atualizar programaticamente o Visual Studio em sua máquina junto com outros pacotes gerenciados pelo winget.

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

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

No entanto, se pretenderes personalizar a instalação e especificar cargas de trabalho e componentes adicionais para incluir durante a instalação inicial, poderás usar o switch --override do winget juntamente com o 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"

Claro, você também pode incluir componentes diretamente durante a instalação inicial, como este:

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

Se você já tiver o Visual Studio instalado em sua máquina, será possível usar o de 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 do 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. Não é possível adicionar componentes através de uma atualização/melhoria. Você precisa usar o configure de winget para adicionar componentes.

Observe que as operações do Visual Studio Installer atualmente 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 da mesma SKU ao mesmo tempo em uma máquina cliente. Por fim, o Visual Studio deve ser fechado se você for 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 componentes

Para obter uma lista de IDs de carga de trabalho e componentes classificados por produto do Visual Studio, consulte a página de cargas de trabalho e componentes do Visual Studio.

Lista de localizações de idiomas

Localização de Idioma	Linguagem
Cs-cz	Checo
De-de	Alemão
En-nos	Inglês
Es-es	Espanhol
Fr-fr	Francês
Ele-ele	Italiano
Ja-jp	Japonês
Ko-kr	Coreano
Pl-pl	Polaco
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% é definida como um dos seguintes valores:

Valor	resultado
0	Operação concluída com êxito
740	Elevação necessária
1001	O processo de instalação do Visual Studio está em execução
1003	O Visual Studio está em uso
1602	Operação cancelada
1618	Outra instalação em execução
1641	Operação concluída com êxito e reinicialização foi iniciada
3010	Operação concluída com êxito, mas a instalação requer reinicialização antes de poder ser usada
5003	Falha no download do instalador pelo Bootstrapper
5004	Operação cancelada
5005	Erro de análise de linha de comando do Bootstrapper
5007	A operação foi bloqueada - o computador não atende aos requisitos
8001	Falha na verificação da máquina ARM
8002	Falha na verificação prévia do download em segundo plano
8003	Falha selecionável sem suporte disponível
8004	Falha no diretório de destino
8005	Verificando a falha das cargas úteis de origem
8006	Processos do Visual Studio em execução
8010	Sistema operacional não suportado. Consulte os Requisitos do sistema
-1073720687	Falha de conectividade
-1073741510	Microsoft Visual Studio Installer foi encerrado (pelo usuário ou processo externo)
Outros (por exemplo: -1, 1, 1603)	Ocorreu uma condição de falha - 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 que comecem com dd_bootstrapper, dd_cliente dd_setup para o bootstrapper, o aplicativo instalador e o mecanismo de instalação, respectivamente.

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:

• Use a opção de suporte do chat de instalação (somente 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 fores um administrador de TI e não tiveres o Visual Studio instalado, podes enviar comentários de administrador de TI.
• Sugira um recurso, acompanhe problemas do produto e encontre respostas no da Comunidade de Desenvolvedores do Visual Studio .

Conteúdo relacionado

• Exemplos de parâmetros de linha de comando para 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
• carga de trabalho do Visual Studio e IDs de componentes