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

📣 Adoraríamos ouvir o seu feedback!Por favor, reserve um momento para completar este de pesquisa e deixe-nos saber como podemos melhorar a experiência de layout. Obrigado pelo vosso apoio!

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

Criar um layout é útil nas seguintes situações:

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

Projetamos 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 atualizações subsequentes.

As informações contidas nesta página estão agrupadas em três secçõ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 sobre a melhor forma de atualizar 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 de compartilhamento de arquivos de rede

Primeiro, você precisa determinar onde armazenará os pacotes do Visual Studio baixados. 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), deverá 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 também consomem espaço em disco.

O caminho do 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 do Visual Studio que você deseja e copie-o para o diretório que você deseja servir como repositório do layout. Depois que o layout é criado, você pode usá-lo para instalar o Visual Studio em qualquer máquina 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 bootstrappers a seguir sempre instalam a versão mais recente e segura do Visual Studio 2022 no canal Atual, não importa quando você os executa. Como alternativa, se pretender criar ou atualizar um layout para uma versão específica ou para um canal específico do Visual Studio 2022, descarregue o instalador sempre atualizado e de versão fixa para a versão de manutenção do canal desejado a partir do Histórico de Versões do Visual Studio 2022. Copie-o para o diretório que você deseja que sirva como o local de origem do layout.

Edição	Bootstrapper
Visual Studio 2022 Enterprise	vs_enterprise.exe
Visual Studio 2022 Profissional	vs_professional.exe
Comunidade do Visual Studio 2022	vs_community.exe
Ferramentas de compilação do Visual Studio 2022	vs_buildtools.exe

Dica

Se você baixou anteriormente um arquivo de bootstrapper e deseja verificar qual versão ele será instalado, veja como. No Windows, abra o Explorador de Ficheiros, clique com o botão direito do rato no ficheiro de bootstrapper, escolha Propriedades e, em seguida, escolha o separador Detalhes. O campo Versão do produto descreve o canal e a versão que o bootstrapper instalará. O número da versão deve ser sempre interpretado como "a versão mais recente de manutenção do que é especificado", e o canal é considerado como Atual, exceto se especificado de outra forma. Assim, um bootstrapper com uma versão Product do LTSC 17.0 instala a versão de manutenção 17.0.x mais recente que está disponível no canal LTSC 17.0. Um bootstrapper com uma versão do Produto denominada Visual Studio 2022 instala a versão de manutenção mais recente do Visual Studio 2022 no canal Atual.

Baixe os pacotes do Visual Studio

Tem de ter uma ligação à Internet para concluir este passo.

Abra um prompt de comando elevado, navegue até ao diretório onde descarregou o "bootstrapper", e utilize os parâmetros do "bootstrapper" conforme definidos na página "use parâmetros de linha de comando para instalar o Visual Studio" para criar e manter o seu layout de rede. Os exemplos a seguir ilustram maneiras comuns de criar layouts iniciais. Mais exemplos podem ser encontrados na página de exemplos de parâmetros de linha de comando para uma 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. Localizações de idioma extras requerem cerca de metade de um GB cada um.

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 de cliente tem acesso a toda a oferta de produto do Visual Studio e a capacidade de instalar qualquer subconjunto. Para criar um layout completo completo do Visual Studio, execute o seguinte comando do diretório no qual você planeja hospedar o layout de rede:

vs_enterprise.exe --layout c:\VSLayout

Verifique se o seu layout é baseado no canal certo

É importante garantir que o layout de rede seja baseado no canal de correto, porque é um dos critérios que atualizações de administrador, se 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 LTSC 17.0 estarão disponíveis para os clientes que instalaram ou atualizaram a partir desse layout.

Os bootstrappers listados anteriormente são baseados no canal atual. Para criar um layout baseado num dos canais LTSC, adquira o bootstrapper do canal correto da página Histórico de versões do Visual Studio 2022, copie-o para a 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 seu layout de rede. Você pode criar um layout parcial que contenha apenas um conjunto específico de localizações de idioma, cargas de trabalho , componentes e suas dependências recomendadas ou opcionais. Um layout parcial é útil se você souber que implantará apenas um subconjunto de cargas de trabalho em estações de trabalho cliente. Os parâmetros típicos da linha de comando para personalizar o layout incluem:

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

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

• Para criar um layout com os 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 os 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. Certifique-se de especificar o caminho completo do arquivo de configuração. O uso de um arquivo *.vsconfig durante a criação do layout personaliza e limita o conteúdo de um layout de rede ao especificado no arquivo de configuração. O arquivo de configuração é copiado para o diretório de layout e renomeado para layout.vsconfig.

Todas as 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 layout.vsconfig recém-criado, definindo o local de instalação para as extensões do cliente. Se estiver a instalar extensões que não estão assinadas digitalmente, certifique-se de que edita o response.json para adicionar "allowUnsignedExtensions": true. Veja response.json exemplos de conteúdo.

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

Copiar o layout para uma partilha de rede

Você precisa hospedar o layout em um compartilhamento de rede para que ele possa ser acessado a partir das máquinas clientes. Se você criou o layout em uma máquina local, precisará copiá-lo para um local de arquivo de rede. O exemplo a seguir usa xcopy. Você também pode usar robocopy, se desejar. Exemplo:

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

Configurar padrões de instalação inicial 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 a serem definidas 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
• Onde o cliente deve receber atualizações de
• Se os componentes fora de suporte devem ser removidos durante uma atualização
• Se as extensões não assinadas puderem ser executadas programaticamente de forma silenciosa &

Mais informações podem ser encontradas na página Automatizar a instalação do Visual Studio com um ficheiro de resposta.

Tornar o seu layout acessível através de um site de intranet

A partir de junho de 2023, você poderá disponibilizar seus layouts em um site de intranet interno, o que permite aproveitar os recursos de cache de arquivos do servidor Web e de desempenho de replicação geográfica. 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 esse recurso de hospedagem na Web da intranet:

1. Primeiro, crie e mantenha um layout de rede e certifique-se de que os bits estejam presentes e atualizados regularmente no compartilhamento de rede. Além disso, lembre-se de configurar o valor channelUri no response.json do layout se quiser que os seus clientes obtenham as suas atualizações da localização do layout na intranet.

2. Em seguida, um administrador precisará preparar uma página interna e vincular a origem da página ao local do arquivo de rede do layout. Eles também precisam garantir que o servidor web respeite os seguintes tipos de 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 é instalado com êxito no cliente a partir de um layout hospedado na Web, as atualizações do cliente para layouts hospedados na Web podem ser atualizadas por meio de métodos padrão.

Verifique se a configuração está a usar o instalador mais recente

Observação

A partir de junho de 2023, o instalador mais recente é fornecido por padrão com todas as atualizações 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 mais recente do Visual Studio em seu layout e distribua-o para seus clientes. Por exemplo, se você distribuir o instalador do Visual Studio 2022 em seu layout do Visual Studio 2019, seus clientes do Visual Studio 2019 baseados nesse layout terão a capacidade de alterar o local de origem das atualizações ou remover facilmente os componentes fora do suporte. Mais detalhes são descritos na seção seguinte.

A capacidade de garantir programaticamente que está a usar o instalador mais recente só está disponível para os bootstrappers do Visual Studio 2019 que foram criados após o lançamento original do Visual Studio 2022. Portanto, o vs_enterprise.exe no exemplo a seguir deve ser uma versão que foi enviada após 10 de novembro de 2021.

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

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

Mantendo seu 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 de 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 executarem a instalação enquanto você estiver atualizando o layout podem obter uma incompatibilidade de conteúdo do layout porque ele ainda não foi completamente atualizado.

Atualize 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. Recomendamos vivamente que mantenha o seu layout atualizado com a versão mais recente do produto para que os seus clientes tenham sempre acesso à versão mais recente e segura do produto. Isso é especialmente importante se seus clientes não tiverem acesso à internet e puderem apenas receber atualizações de produtos do layout. O Visual Studio normalmente lança atualizações de segurança na segunda terça-feira do mês, conhecida como "patch Tuesday", portanto, uma boa estratégia seria atualizar todos os seus layouts nas tardes de patch Tuesday.

Quando você cria o layout inicial, as opções especificadas, como quais cargas de trabalho e idiomas devem ser incluídos no layout, são salvas no arquivo de configuração do layout layout.json. Mais tarde, quando você atualizar esse layout para uma versão mais recente do produto, não será necessário especificar novamente quais componentes do produto você deseja no layout. Uma atualização de layout simplesmente atualiza os componentes existentes no layout para sua versão mais atual.

Suponha que já criaste este layout parcial usando , um dos bootstrappers evergreen na tabela acima.

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

Atualizar este layout para a versão mais recente do produto oferecido pela Microsoft e hospedado em servidores da Microsoft é fácil. Você só precisa usar o bootstrapper evergreen existente no layout e executar o comando --layout em um prompt elevado para baixar os pacotes mais recentes em seu 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 configuração em uma nova janela do console. A janela é deixada aberta para que os administradores possam ver o resultado final da atualização de 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, você pode querer atualizar seu layout para uma versão específica do produto. Por exemplo, talvez você queira fazer com que seu layout corresponda à versão segura mais recente da linha de base de manutenção na qual você padronizou sua organização. Veja como fazer isso:

Você pode ir para a página do Histórico de Versões do Visual Studio 2022, baixar um bootstrapper de uma versão fixa específica, copiá-lo para o seu layout e usá-lo para atualizar o layout para a versão exata especificada no bootstrapper. Você usaria exatamente a mesma sintaxe acima.

Você pode usar uma atualização de administrador para atualizar o layout para uma versão específica do produto. Para obter o de atualização do administrador do, vá para o Catálogo do Microsoft Updatee procure a atualização para a qual deseja atualizar o layout. Transfira o update.exe para o computador que está a alojar o esquema, abra uma linha de comandos elevada 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 bootstrapper para criar o layout inicial.

Garantir que o layout da rede seja baseado em uma versão suportada

Ocasionalmente, à medida que os canais deixam de ser suportados, terá de garantir que o esquema de rede continua a basear-se num canal suportado para que os seus clientes possam continuar a receber notificações de atualizações de segurança. Se o layout for baseado no canal VisualStudio.17.Release.LTSC.17.0, assim que o canal LTSC 17.0 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. As datas de suporte para vários canais do Visual Studio 2022 podem ser encontradas aqui.

Para alterar o canal no qual o layout se baseia, adquira o bootstrapper do canal desejado na página Histórico de versões do Visual Studio 2022, copie-o para a sua pasta de layout e realize uma atualização normal. Os seus clientes devem ser devidamente notificados de uma atualização para que também possam manter-se 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 um layout de forma confiável.

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 estiveres a usar o bootstrapper '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 bootstrapper.

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 de *.vsconfig que contém os componentes adicionais desejados no layout. Se você fizer isso, o novo conteúdo *.vsconfig substituirá o conteúdo 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 deseja incluir no layout. Em seguida, você precisará atualizar o layout usando --layout conforme descrito anteriormente para baixar os componentes mais recentes.

Observação

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

Configure o layout para remover componentes fora de suporte na máquina 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 sem 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 ter 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 os componentes fora de suporte das máquinas 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, imprime a lista de ficheiros em falta 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

Observação

Alguns arquivos de metadados importantes que são necessários para a opção --verify devem estar na pasta de layout. Se esses arquivos de metadados estiverem faltando, "--verify" não pode ser executado e a Instalação lhe dará um erro. Se ocorrer esse erro, tente atualizar o layout novamente ou recrie um novo layout de rede em uma pasta diferente.

Lembre-se de que a Microsoft envia atualizações para o Visual Studio periodicamente, portanto, se você estiver usando um de bootstrapper evergreen, um layout mais recente pode não conter a mesma versão do layout inicial. No entanto, se você usar um bootstrappers de link fixo, então você (quase) sempre obterá um conjunto de arquivos determinísticos.

Corrigir um layout

Use --fix para executar a mesma verificação que --verify e também tentar corrigir os problemas identificados. O processo --fix precisa de uma ligação à Internet, por isso certifique-se de que a sua máquina está ligada à 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 para 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á do(s) caminho(s) do arquivo para catalogar o(s) manifesto(s) que contêm esses pacotes obsoletos. Você pode encontrar os manifestos do catálogo numa pasta "Arquivo" no cache do layout de rede. Eles são salvos lá quando você atualiza um layout. Na pasta "Arquivo", há uma ou mais pastas nomeadas "GUID", cada uma das quais contém 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 desse manifesto de catálogo obsoleto. Com base no número da versão, você pode decidir se deseja remover pacotes obsoletos desse manifesto de catálogo. Você pode fazer o mesmo à medida que passa pelas outras pastas "GUID". Depois de tomar a decisão sobre o(s) catálogo(s) que 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 executa este comando, o programa de configuração analisa a pasta de esquema de rede para encontrar a lista de ficheiros que irá remover. Você terá a chance de rever os arquivos que serão excluídos e confirmar as exclusões.

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

Observação

A partir de junho de 2023, o instalador mais recente será enviado por padrão com todas as atualizações para versões com suporte do Visual Studio 2017, Visual Studio 2019 e Visual Studio 2022. Assim, você 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 em seu layout e em seus clientes.

No entanto, se você estiver usando um layout que foi criado antes de junho de 2023, também poderá configurar explicitamente seu layout para sempre incluir e fornecer o instalador mais recente para seus clientes, mesmo que o instalador seja considerado parte de uma versão mais recente do Visual Studio. Assim, quando o seu cliente atualiza a partir deste layout, o cliente irá adquirir o instalador mais recente que está incluído e fornecido por este layout. A vantagem é que, uma vez que o instalador mais recente esteja no seu cliente, as instalações do seu cliente poderão tirar proveito das correções de bugs e novas funcionalidades que continuamos a adicionar ao instalador.

Há várias maneiras de permitir que seu layout inclua e forneça o instalador mais recente:

• Você pode usar uma versão do Visual Studio que foi criada em ou após junho de 2023.

• 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 melhor 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 de usar 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 antiga do que o instalador mais recente), edite o arquivo layout.json e remova a configuração "UseLatestInstaller": true.

Observe que você pode encontrar essa configuração de "UseLatestInstaller": true no arquivo de response.json do layout também, 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 a partir de um layout. Essa configuração de "useLatestInstaller": true específica no arquivo de layout.json é usada para garantir que o conteúdo do layout contenha o instalador mais recente, para que as máquinas clientes possam adquirir o instalador mais recente 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% é definida como um dos seguintes valores:

valor	resultado
0	Operação concluída com êxito
740	Elevação necessária
1001	O processo de instalação do Visual Studio está em execução
1003	O Visual Studio está em uso
1602	Operação cancelada
1618	Outra instalação em execução
1641	Operação concluída com êxito e reinicialização foi iniciada
3010	Operação concluída com êxito, mas a instalação requer reinicialização antes de poder ser usada
5003	O Bootstrapper não conseguiu fazer o download do instalador
5004	Operação 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 da máquina de armamento
8002	Falha na verificação prévia do download em segundo plano
8003	Falha selecionável fora do suporte
8004	Falha no diretório de destino
8005	Verificando a falha das cargas úteis de origem
8006	Processos do Visual Studio em execução
8010	Sistema operacional não suportado. Consulte os Requisitos do sistema
-1073720687	Falha de conectividade
-1073741510	Microsoft Visual Studio Installer foi encerrado (pelo usuário ou processo externo)
Outros (por exemplo: -1, 1, 1603)	Ocorreu uma condição de falha - verifique os logs para obter mais informações

Obtenha suporte para o seu layout de rede

Se você tiver um problema com o layout da sua rede, queremos saber sobre isso. A melhor maneira de nos informar é usando a ferramenta Report a Problem que aparece no Visual Studio Installer e no IDE do Visual Studio. Se você for um administrador de TI e não tiver o Visual Studio instalado, envie comentários do administrador 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 de chat para instalação , disponível apenas em inglês, para problemas relacionados com a instalação.

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

Conteúdo relacionado

• Guia do 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 erros relacionados à rede quando você instala ou usa o Visual Studio
• Configurar políticas para implantações corporativas do Visual Studio
• ciclo de vida e suporte do produto Visual Studio
• Usar parâmetros de linha de comando para instalar o Visual Studio
• carga de trabalho do Visual Studio e IDs de componentes
• Instalar certificados necessários para a instalação offline do Visual Studio