Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Para computadores que não estã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. Os administradores corporativos podem usar essa ferramenta para criar layouts de atualização para a maioria das versões do Visual Studio, incluindo o Visual Studio 2017. Ao contrário de um layout completo do Visual Studio, um layout mínimo contém apenas os pacotes atualizados, portanto, é 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, cargas de trabalho e componentes desejados.
Como gerar um layout mínimo
Importante
Essas instruções pressupõem que você tenha criado e usado layouts anteriormente. Para obter mais informações sobre como fazer isso, consulte a página Atualizar uma instalação baseada em rede do Visual Studio.
Para obter uma melhor compreensão do ciclo de vida 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) e em diante. O layout pode ser implantado em computadores de 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 de layout normal é necessária para reparar, desinstalar e outras operações padrão em instâncias do Visual Studio. O layout mínimo baixa apenas pacotes atualizados, portanto, é menor e mais fácil 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.
de controle de conta de usuárioA 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 seguintes comandos e opções 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
versão prévia: use este comando para visualizar quantos pacotes serão baixados e o espaço total usado para criar esse layout.
Gere: use este comando para gerar um layout mínimo para a atualização do 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 mínimos de entrada de layout original. Você pode usar o comando Regenerar e um arquivo de respostaMinimalLayout.jsonpara regenerar o layout mínimo. Isso é ú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 offline mínimo. | Necessário | --targetLocation c:\VSLayout\ |
| --baseVersion <versão> | O layout offline mínimo será gerado a partir desta versão. | Necessário | --baseVersion 16.4.0 |
| --targetVersion <versão> | O layout mínimo offline será gerado até esta versão, incluindo-a. | Necessário | --targetVersion 16.4.4 |
| --Idiomas | Especifica os idiomas a serem incluídos no layout offline mínimo. Vários valores podem ser especificados, separados por espaços. | Necessá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.
|
Necessá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 uma opção. |
| --add <uma ou mais IDs de componente ou carga de trabalho> | Especifica uma ou mais IDs de carga de trabalho ou componente a serem adicionadas. Componentes adicionais podem ser adicionados globalmente usando --includeRecommended e/ou –-includeOptional. Várias cargas de trabalho ou IDs de componente 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 todas as cargas de trabalho 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 todas as cargas de trabalho 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ê já criou 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 versão prévia. 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, aqui está 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 offline mínimo 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 offline mínimo 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-USPor fim, veja como você incluiria vários idiomas em seu 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 no layout mínimo. Se você encontrar problemas depois de executar o comando verificar, use o comando corrigir para corrigir os 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
Nota
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 offline mínimo para atualizar uma instalação existente do Visual Studio
Depois de gerar um layout mínimo, você pode copiar toda a pasta de layout mínima para um computador cliente. Isso será necessário se o computador não tiver acesso à pasta de layout mínima em seu local original.
Navegue até a pasta e identifique o nome do aplicativo bootstrapper. O nome do aplicativo bootstrapper depende do valor 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 do aplicativo bootstrapper correto, 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 de atualização 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 do aplicativo bootstrapper correto, 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 de atualização 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, 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 chat de instalação (somente em inglês) para problemas relacionados à instalação.
- Relate problemas do produto para nós usando a ferramenta Relatar um Problema que aparece tanto no Instalador quanto no 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.
Conteúdo relacionado
- Instalar o Visual Studio
- guia de 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 configurações em um arquivo de resposta
- Controle de atualizações para implantações do Visual Studio baseadas em rede
- Ciclo de vida e manutenção do produto Visual Studio