Usar parâmetros de linha de comando para instalar, atualizar e gerenciar o Visual Studio
Ao instalar o Visual Studio programaticamente ou em 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 computadores cliente.
Os seguintes verbos e parâmetros de linha de comando podem ser usados com os seguintes executáveis ou programas:
- O carregador de inicialização 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 já pode 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 cada uma dessas situações, e quaisquer ressalvas ou exceções especiais são documentadas. Além disso, em alguns cenários, talvez você não tenha acesso a todos esses executáveis descritos anteriormente. Por exemplo, os computadores cliente só poderão ter o instalador disponível para execução programática se o Visual Studio tiver sido instalado por meio de um layout.
Você pode obter os carregadores de inicialização do Visual Studio 2019 na tabela seguinte. Como alternativa, se você quiser uma versão específica do Visual Studio 2019, consulte a página Versões do Visual Studio 2019. Esta página tem links para os carregadores de inicialização de versão fixa da versão e da edição escolhidas do Visual Studio.
| Edição | Carregador de inicialização |
|---|---|
| Visual Studio 2019 Enterprise versão 16.11 | vs_enterprise.exe |
| Visual Studio 2019 Professional versão 16.11 | vs_professional.exe |
| Ferramentas de Build do Visual Studio 2019 versão 16.11 | vs_buildtools.exe |
Para obter os carregadores de inicialização 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 lançamentos do Visual Studio 2022. Esta página contém links para inicializadores das versões corrigidas de cada lançamento de manutenção.
| Edição | Carregador de inicialização |
|---|---|
| Visual Studio 2022 Enterprise | vs_enterprise.exe |
| Visual Studio 2022 Professional | vs_professional.exe |
| Comunidade do Visual Studio 2022 | vs_community.exe |
| Ferramentas de Build do Visual Studio 2022 | vs_buildtools.exe |
Dica
Se você baixou anteriormente um arquivo bootstrapper e deseja verificar sua versão, veja como. No Windows, abra o Explorador de Arquivos, clique com o botão direito do mouse no arquivo carregador de inicialização, escolha Propriedades, escolha a guia Detalhes e exiba o número da versão do produto. Para corresponder esse número a uma versão do Visual Studio, confira a tabela na parte inferior da página Versões do Visual Studio 2019.
Dica
Se você baixou anteriormente um arquivo bootstrapper e deseja verificar qual versão ele instalará, veja como. No Windows, abra o Explorador de Arquivos, clique com o botão direito do mouse no arquivo carregador de inicialização, escolha Propriedades e escolha a guia Detalhes. O campo Versão do produto descreverá o canal e a versão que o carregador de inicialização 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 carregador de inicialização 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 carregador de inicialização 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.
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 programaticamente para instalar o produto ou para 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 são sensíveis a maiúsculas e 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 alternativa 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 no computador cliente. Para outros comandos, como atualizar ou modificar, esse parâmetro é necessário e indica o diretório de instalação no qual a instância deve atuar. |
--productId <id> |
Opcional: a ID da instância do produto modificada e usada com --channelId. O productID é algo como "Microsoft.VisualStudio.Product.Enterprise". |
--channelUri |
opcional: durante um comando de atualização, você pode inserir um novo --channelUri para alterar a localização das configurações de atualização. Recomenda-se emparelhar com o parâmetro --installPath para que fique explícito qual instância do Visual Studio está sendo configurada. Confira os 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 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 à 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. Ele 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ê habilitará sua caixa de diálogo Configurações de Atualização para "adicionar componentes recomendados para cargas de trabalho instaladas na atualização". Confira Personalizar as 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. Ele 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 [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 componente a serem removidas. Ele complementa e se comporta de forma semelhante ao parâmetro --add. |
| A seção (#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 de maneira programática por usuários padrão, independentemente de a política AllowStandardUserControl estar 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 de (e, de fato, substitui) o parâmetro --quiet. Também não pode ser usado programaticamente por usuários padrão, independentemente das configurações da política AllowStandardUserControl. |
--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 se algum 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. 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 a ser usada para 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, esse parâmetro, seguido por true ou false, informa ao Instalador do Visual Studio se todos os componentes instalados foram transferidos 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 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 parâmetro --config para especificar as cargas de trabalho, componentes ou extensões a serem adicionadas com base em um arquivo de configuração de instalação salvo anteriormente. Esta operação é somente 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 especificar 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 a execução de instalação ou modificação em um contexto de --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 o carregamento de extensões que não possuem 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 o próprio instalador e não o produto do Visual Studio. Sua funcionalidade é equivalente ao parâmetro --update, mas mais intuitivo. Destinado a ser usado ao preparar e pré-configurar computadores 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 Instalar (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 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 à ID (por exemplo, --add Workload1;includeRecommended ou --add Workload2;includeOptional). Para obter mais informações, confira a página IDs de carga de trabalho e de componente. Observação: se --add for usado, somente as cargas de trabalho e os 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 todas as 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 opcionais de e 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 dá suporte a ele. É útil ao atualizar layouts. Mais exemplos podem ser encontrados aqui. |
--useLatestInstaller |
Opcional: funcionalidade herdada que só é aplicável para carregadores de inicialização 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 ele pertença a uma versão principal mais recente do produto. O instalador mais recente poderá ser útil se você quiser aproveitar os novos recursos ou correções de bug que estão disponíveis em sua versão mais recente. Para obter mais informações, consulte Configurar o layout para sempre usar a documentação mais recente do instalador. |
--config <path to *.vsconfig file> |
opcional: se estiver presente, o Visual Studio usará o conteúdo do arquivo de configuração para configurar o layout. Especifique o caminho totalmente qualificado para o arquivo de configuração. |
--noWeb |
opcional: se estiver presente, a instalação do Visual Studio usará os arquivos no diretório de layout para instalar o Visual Studio e não baixará 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 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 o Instalador do Visual Studio em um computador cliente conectado à Internet de verificar se há atualizações se o cliente estiver 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 estão listados. |
--fix |
Opcional: Verifique o conteúdo de um layout. Se os arquivos estiverem corrompidos ou ausentes, eles serão recarregados. 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 de layout avançados | 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 for especificado. Confira exemplos de sintaxe de --channelId. |
--channelUri <uri> |
Opcional: o URI do manifesto do canal. Esse valor determina o local de origem das atualizações e o valor inicial é configurado no arquivo response.json do layout. Consulte os exemplos de sintaxe do --channelUri para valores possíveis. Se as atualizações não forem desejadas, --channelUri poderá apontar para um arquivo inexistente (por exemplo, --channelUri C:\doesntExist.chman). Esse parâmetro pode ser usado para o comando de instalação; outros comandos ignoram-no. |
--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 é especificado) é usado para detectar atualizações. Esse parâmetro pode ser usado para o comando de instalação; outros comandos ignoram-no. |
--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 à instalação offline, em que o cache de layout é criado com o catálogo de produtos já baixado. Esse parâmetro pode ser usado para o comando de instalação; outros comandos ignoram-no. |
--productId <id> |
Opcional: a ID do produto para a instância instalada. Esse parâmetro é 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 arm para cargas de trabalho aplicáveis junto com os binários 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 alterações ao layout sem atualizar a versão do produto incluída no layout. |
--locale <language-locale> |
: altere o idioma de exibição da interface do usuário, opcionalmente, para o 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: se houver, os pacotes serão excluídos após 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 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 instalador falhará ao executar o comando e retornará um código de saída diferente de zero se "noUpdateInstaller" for especificado com o modo 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 arquivos de instalação. Esse local só pode ser definido na primeira vez em que o Visual Studio está 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 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 em que o Visual Studio está instalado. |
--path install=<path> |
opcional: equivalente a –-installPath. Especificamente, --installPath "C:\VS" e --path install="C:\VS" são equivalentes. Somente um desses comandos pode ser usado por 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 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. Consulte os exemplos de sintaxe de do --channelUri para possíveis valores. Se as atualizações não forem desejadas, --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> |
Precisará 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 precisa ter a palavra true ou false imediatamente após ele) informa ao instalador do Visual Studio para desativar 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
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 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> |
Recomenda-se usar para especificar em qual instância do Visual Studio deve-se atuar. |
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.
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, abra um prompt de comando nesse computador e execute 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 de Administrador no diretório de instalação no computador cliente, poderá 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 de administrador por meio do SCCM (Microsoft Endpoint Manager), poderá modificar 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, consulte 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 do 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 do 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 fins de 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 as reinicializações necessárias sejam atrasadas. --noWeb: esse parâmetro impede o Visual Studio de verificar na Internet se há atualizações no 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 do Administrador é executada no contexto do usuário; ele será ignorado se a atualização do Administrador for executada no contexto do sistema. --installWhileDownloading: esse 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 fins de integridade. --keepWindowsUpdateOn: esse parâmetro impede que o instalador desative o agente do Windows Update no cliente. Você deverá usar esse parâmetro se estiver importando uma atualização de Administrador do Catálogo para o 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 "Obrigatório" torna esse parâmetro desnecessário.--downloadThenInstall: esse parâmetro força o Visual Studio a baixar 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 do 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
Os canais que estão disponíveis para atualização são armazenados em cache no cliente e, com o tempo, podem atrapalhar as coisas. Você pode remover manualmente os canais de atualização acessando o Visual Studio Installer, indo para a guia Disponível e clicando no X no canto superior direito do cartão do produto. Você pode remover os 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 o Gerenciador de Pacotes do Windows, a ferramenta "winget", para instalar, modificar ou atualizar programaticamente 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 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 que você também pode apenas incluir componentes diretamente durante a instalação inicial, assim:
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. Confira como criar um arquivo de Configuração do WinGet para aprender a criar uma configuração do WinGet.
Não é possível usar a opção --override ou o provedor DSC do Visual Studio juntamente com o comando upgrade do Winget, pois upgrade basicamente apenas atua 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 ou upgrade. Você precisa usar o configure do winget para adicionar componentes.
Observe que as operações do Instalador do Visual Studio 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 winget para instalar várias edições (ou seja, SKUs diferentes) ou várias instâncias da mesma 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 identificadores de carga de trabalho e de componentes
Para obter uma lista de IDs de cargas de trabalho e componentes classificados por produto do Visual Studio, consulte a página Visual Studio workload and component IDs.
Lista de localidades de idioma
| Localidade de idioma | Linguagem |
|---|---|
| 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% é definida como um dos seguintes valores:
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 começam 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
Às vezes, as coisas podem dar errado. Se a instalação do Visual Studio falhar, consulte Solucionar problemas de instalação e atualização do Visual Studio para obter diretrizes passo a passo.
Aqui estão mais algumas opções de suporte:
- Use a opção de suporte de chat de instalação (somente em inglês) para questões de instalação.
- Relate problemas de produto para nós usando a ferramenta Relatar um Problema, que aparece tanto no Instalador do Visual Studio quanto na IDE do Visual Studio. Se você for um Administrador de TI e não tiver o Visual Studio instalado, poderá enviar comentários do Administrador de TI.
- Sugira um recurso, acompanhe os problemas do produto e encontre respostas no da Comunidade de Desenvolvedores do Visual Studio.