Atualizar o Visual Studio usando um layout offline mínimo

Para computadores não conectados à Internet, criar um layout mínimo é a maneira mais fácil e rápida de atualizar suas instâncias offline do Visual Studio.

A ferramenta de layout mínimo gera um layout adaptado especificamente às necessidades da sua equipe. Administradores do Enterprise podem usar essa ferramenta para criar layouts de atualização para a maioria das versões do Visual Studio, inclusive a de 2017. Diferente de um layout completo do Visual Studio, um layout mínimo contém apenas os pacotes atualizados, de modo que sempre é menor e mais rápido de gerar e implantar. Você pode minimizar ainda mais o tamanho do layout de atualização especificando apenas os idiomas, as cargas de trabalho e os componentes desejados.

Como gerar um layout mínimo

Importante

Essas instruções pressupõem que você já tenha criado e usado layouts. Para obter mais informações sobre como fazer isso, consulte a página Atualizar uma instalação do Visual Studio baseada em rede.

Para ter uma melhor compreensão do ciclo devida do Visual Studio, consulte a página Ciclo de Vida e Manutenção de Produtos do Visual Studio.

Essa ferramenta cria layouts de atualização para o Visual Studio 2017 (15.9) em diante. O layout pode ser implantado em computadores em rede/offline para atualizar instâncias do Visual Studio. Durante a criação normal do layout, todos os pacotes dessa versão específica são baixados. A criação normal do layout é necessária para reparar, desinstalar e para outras operações padrão em instâncias do Visual Studio. O layout mínimo baixa apenas pacotes atualizados, portanto, de modo que é menor e mais fácil de copiar para computadores offline.

Instalando a ferramenta de layout mínimo

1. Primeiro, baixe a ferramenta de layout mínimo localizada aqui. Escolha Salvar quando solicitado e, em seguida, selecione Executar.

   

2. Em seguida, aceite o prompt do Controle de Conta de Usuário clicando em Sim.

   

3. A ferramenta de layout mínimo será instalada em C:\Program Files (x86)\Microsoft Visual Studio\MinimalLayout.

Como usar a ferramenta de layout mínimo

MinimalLayout.exe usa os comandos e as opções a seguir para gerar o layout. Pelo menos um comando é necessário para executar a ferramenta. Veja como você executará a ferramenta:

MinimalLayout.exe [command] <options>...

Comandos

• Visualizar: use este comando para visualizar quantos pacotes serão baixados e o espaço total usado para criar o layout.

• Gerar: use este comando para gerar o layout mínimo para atualizar o Visual Studio.

• Regenerar: use este comando para regenerar um layout usando um arquivo de resposta de layout mínimo existente. Cada layout mínimo produz um arquivo de resposta MinimalLayout.json, que contém os parâmetros de entrada do layout mínimo original. Você pode usar o comando Regenerar e um arquivo de resposta MinimalLayout.json para regenerar o layout mínimo. Isso será útil se você quiser criar um layout mínimo para uma nova atualização do Visual Studio com base no arquivo de resposta do layout mínimo anterior.

  Para esse comando, é necessário um caminho de arquivo MinimalLayout.json de um layout já gerado.

  MinimalLayout.exe regenerate --filePath C:\MinimalLayout\MinimalLayout.json
  

• Verificar: use este comando para determinar se a pasta de layout está corrompida.

• Corrigir: use este comando para corrigir uma pasta de layout corrompida, incluindo a substituição de pacotes ausentes da pasta de layout.

Opções

Opções	Descrição	Obrigatório/Opcional	Exemplo
--targetLocation <dir>	Especifica um diretório no qual criar um layout mínimo offline.	Obrigatório	--targetLocation c:\VSLayout\
--baseVersion <versão>	O layout mínimo offline será gerado começando nesta versão.	Obrigatório	--baseVersion 16.4.0
--targetVersion <versão>	O layout mínimo offline será gerado até esta versão, incluindo-a.	Obrigatório	--targetVersion 16.4.4
--languages	Especifica os idiomas a serem incluídos no layout mínimo offline. Vários valores podem ser especificados, separados por espaços.	Obrigatório	--languages en-US fr-FR
--productIds <uma ou mais IDs de produto>	As IDs dos produtos com base nos quais o layout mínimo offline será gerado, separadas por vírgulas. Microsoft.VisualStudio.Product.Enterprise Microsoft.VisualStudio.Product.Professional Microsoft.VisualStudio.Product.BuildTools Microsoft.VisualStudio.Product.TestAgent Microsoft.VisualStudio.Product.TestController Microsoft.VisualStudio.Product.TeamExplorer	Obrigatório	--productIds Microsoft.VisualStudio.Product.Enterprise,Microsoft.VisualStudio.Product.Professional
--filePath	O caminho do arquivo MinimalLayout.json de um layout já criado. Essa opção é usada apenas com o comando Regenerar.	Necessário para o comando Regenerar	--filePath C:\VSLayout\minimalLayout.json Observe que o comando Regenerate usa apenas --filePath como opção.
--add <uma ou mais IDs de componente ou carga de trabalho>	Especifica uma ou mais IDs de carga de trabalho ou de componente a serem adicionadas. Componentes adicionais podem ser adicionados globalmente usando --includeRecommended e/ou –-includeOptional. Várias IDs de componente ou cargas de trabalho podem ser especificadas, separadas por um espaço.	Opcional	--add Microsoft.VisualStudio.Workload.ManagedDesktop Microsoft.VisualStudio.Workload.NetWeb Component.GitHub.VisualStudio
--includeRecommended	Inclui os componentes recomendados para as cargas de trabalho que estão instaladas, mas não os componentes opcionais.	Opcional	Para uma carga de trabalho específica: --add Microsoft.VisualStudio.Workload. ManagedDesktop;includeRecommended Para aplicar a todas as cargas de trabalho: --includeRecommended
--includeOptional	Inclui os componentes opcionais para as cargas de trabalho que estão instaladas, incluindo os componentes recomendados.	Opcional	Para uma carga de trabalho específica: --add Microsoft.VisualStudio.Workload. ManagedDesktop;includeOptional Para aplicar a todas as cargas de trabalho: --includeOptional

Gerando um layout mínimo

Importante

Essas instruções pressupõem que você tenha criado um layout de instalação de rede. Para obter mais informações sobre como fazer isso, consulte a página Criar uma instalação de rede do Visual Studio.

Crie um layout mínimo usando o comando gerar para o intervalo de versões especificado. Você também precisará conhecer a productId, os idiomas e as cargas de trabalho específicas necessárias. Esse layout mínimo atualizará qualquer instância do Visual Studio da versão base até, e incluindo, a versão de destino.

Antes de criar o layout, você pode descobrir o tamanho total do download e o número de pacotes incluídos usando o comando visualizar. Esse comando usa as mesmas opções que o comando gerar e os detalhes são gravados no console.

Vamos percorrer alguns exemplos de como visualizar, gerar e regenerar um layout mínimo:

• Primeiro, veja um exemplo de como visualizar um layout para o Visual Studio Enterprise versões 16.4.0 a 16.4.4, somente para inglês.

  MinimalLayout.exe preview --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --languages en-US
  

• Veja como gerar esse mesmo layout com uma carga de trabalho.

  MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop;includeOptional --languages en-US
  

• E veja como regenerar um layout mínimo offline usando um arquivo de resposta existente.

  MinimalLayout.exe regenerate --filepath c:\VSLayout\MinimalLayout.json
  

Alguns outros exemplos usando o comando gerar:

• Veja como adicionar uma carga de trabalho adicional e incluir apenas os pacotes recomendados.

  MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Professional --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop Microsoft.VisualStudio.Workload.NetWeb;includeRecommended --languages en-US
  

• Você também pode gerar um layout mínimo offline que dá suporte a vários produtos.

  MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise,Microsoft.VisualStudio.Product.Professional --baseVersion 16.4.0 --targetVersion 16.4.4 --languages en-US
  

• E, por fim, veja como você incluiria vários idiomas no layout mínimo.

  MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop;includeOptional --languages en-US fr-FR
  

Como manter um layout mínimo

Use os comandos verificar e corrigir para manter o layout mínimo depois que ele for criado. O comando verificar determina se há pacotes corrompidos ou ausentes layout mínimo. Se você encontrar problemas depois de executar o comando verificar, use o comando corrigir para corrigir esses pacotes ausentes ou corrompidos.

• Veja como verificar se um layout tem pacotes corrompidos ou ausentes:

  MinimalLayout.exe Verify --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop --includeRecommended --languages en-US
  

• E veja como corrigir esse layout:

  MinimalLayout.exe fix --targetLocation C:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop;includeRecommended --languages en-US
  

Observação

Esse layout não pode ser usado para reparar uma instalação do Visual Studio. Para reparar uma instância existente do Visual Studio, consulte Reparar o Visual Studio.

Como usar um layout mínimo offline para atualizar uma instalação existente do Visual Studio

Após gerar um layout mínimo, você pode copiar toda a pasta de layout mínimo para um computador cliente. Isso será necessário se o computador não tiver acesso à pasta de layout mínimo no local original.

Navegue até a pasta e identifique o nome do aplicativo bootstrapper. O nome do aplicativo bootstrapper depende do valor de ProductId especificado ao gerar o layout mínimo. Consulte a tabela abaixo para obter exemplos comuns.

Valor de ProductId	Nome do aplicativo
Microsoft.VisualStudio.Product.Enterprise	vs_enterprise.exe
Microsoft.VisualStudio.Product.Professional	vs_professional.exe
Microsoft.VisualStudio.Product.BuildTools	vs_buildtools.exe

A atualização é aplicada a uma instância do Visual Studio em duas etapas. Comece atualizando o Instalador do Visual Studio e, em seguida, atualize o Visual Studio.

1. Atualizar o Instalador do Visual Studio

   Execute o comando a seguir, substituindo vs_enterprise.exe pelo nome correto do aplicativo bootstrapper, se necessário.

   vs_enterprise.exe --quiet --update --offline C:\VSLayout\vs_installer.opc
   

2. Atualizar o aplicativo do Visual Studio

   Para atualizar o Visual Studio, você precisa especificar o installPath da instância do Visual Studio que deseja atualizar. Se várias instâncias do Visual Studio estiverem instaladas, cada uma precisará ser atualizada separadamente. É altamente recomendável especificar a opção –noWeb com o comando atualizar para impedir a instalação de componentes que não estão no layout mínimo. Isso impede que você deixe o Visual Studio em um estado inutilizável.

   Execute o comando a seguir, substituindo o parâmetro de linha de comando installPath adequadamente. Não deixe de usar o nome correto do aplicativo bootstrapper também.

   vs_enterprise.exe update --noWeb --quiet --installpath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise"
   

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

• Instalar o Visual Studio
• Guia do administrador do Visual Studio
• Usar parâmetros de linha de comando para instalar o Visual Studio
• Ferramentas para detectar e gerenciar instâncias do Visual Studio
• Como definir as configurações em um arquivo de resposta
• Atualizações de controle para implantações do Visual Studio com base em rede
• Ciclo de vida e manutenção do produto Visual Studio