Criar e manter uma instalação de rede do Visual Studio

📣adoraríamos ouvir seus comentários!Reserve um momento para concluir esta pesquisa e informe-nos como podemos melhorar a experiência de layout. Obrigado por seu apoio!

Às vezes, um administrador corporativo deseja criar um cache de instalação privado (também conhecido como "layout") que contenha arquivos do Visual Studio que podem ser implantados em computadores cliente em uma organização.

A criação de um layout é útil nas seguintes situações:

• Um usuário tem permissões limitadas
• Os computadores cliente têm acesso limitado à Internet
• Uma organização deseja padronizar em uma versão específica do conjunto de ferramentas do desenvolvedor

Criamos o Visual Studio para que um administrador possa criar e manter um layout e armazená-lo em um compartilhamento de rede interno e, opcionalmente, disponibilizá-lo na intranet de uma organização. O layout serve como o local de origem para todos os arquivos do Visual Studio necessários para a instalação inicial do cliente e as atualizações subsequentes.

As informações nesta página são agrupadas em três seções principais:

• Criar o layout: descreve como criar o layout com o conteúdo correto do produto, definir as configurações padrão, armazená-lo em um compartilhamento de arquivos de rede e disponibilizá-lo em sua intranet.
• Manter o layout: informações de como atualizar melhor a versão do produto do layout ou modificar o conteúdo do produto do layout, as configurações do canal, a versão do instalador e o tamanho da pasta.
• Ajuda e Suporte: onde pedir ajuda

Criar o layout

Preparar o local de armazenamento para compartilhamento de arquivos na rede

Primeiro, você precisa determinar onde armazenará os pacotes baixados do Visual Studio. Se você tiver várias edições do Visual Studio em uso em sua empresa (por exemplo, Visual Studio 2022 Professional e Visual Studio 2022 Enterprise), será necessário criar um layout separado para cada edição. Criar um layout separado para cada edição pode consumir muito espaço em disco, especialmente quando você considera que as atualizações de layout consomem espaço em disco também.

O caminho de layout deve ter menos de 80 caracteres; algumas organizações usam com êxito links simbólicos para contornar a limitação de 80 caracteres.

Baixe o bootstrapper do Visual Studio para criar o layout

Baixe o bootstrapper correto para a edição desejada do Visual Studio e copie-o para o diretório que você quer usar como repositório do layout. Depois que o layout for criado, você poderá usá-lo para instalar o Visual Studio em qualquer computador cliente. O bootstrapper é o executável que você usa para criar, atualizar e executar outras operações de layout. Você deve ter uma conexão com a Internet e permissões de administrador para concluir esta etapa.

Os carregadores de inicialização a seguir sempre instalam a versão segura mais recente do Visual Studio 2022 no canal Atual, independentemente de quando foram executados. Como alternativa, se você quiser criar ou atualizar um layout para uma versão específica ou um canal específico do Visual Studio 2022, baixe o carregador de inicialização evergreen de versão não editável correspondente à versão de manutenção do canal desejado no Histórico de Versões do Visual Studio 2022. Copie-o para o diretório que você deseja servir como o local de origem do layout.

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 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 descreve 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 é considerado Atual, a menos que explicitamente especificado. Portanto, um carregador de inicialização com uma Versão de produto LTSC 17.0 instala 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 Visual Studio 2022 instala a versão de manutenção mais recente do Visual Studio 2022 no canal Atual.

Baixar os pacotes do Visual Studio

Você deve ter uma conexão com a Internet para concluir esta etapa.

Abra um prompt de comando com privilégios elevados, navegue até o diretório onde você baixou o carregador de inicialização e use os parâmetros do carregador de inicialização conforme definido na página Usar parâmetros de linha de comando para instalar o Visual Studio para criar e manter o layout de rede. Os exemplos a seguir ilustram maneiras comuns de criar layouts iniciais. Mais exemplos podem ser encontrados nos exemplos de parâmetro de linha de comando para uma página de instalação do Visual Studio.

Um layout inicial completo para uma única localidade de idioma requer cerca de 40 GB de espaço em disco para o Visual Studio Community e cerca de 50 GB para o Visual Studio Enterprise. Localidades de idioma extra exigem cerca de meio GB cada.

A abordagem recomendada é criar um layout inicial do Visual Studio com todas as cargas de trabalho e idiomas apropriados e armazenar os pacotes no diretório de layout no servidor de rede. Dessa forma, qualquer instalação do cliente tem acesso a toda a oferta de produtos do Visual Studio e à capacidade de instalar qualquer subconjunto. Para criar um layout completo do Visual Studio, execute o seguinte comando no diretório no qual você planeja hospedar o layout de rede:

vs_enterprise.exe --layout c:\VSLayout

Verifique se o layout é baseado no canal correto

É importante garantir que o layout de rede seja baseado no canal correto, pois esse é um dos critérios que as atualizações do administrador, se forem implantadas em toda a organização, usam para identificar quais instâncias de cliente devem ser atualizadas. Por exemplo, se o layout for baseado no canal VisualStudio.17.Release.LTSC.17.0 e se os clientes estiverem configurados para receber atualizações dos servidores hospedados pela Microsoft, todas as atualizações de segurança disponibilizadas no canal 17.0 LTSC estarão disponíveis para os clientes instalados ou atualizados desse layout.

Os carregadores de inicialização listados anteriormente são baseados no canal atual. Para criar um layout baseado em um dos canais LTSC, adquira o carregador de inicialização do canal correto na página Histórico de Versões do Visual Studio 2022, copie-o para sua pasta de layout e use-o para criar ou atualizar o layout.

Configurar o conteúdo de um layout

Há várias opções que você pode usar para personalizar o conteúdo do layout de rede. Você pode criar um layout parcial que contém apenas um conjunto específico de localidades de idiomas, cargas de trabalho, componentes e suas dependências recomendadas ou opcionais. Um layout parcial será útil se você souber que implantará apenas um subconjunto de cargas de trabalho em estações de trabalho do cliente. Os parâmetros típicos de linha de comando para personalizar o layout incluem:

• --add para especificar IDs de componente ou carga de trabalho.
  Se --add for usado, somente essas cargas de trabalho e componentes especificados com --add serão baixados. Se --add não for usado, todos os componentes e cargas de trabalho serão baixados.
• --includeRecommended para incluir todos os componentes recomendados para as IDs de carga de trabalho especificadas.
• --includeOptional para incluir todos os componentes opcionais para as IDs de carga de trabalho especificadas.
• --config para usar um arquivo *.vsconfig para especificar as cargas de trabalho , componentes ou extensões que devem ser incluídas ou referenciadas pelo layout. Especifique o caminho completo do arquivo de configuração.
• --lang para especificar localidades de idiomas.

Aqui estão alguns exemplos de como criar um layout de rede personalizado.

• Para criar um layout com componentes necessários para todas as cargas de trabalho em apenas um idioma, execute:

  vs_enterprise.exe --layout C:\VSLayout --lang en-US
  

• Para criar um layout com componentes necessários para todas as cargas de trabalho em vários idiomas, execute:

  vs_enterprise.exe --layout C:\VSLayout --lang en-US de-DE ja-JP
  

• Para criar um layout com uma carga de trabalho e todos os componentes necessários e recomendados para essa carga de trabalho em todos os idiomas, execute:

  vs_enterprise.exe --layout C:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --includeRecommended
  

• Para criar um layout com duas cargas de trabalho e um componente opcional em três idiomas, execute:

  vs_enterprise.exe --layout C:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Microsoft.VisualStudio.Component.Git --lang en-US de-DE ja-JP
  

Usar um arquivo de configuração para inicializar o conteúdo de um layout

Você pode usar o parâmetro --config para passar um arquivo *.vsconfig. Especifique o caminho completo do arquivo de configuração. Usar um arquivo *.vsconfig durante a criação de layout personaliza e limita o conteúdo de um layout de rede ao que é especificado no arquivo de configuração. O arquivo de configuração é copiado para o diretório de layout e renomeado para layout.vsconfig.

Quaisquer extensões de especificadas no arquivo *.vsconfig não são copiadas diretamente para o layout. Em vez disso, o arquivo response.json do layout contém uma referência ao arquivo de layout.vsconfig recém-criado, definindo o local de instalação para as extensões do cliente. Se você estiver instalando extensões que não estão assinadas digitalmente, edite o response.json para adicionar "allowUnsignedExtensions": true. Veja exemplos de conteúdo response.json.

vs_enterprise.exe --layout "C:\VSLayout" --config "C:\myconfig.vsconfig" 

Copiar o layout para um compartilhamento de rede

Você precisa hospedar o layout em um compartilhamento de rede para que ele possa ser acessado nos computadores cliente. Se você criou o layout em um computador local, precisará copiá-lo para um local de arquivo de rede. O exemplo a seguir usa xcopy. Você também pode usar robocopy, caso deseje. Exemplo:

xcopy /e c:\VSLayout \\server\share\layoutdirectory

Configurar os padrões iniciais de instalação do cliente para este layout

Um arquivo chamado response.json é criado na pasta raiz do layout. Esse arquivo personalizável fornece as configurações padrão iniciais para configurar no cliente, quando o cliente é instalado inicialmente a partir do layout. As opções de configuração comuns incluem a capacidade de configurar:

• Quais cargas de trabalho, componentes ou idiomas devem ser instalados por padrão no cliente
• Se os componentes recomendados também devem ser instalados
• Se o cliente deve respeitar um arquivo de instalação *.vsconfig
• De onde o cliente deve receber atualizações
• Se componentes sem suporte devem ser removidos durante uma atualização
• Se extensões não assinadas têm permissão para carregar programaticamente e silenciosamente

Veja mais informações na página Automatizar a instalação do Visual Studio com um arquivo de resposta.

Tornando seu layout acessível por meio de um site de intranet

A partir de junho de 2023, você poderá disponibilizar seus layouts em um site interno da intranet, o que permite aproveitar o cache de arquivos webserver e os recursos de desempenho de georeplicação. Para usar esse novo recurso, você precisa usar os bootstrappers mais recentes do Visual Studio e o instalador mais recente do Visual Studio. Os administradores de TI devem fazer o seguinte para aproveitar essa funcionalidade de hospedagem na Web da intranet:

1. Primeiro, crie e mantenha um layout de rede e verifique se os bits estão presentes e atualizados regularmente no compartilhamento de rede. Além disso, lembre-se de configurar o valor de channelUri no response.json do layout se quiser que os clientes recebam as atualizações do local do layout da intranet.

2. Em seguida, um administrador precisará preparar um site interno e associar a origem do site ao local do arquivo de rede do layout. Eles também precisam garantir que o servidor web respeite os seguintes tipos MIME:

   Extensão de arquivo	Tipo MIME
   .cab	application/vnd.ms-cab-compressed
   .exe	application/octet-stream
   .json	application/json
   .msi	application/octet-stream
   .msu	application/octet-stream
   .nupkg	application/octet-stream
   .opc	application/octet-stream
   .ps1	application/postscript
   .vsix	application/octet-stream
   .xml	text/xml
   .zip	application/x-zip-compressed

3. Por fim, para implantar esse layout no cliente, executar um script do PowerShell no cliente para executar a instalação inicial. Depois que o Visual Studio for instalado com êxito no cliente de um layout hospedado na Web, atualizações de cliente para layouts hospedados na Web poderão ser atualizadas por meio de métodos padrão.

Verifique se o layout está usando o instalador mais recente

Nota

A partir de junho de 2023, o instalador mais recente é fornecido por padrão a cada atualização para todas as versões com suporte do Visual Studio 2017, Visual Studio 2019 e Visual Studio 2022. Portanto, se você estiver usando uma dessas versões do produto, não precisará fazer nada explicitamente para obter a versão mais recente do instalador com a funcionalidade mais recente e correções de bugs.

Se você estiver usando uma versão do Visual Studio enviada antes de junho de 2023, recomendamos que você sempre use o Instalador do Visual Studio mais recente em seu layout e distribua para seus clientes. Por exemplo, se você distribuir o instalador do Visual Studio 2022 no layout do Visual Studio 2019, os clientes do Visual Studio 2019 com base nesse layout terão a capacidade de alterar o local de origem para atualizações ou remover facilmente componentes fora de suporte. Mais detalhes são descritos na seção seguinte.

A funcionalidade para garantir programaticamente que você está usando o instalador mais recente só está disponível para carregadores de inicialização do Visual Studio 2019 criados após o Visual Studio 2022 fornecido originalmente. Portanto, o vs_enterprise.exe no exemplo a seguir deve ser uma versão fornecida após 10 de novembro de 2021.

Para criar um layout de todo o produto que usa o instalador mais recente e o maior disponível, execute

vs_enterprise.exe --layout C:\VSLayout --useLatestInstaller

Manutenção do layout

É uma prática recomendada atualizar periodicamente o layout do Visual Studio para a versão segura mais recente do produto. Isso garante que o layout possa ser usado como um ponto de instalação e uma fonte de atualização para instalações do cliente. A seção a seguir descreve as operações de manutenção de layout mais comuns ou úteis.

Se você hospedar um layout em um compartilhamento de arquivos de rede, talvez queira baixar um layout atualizado para um compartilhamento local privado (por exemplo, c:\VSLayoutUpdate) e, depois que todo o conteúdo atualizado for baixado, copie-o para o compartilhamento de arquivos de rede de layout (por exemplo, \server\products\VS). Se você não fizer isso, os usuários que rodarem a instalação enquanto você estiver atualizando o layout podem encontrar inconsistências no conteúdo, pois o layout ainda não estará completamente atualizado.

Atualizar o layout para a versão mais atual do produto

A Microsoft frequentemente lança versões atualizadas do produto para corrigir problemas de funcionalidade ou segurança. É altamente recomendável manter seu layout atualizado com a versão mais recente do produto para que seus clientes sempre tenham acesso à versão mais recente e segura do produto. Isso é ainda mais importante quando os clientes não têm acesso à Internet e podem receber atualizações do produto apenas por meio do layout. O Visual Studio normalmente lança atualizações de segurança na segunda terça-feira do mês, conhecida como "terça-feira de patch", portanto, uma boa estratégia seria atualizar todos os layouts nas tardes de terça-feira do patch.

Quando você cria o layout inicial, as opções especificadas, como quais cargas de trabalho e idiomas incluir no layout, são salvas no arquivo de configuração do layout layout.json. Posteriormente, ao atualizar esse layout para uma versão mais recente do produto, você não precisará especificar novamente quais componentes do produto deseja no layout. Uma atualização de layout simplesmente atualiza os componentes existentes no layout para sua versão mais atual.

Suponha que você já tenha criado esse layout parcial usando um dos carregadores de inicialização evergreen da tabela acima.

vs_enterprise.exe --layout c:\VSLayout --add Microsoft.VisualStudio.Workload.ManagedDesktop --lang en-US

Atualizar esse layout para a versão mais recente do produto oferecido pela Microsoft e hospedado em servidores Microsoft é fácil. Basta usar o carregador de inicialização evergreen existente no layout e executar o comando --layout em um prompt com privilégios elevados para baixar os pacotes mais recentes no layout, da seguinte maneira:

vs_enterprise.exe --layout c:\VSLayout

Você também pode atualizar seu layout para uma versão atualizada de maneira autônoma. A operação de layout executa o processo de instalação em uma nova janela do console. A janela é deixada aberta para que os administradores possam ver o resultado final da atualização do layout e um resumo de quaisquer erros que possam ter ocorrido. Se você quiser executar uma operação de atualização de layout de maneira autônoma (por exemplo, você tem um script que é executado regularmente para atualizar seu layout para a versão mais recente), use o parâmetro --passive e o processo fechará automaticamente a janela.

vs_enterprise.exe --layout c:\VSLayout --passive

Atualizar o layout para uma versão específica do produto

Às vezes, talvez você queira atualizar seu layout para uma versão específica do produto. Por exemplo, talvez você queira fazer com que seu layout corresponda à versão mais recente e segura da linha de base de manutenção na qual você padroniza sua organização. Veja como fazer isso:

Você pode acessar a página Histórico de Versões do Visual Studio 2022 e baixar um carregador de inicialização de versão fixa específico, copiá-lo em seu layout e usá-lo para atualizar o layout para essa versão especificada no carregador de inicialização. Você usaria exatamente a mesma sintaxe que acima.

Você pode usar uma atualização de administrador para atualizar seu layout para uma versão específica do produto. Para obter a atualização do administrador , acesse o Catálogo de Atualizações da Microsoft e pesquise a atualização para a qual você deseja atualizar seu layout. Baixe o update.exe para o computador que está hospedando o layout, abra um prompt de comando com privilégios elevados nesse computador e execute um comando como este:

visualstudioupdate-17.0.0to17.4.4.exe layout --layoutPath c:\VSLayout

Observe que uma atualização de administrador não iniciará a criação de um novo layout; ele só atualizará um layout existente. Você precisará usar um carregador de inicialização para criar o layout inicial.

Garantir que o layout de rede seja baseado em uma versão com suporte

Ocasionalmente, à medida que os canais fazem a transição para fora do suporte, você precisará garantir que o layout de rede continue sendo baseado em um canal com suporte para que seus clientes possam continuar recebendo notificações de atualizações de segurança. Se o layout for baseado no canal VisualStudio.17.Release.LTSC.17.0, depois que o canal 17.0 LTSC sair do suporte em julho de 2023, não lançaremos mais atualizações de segurança para ele e seu layout e clientes ficarão inseguros. Datas de suporte para vários canais do Visual Studio 2022 estão disponíveis aqui.

Para alterar o canal no qual o layout se baseia, adquira o carregador de inicialização do canal desejado na página Histórico de Versões do Visual Studio 2022, copie-o na sua pasta de layout e execute uma atualização normal. Em seguida, seus clientes devem ser notificados adequadamente de uma atualização para que eles também possam se manter seguros.

Modificar o conteúdo de um layout

É possível modificar um layout parcial e adicionar cargas de trabalho, componentes ou idiomas adicionais. Não é possível remover componentes de forma confiável de um layout.

No exemplo abaixo, adicionaremos a carga de trabalho do Azure e um idioma localizado ao layout que foi criado anteriormente apenas com a carga de trabalho da Área de Trabalho Gerenciada e o idioma inglês. Depois de fazermos a modificação, as cargas de trabalho da Área de Trabalho Gerenciada e do Azure e os recursos em inglês e alemão serão incluídos neste layout. Além de adicionar componentes, o comando --layout também fará com que o layout seja atualizado para a versão especificada pelo bootstrapper. Portanto, se você estiver usando o carregador de inicialização evergreen, o layout resultante terá o novo componente, o novo idioma e todo o conteúdo do layout será atualizado para a versão mais recente no canal do carregador de inicialização.

vs_enterprise.exe --layout c:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --lang de-DE

Se você quiser modificar um layout parcial existente para que ele se torne um layout completo, use a opção --all, conforme mostrado no exemplo a seguir. Novamente, esse comando fará com que o conteúdo do layout seja atualizado para a versão especificada pelo bootstrapper.

vs_enterprise.exe --layout c:\VSLayout --all

Você pode adicionar componentes a um layout passando um arquivo *.vsconfig que contém os componentes adicionais desejados em seu layout. Se você fizer isso, o novo conteúdo de *.vsconfig substituirá o conteúdo de layout.vsconfig existente. Para obter mais informações, consulte a seção anterior Usando um arquivo de configuração para inicializar o conteúdo de um layout.

vs_enterprise.exe --layout C:\VSLayout --config "C:\myupdatedconfig.vsconfig"

Por fim, você pode editar diretamente o arquivo de configuração layout.json na pasta de layout e atualizar a seção "adicionar" desse arquivo para incluir os componentes adicionais que você deseja incluir no layout. Em seguida, você precisará atualizar o layout usando --layout conforme descrito anteriormente para baixar os componentes mais recentes.

Nota

A maneira mais fácil de instalar os componentes de layout recém-adicionados em um computador cliente é executar o bootstrapper no layout do computador cliente. A seção 'add' do arquivo response.json no layout determinará quais componentes serão selecionados por padrão na interface do instalador do cliente. Se você modificou o layout usando um dos métodos acima, convém verificar manualmente e, possivelmente, ajustar a seção 'add' no arquivo response.json para que ele corresponda mais adequadamente ao conteúdo na seção 'add' do arquivo de layout.json recém-modificado.

Configure o layout para remover componentes fora de suporte no computador cliente.

Algumas empresas desejarão aproveitar o recurso introduzido no Visual Studio 2022 versão 17.4 que remove componentes que fizeram a transição para um estado fora de suporte. Isso é relativamente fácil de configurar se você estiver gerenciando um layout e se seus clientes estiverem recebendo atualizações de administrador. Primeiro, você precisará configurar seu layout para incluir a versão mais recente do instalador, conforme descrito abaixo. Em segundo lugar, você precisará adicionar a linha "removeOos": true ao arquivo response.json. Se o layout tiver esses dois detalhes definidos corretamente, as atualizações subsequentes do administrador respeitarão essa configuração e removerão componentes fora de suporte dos computadores cliente.

Verificar um layout

Use --verify para executar a verificação no layout de rede que verifica se os arquivos de pacotes estão ausentes ou inválidos. No final da verificação, ele imprime a lista de arquivos ausentes e inválidos.

A verificação funciona apenas para a versão mais recente de uma versão secundária específica do Visual Studio. Assim que uma nova versão for lançada, a verificação não funcionará para layouts que contenham versões anteriores.

vs_enterprise.exe --layout <layoutDir> --verify

Nota

Alguns arquivos de metadados importantes necessários para a opção --verify devem estar na pasta de layout. Se esses arquivos de metadados estiverem ausentes, "--verificar" não poderá ser executado e o Setup apresentará um erro. Se você experimentar esse erro, tente atualizar o layout novamente ou recriar um novo layout de rede em uma pasta diferente.

Lembre-se de que a Microsoft fornece atualizações do Visual Studio periodicamente, portanto, se você estiver usando um carregador de inicialização evergreen, um layout mais recente poderá não conter a mesma versão do layout inicial. No entanto, se você usa carregadores de inicialização de link fixo, (quase) sempre recebe um conjunto de arquivos determinístico.

Corrigir um layout

Use --fix para executar a mesma verificação que --verify e também tente corrigir os problemas identificados. O processo de --fix precisa de uma conexão com a Internet, portanto, verifique se o computador está conectado à Internet antes de invocar --fix.

vs_enterprise.exe --layout <layoutDir> --fix

Remover versões mais antigas de um layout

Depois de executar atualizações de layout em um cache de rede, a pasta de layout pode ter alguns pacotes obsoletos que não são mais necessários para a instalação mais recente do Visual Studio. Você pode usar a opção --clean para remover pacotes obsoletos da pasta de layout de rede.

Para fazer isso, você precisará dos caminhos de arquivo dos manifestos de catálogo que contêm esses pacotes obsoletos. Você pode encontrar os manifestos de catálogo na pasta "Arquivo morto" do cache de layout de rede. Eles são salvos lá quando você atualiza um layout. Na pasta "Arquivar", há uma ou mais pastas nomeadas "GUID", cada uma delas contendo um manifesto de catálogo obsoleto. O número de pastas "GUID" deve ser o mesmo que o número de atualizações feitas em seus layouts.

Alguns arquivos são salvos dentro de cada pasta "GUID". Os dois arquivos de maior interesse são um arquivo "catalog.json" e um arquivo "version.txt". O arquivo "catalog.json" é o manifesto de catálogo obsoleto que você precisará passar para a opção --clean. O outro arquivo version.txt contém a versão deste manifesto de catálogo obsoleto. Com base no número de versão, você pode decidir se deseja remover pacotes obsoletos deste manifesto de catálogo. Você pode fazer o mesmo à medida que percorre as outras pastas "GUID". Depois de tomar a decisão sobre os catálogos que você deseja limpar, execute o comando --clean fornecendo os caminhos dos arquivos para esses catálogos.

Aqui está um exemplo de como usar a opção --clean:

c:\VSLayout\vs_enterprise.exe --layout c:\VSLayout --clean c:\VSLayout\Archive\1cd70189-fc55-4583-8ad8-a2711e928325\Catalog.json --clean c:\VSLayout\Archive\d420889f-6aad-4ba4-99e4-ed7833795a10\Catalog.json

Quando você executa esse comando, a Instalação analisa sua pasta de layout de rede para localizar a lista de arquivos que ela removerá. Em seguida, você terá a chance de examinar os arquivos que serão excluídos e confirmar as exclusões.

Configurar o layout para sempre incluir e fornecer o instalador mais recente

Nota

A partir de junho de 2023, o instalador mais recente é enviado por padrão a cada atualização para versões com suporte do Visual Studio 2017, Visual Studio 2019 e Visual Studio 2022. Portanto, você não precisará fazer nada explicitamente para obter a versão mais recente do instalador com a funcionalidade e correções de bugs mais recentes no seu layout e em seus clientes.

No entanto, se você estiver usando um layout criado antes de junho de 2023, você também pode configurar explicitamente seu layout para sempre incluir e disponibilizar o instalador mais recente aos seus clientes, mesmo que o instalador seja considerado parte de uma versão mais recente do Visual Studio. Assim, ao atualizar o cliente com esse layout, o cliente adquirirá o instalador mais recente incluído e fornecido pelo layout. O benefício é que, depois que o instalador mais recente estiver no cliente, as instalações do cliente poderão aproveitar as correções de bug e a nova funcionalidade que continuamos a adicionar ao instalador.

Há várias maneiras de habilitar seu layout para incluir e fornecer o instalador mais recente:

• Você pode usar uma versão do Visual Studio criada em junho de 2023 ou posteriormente.

• Você pode passar o parâmetro --useLatestInstaller para o bootstrapper quando estiver criando ou atualizando o layout. Isso fará com que uma configuração seja definida no arquivo layout.json, que pode ser encontrado no diretório raiz do layout. Aqui está um exemplo de como atualizar o layout e configurá-lo para usar o instalador mais recente e maior disponível.

  vs_enterprise.exe --layout C:\VSLayout --useLatestInstaller
  

• Você pode editar o arquivo layout.json diretamente para adicionar essa configuração.

  {
     "installChannelUri": ".\\ChannelManifest.json",
     "channelUri": "\\\\server\\share\\layoutdirectory\\ChannelManifest.json",
     "installCatalogUri": ".\\Catalog.json",
     "channelId": "VisualStudio.16.Release",
     "productId": "Microsoft.VisualStudio.Product.Enterprise",
  
     "useLatestInstaller": true,
     "removeOos": true
  
  }
  

Não há como remover programaticamente essa configuração no arquivo layout.json, portanto, se você quiser que seu layout pare usando o instalador mais recente que a Microsoft disponibiliza e, em vez disso, use a versão do instalador que corresponde ao bootstrapper (que provavelmente é mais antigo que o instalador mais recente), edite o arquivo layout.json e remova a configuração de "UseLatestInstaller": true.

Observe que você também pode encontrar essa configuração "UseLatestInstaller": true no arquivo response.json do layout, mas ela é ignorada lá para garantir que o layout sempre tenha o instalador mais recente. O arquivo response.json é usado para definir opções de configuração padrão no cliente quando o cliente instala ou atualiza de um layout. Essa configuração específica de "useLatestInstaller": true no arquivo layout.json é utilizada para garantir que o conteúdo do layout contém o instalador mais recente, permitindo, assim, que as máquinas cliente possam adquirir o instalador mais atualizado do layout.

Códigos de erro

Se você usou o parâmetro --wait, dependendo do resultado da operação, a variável de ambiente %ERRORLEVEL% será definida como um dos seguintes valores:

Valor	Resultado
0	Operação concluída com êxito
740	Elevação necessária
1001	O processo do instalador do Visual Studio está em execução
1003	O Visual Studio está em uso
1602	A operação foi cancelada
1618	Outra instalação em execução
1641	Operação concluída com êxito e reinicialização iniciada
3010	A operação foi concluída com êxito, mas a instalação requer reinicialização antes que possa ser usada
5003	Falha do Bootstrapper ao baixar o instalador
5004	A operação foi 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 do computador Arm
8002	Falha de pré-verificação de download em segundo plano
8003	Falha selecionável sem suporte
8004	Falha no diretório de destino
8005	Falha de verificação do conteúdo de origem
8006	Processos do Visual Studio em execução
8010	Não há suporte para o Sistema Operacional. Consulte os requisitos do sistema
-1073720687	Falha de conectividade
-1073741510	O Instalador do Microsoft Visual Studio foi encerrado (pelo usuário ou pelo processo externo)
Outro (por exemplo: -1, 1, 1603)	Condição de falha - verifique os logs para obter mais informações

Obter suporte para seu layout de rede

Se você tiver um problema com o layout de rede, queremos saber mais sobre ele. A melhor maneira de nos informar é usando a ferramenta Relatar um Problema que aparece no Instalador do Visual Studio e no IDE do Visual Studio. Se você for um Admin de TI e não tiver o Visual Studio instalado, poderá enviar feedback de Admin de TI aqui . Quando você usa essa ferramenta, seria muito útil se você pudesse enviar os logs pela ferramenta Visual Studio Collect que pode nos ajudar a diagnosticar e corrigir o problema.

Também oferecemos uma opção de suporte via chat para instalação (apenas em inglês) para problemas relacionados à instalação.

Também temos outras opções de suporte disponíveis. Veja nossa Comunidade de Desenvolvedores do Visual Studio .

Conteúdo relacionado

• guia de administrador do Visual Studio
• Implantar o Visual Studio a partir de um layout em uma máquina cliente
• Atualizar uma instalação baseada em rede do Visual Studio
• Solucionar problemas de erros relacionados à rede ao instalar ou usar o Visual Studio
• Configurar políticas para implantações empresariais do Visual Studio
• Ciclo de vida e manutenção do produto do Visual Studio
• Usar parâmetros de linha de comando para instalar o Visual Studio
• Carga de trabalho e IDs de componente do Visual Studio
• Instalar certificados necessários para a instalação offline do Visual Studio