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
Primeiro, baixe a ferramenta de layout mínimo localizada aqui. Escolha Salvar quando solicitado e, em seguida, selecione Executar.
Em seguida, aceite o prompt do Controle de Conta de Usuário clicando em Sim.
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 respostaMinimalLayout.jsonpara 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.jsonde um layout já gerado.MinimalLayout.exe regenerate --filePath C:\MinimalLayout\MinimalLayout.jsonVerificar: 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.
|
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-USVeja 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-USE 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-USVocê 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-USE, 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-USE 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.
Atualizar o Instalador do Visual Studio
Execute o comando a seguir, substituindo
vs_enterprise.exepelo nome correto do aplicativo bootstrapper, se necessário.vs_enterprise.exe --quiet --update --offline C:\VSLayout\vs_installer.opcAtualizar 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
–noWebcom 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 (x86)\Microsoft Visual Studio\2019\Enterprise"
Atualizar o Instalador do Visual Studio
Execute o comando a seguir, substituindo
vs_enterprise.exepelo nome correto do aplicativo bootstrapper, se necessário.vs_enterprise.exe --quiet --update --offline C:\VSLayout\vs_installer.opcAtualizar 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
–noWebcom 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
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de