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.

A criação de um layout é útil nos seguintes cenários:

• Usuário com permissões limitadas do sistema
• Máquinas clientes com acesso restrito à Internet
• A 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 um layout com o conteúdo correto do produto, definir as configurações padrão, armazenar o layout 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.

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é o diretório onde você baixou o bootstrapper e use seus parâmetros conforme definido na página usar parâmetros de linha de comando para instalar o Visual Studio para criar e manter seu layout de rede. Os exemplos a seguir mostram maneiras comuns de criar layouts iniciais. Você pode encontrar mais exemplos nos exemplos de parâmetros 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. 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

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 precisa preparar um site interno e vincular 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 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

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 bootstrappers do Visual Studio 2019 criados após o Visual Studio 2022 ter sido originalmente lançado. 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

É considerado 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 como 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, baixe um layout atualizado para um compartilhamento local privado (por exemplo, c:\VSLayoutUpdate). Depois de o conteúdo atualizado ser baixado, copie-o para a partilha de ficheiros de rede do 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 poderão obter uma incompatibilidade de conteúdo do layout porque ele ainda não foi 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 você já criou esse layout parcial usando um dos bootstrappers evergreen na tabela anterior.

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 ocorram. 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 --passive parâmetro e o processo fecha 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:

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

visualstudioupdate-18.0.0to18.4.4.exe layout --layoutPath c:\VSLayout

Modificar o conteúdo de um layout

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

No exemplo a seguir, adicionamos a carga de trabalho do Azure e um idioma localizado ao layout que foi criado anteriormente apenas com a carga de trabalho do Managed Desktop 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 são incluídos neste layout. Além de adicionar componentes, o --layout comando também faz com que o layout seja atualizado para a versão especificada pelo bootstrapper. Portanto, se você estiver usando 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 faz 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 *.vsconfig arquivo que contém outros componentes 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ê precisa atualizar o layout usando --layout como descrito anteriormente para baixar os componentes mais recentes.

Configurar 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

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

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.

Você pode encontrar essa "UseLatestInstaller": true configuração no arquivo do response.json 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:

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