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

  • Artigo

Aplica-se a:simVisual Studio nãoVisual Studio para Mac nãoVisual Studio Code

Às vezes, um administrador corporativo deseja criar um ponto de instalação de rede contendo arquivos do Visual Studio que podem ser implantados em estações de trabalho do cliente. A ideia é facilitar cenários em que os computadores cliente podem ter permissões limitadas ou acesso limitado à Internet ou para quando 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 de rede (cache de arquivos), que pode ser armazenado em um compartilhamento de rede interno. O layout de rede inclui todos os arquivos do Visual Studio necessários para a instalação inicial e para as atualizações subsequentes do produto.

Há muitas informações nesta página da Web, que foram agrupadas nas seguintes seções:

  • Antes de começar: destaca dicas e outras considerações importantes sobre as quais você deve pensar no planejamento.
  • Adquira o bootstrapper correto: orientação sobre onde encontrar e como distinguir os vários bootstrappers disponíveis para uso.
  • Criar o layout de rede: descreve como criar o layout com o conteúdo correto do produto, as configurações de canal e a versão do instalador e como copiá-lo em um compartilhamento de rede.
  • Atualizar, modificar e manter o layout de rede: informações sobre como manter o layout da melhor maneira, incluindo como atualizar a versão do produto do layout, o conteúdo do produto, as configurações de canal, a versão do instalador e o tamanho da pasta.
  • Instalar o layout em computadores cliente: descreve como definir as configurações padrão do cliente, tais como quais cargas de trabalho e componentes devem ser instalados por padrão e onde o cliente deve procurar atualizações. Também inclui como fazer a instalação inicial do layout do Visual Studio nos computadores cliente. As diretrizes e informações sobre a atualização de computadores cliente que foram originalmente instalados a partir de um layout são abordadas na atualização separada de uma instalação baseada em rede da página do Visual Studio.
  • Ajuda e suporte: onde pedir ajuda

Antes de começar

Há algumas coisas importantes a planejar e estar ciente antes de começar.

  • Gerenciamento de pastas: se você tiver várias edições do Visual Studio em uso em sua empresa (por exemplo, o Visual Studio 2019 Professional e o Visual Studio 2019 Enterprise), precisará criar um ponto de instalação de rede separado para cada edição. E o caminho de layout deve ter menos de 80 caracteres, embora algumas organizações tenham usado com êxito os links simbólicos para contornar a limitação de 80 caracteres.
  • Planejamento para Atualizações: você deve decidir como seus computadores cliente devem receber atualizações de produtos antes de fazer a instalação inicial do cliente. Isso é necessário para garantir que a configuração do local de atualização dos clientes seja definida corretamente. Suas opções incluem fazer com que os clientes obtenham atualizações do local de layout de rede ou dos servidores hospedados pela Microsoft na Internet.

Importante

Quando você usa apenas a funcionalidade do Visual Studio 2019, existe a seguinte limitação com o gerenciamento de layout: depois que o cliente for instalado a partir do layout, o local de atualização do cliente será bloqueado e não poderá ser alterado. Se você pretende que seus clientes recebam atualizações de layout preservando a funcionalidade de reparo e desinstalação, deverá colocar todas as atualizações subsequentes do produto na pasta de layout original de onde foi feita a instalação dos clientes. Em outras palavras, a funcionalidade base do Visual Studio 2019 não dá suporte para que um cliente faça uma instalação original de um local de layout e depois faça as atualizações de produto de um local de layout diferente.

Essa limitação de que o local de atualização do produto é corrigido e as atualizações de produto devem estar na mesma pasta de layout que o layout de instalação original não existe no Visual Studio 2022. No Visual Studio 2022, você pode alterar facilmente o local de origem para as atualizações do cliente. Possibilitamos incluir e usar o instalador mais recente (Visual Studio 2022), que rege todas as versões modernas da família de produtos do Visual Studio, para gerenciar seus layouts do Visual Studio 2019 e eliminar a limitação na versão 2019 do produto. A seção abaixo Configurar o layout para sempre incluir e fornecer o instalador mais recente descreve como habilitar essa opção.

  • Gerenciamento de pastas: se você tiver várias edições do Visual Studio em uso em sua empresa (por exemplo, o Visual Studio 2022 Professional e o Visual Studio 2022 Enterprise), precisará criar um ponto de instalação de rede separado para cada edição. E o caminho de layout deve ter menos de 80 caracteres, embora algumas organizações tenham usado com êxito os links simbólicos para contornar a limitação de 80 caracteres.
  • Planejamento para Atualizações: recomendamos que você decida como seus computadores cliente devem receber atualizações de produtos antes de fazer a instalação inicial do cliente. Isso é necessário para garantir que a configuração do local de atualização dos clientes seja definida corretamente. Suas opções incluem fazer com que os clientes obtenham atualizações do local de layout de rede ou dos servidores hospedados pela Microsoft na Internet. Felizmente, também é possível configurar o local de origem do cliente para atualizações após a instalação inicial.

Baixar o bootstrapper do Visual Studio para criar o layout de rede

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

Os bootstrappers listados abaixo sempre instalarão a versão mais segura e mais recente do Visual Studio 2019, não importa quando você executá-los. Como alternativa, se você quiser criar ou atualizar um layout para uma versão específica do Visual Studio 2019, acesse a página Versões do Visual Studio 2019 que tem links para os bootstrappers de versão fixa de cada versão de manutenção e baixe a desejada. Copie o bootstraper diretamente no diretório que você deseja usar como o local de origem do layout.

Edition Bootstrapper
Visual Studio 2019 Enterprise versão 16.11 vs_enterprise.exe
Visual Studio 2019 Professional versão 16.11 vs_professional.exe
Ferramentas de Build do Visual Studio 2019 versão 16.11 vs_buildtools.exe

Outros bootstrappers compatíveis incluem vs_teamexplorer.exe, vs_testagent.exe e vs_testcontroller.exe.

Os bootstrappers listados abaixo sempre instalarão a versão mais segura e mais recente do Visual Studio 2022 no canal atual, não importa quando você executá-los. Como alternativa, se você quiser criar ou atualizar um layout para uma versão ou canal específicos do Visual Studio 2022, acesse a página Histórico de Versões do Visual Studio 2022 que tem links para os bootstrappers evergreen e de versão fixa de cada versão de manutenção em cada canal e baixe a desejada. Copie o bootstraper diretamente no diretório que você deseja usar como o local de origem do layout.

Edition Bootstrapper
Visual Studio 2022 Enterprise vs_enterprise.exe
Visual Studio 2022 Professional vs_professional.exe
Visual Studio 2022 Community vs_community.exe
Ferramentas de Build do Visual Studio 2022 vs_buildtools.exe

Dica

Se você baixou anteriormente um arquivo de bootstrapper e deseja verificar qual versão ele instalará, confira aqui como fazer. No Windows, abra o Explorador de Arquivos, clique com o botão direito do mouse no arquivo bootstrapper, escolha Propriedades, depois a guia Detalhes e veja o número da versão do produto. Para corresponder esse número a uma versão do Visual Studio, confira a tabela na parte inferior da página Versões do Visual Studio 2019.

Dica

Se você baixou anteriormente um arquivo de bootstrapper e deseja verificar qual versão ele instalará, confira como fazer. No Windows, abra o Explorador de Arquivos, clique com o botão direito do mouse no arquivo bootstrapper, escolha Propriedades e escolha a guia Detalhes. O campo Versão do produto descreverá o canal e a versão que o bootstrapper instalará. O número de versão sempre deve ser lido como "versão de manutenção mais recente do que é especificado", e assume-se que o canal seja o Atual, a menos que especificado explicitamente. Portanto, um bootstrapper com uma Versão de produto do LTSC 17.0 instalará a versão de manutenção 17.0.x mais recente disponível no canal LTSC 17.0. Um bootstrapper com uma Versão de produto que simplesmente diz que o Visual Studio 2022 instalará a versão de manutenção mais recente do Visual Studio 2022 no canal Atual.

Criar o layout de rede

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

Abra um prompt de comando com privilégios de administrador, navegue até o diretório no qual você baixou o bootstrapper e use os parâmetros do bootstrapper, como definido na página usar parâmetros de linha de comando para instalar o Visual Studio para criar e manter o layout de rede. Exemplos comuns de criação de layouts iniciais são ilustrados abaixo e na página exemplos de parâmetros de linha de comando para instalação do Visual Studio.

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

A abordagem recomendada é criar um layout inicial de Visual Studio Enterprise com todos os idiomas e cargas de trabalho no diretório de layout do servidor de rede. Dessa forma, seus clientes terão acesso à oferta completa do produto. Para criar um layout completo do Visual Studio, execute o seguinte no computador no qual você planeja hospedar o layout de rede:

vs_enterprise.exe --layout c:\VSLayout

Verifique se o layout está com o canal correto

É importante garantir que o layout de rede seja baseado no canal correto, pois esse é um dos critérios que o administrador atualiza; se forem implantados em toda a organização, use 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 que disponibilizarmos no canal 17.0 LTSC estarão disponíveis para os clientes que instalaram ou atualizaram desse layout.

Os bootstrappers listados acima são baseados no canal Atual. Para criar um layout baseado em um dos canais LTSC, basta adquirir o bootstrapper correto do canal na página Histórico de Versões do Visual Studio 2022, copiá-lo para a sua pasta de layout e usá-lo para criar ou atualizar o layout.

Configurar o conteúdo de um layout de rede

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. Isso pode ser útil se você sabe que só vai implantar um subconjunto de cargas de trabalho em estações de trabalho cliente. Parâmetros de linha de comando típicos para personalizar o layout incluem:

  • --add para especificar IDs de componente ou carga de trabalho.
    Se --add for usado, somente as cargas de trabalho e os componentes especificados com --add serão baixados. Se --add não for usado, todas as cargas de trabalho e todos os componentes 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.
  • --lang para especificar localidades de idiomas.

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

  • Para criar um layout com todas as cargas de trabalho e componentes para um único idioma, execute:

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

  • Para criar um layout com todas as cargas de trabalho e componentes para diversos 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 recomendados para essa carga de trabalho e para 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 para 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 .vsconfig para personalizar o conteúdo do layout

Você também pode usar um arquivo vsconfig exportado para personalizar o conteúdo de um layout de rede.

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

Verifique se o layout está usando o instalador mais recente

Observação

A partir de abril de 2023, o instalador mais recente será 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.

Se você estiver usando uma versão do Visual Studio que foi enviada antes de abril de 2023, recomendamos que você sempre use o Instalador do Visual Studio mais recente em seu layout e distribua-o aos seus clientes. Por exemplo, se você distribuir o Instalador do Visual Studio 2022 em seus layouts do Visual Studio 2019, os clientes do Visual Studio 2019 com base nesse layout poderão alterar o local de origem das atualizações ou remover componentes sem suporte. Mais detalhes estão descritos abaixo

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

  • Para criar um layout do produto inteiro que usa o maior e mais recente instalador disponível, execute

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

Copiar o layout para um compartilhamento de rede

Você precisará hospedar o layout em um compartilhamento de rede para que ele possa ser executado nos computadores clientes. Se você criou o layout em um computador local, precisará copiá-lo para um local de rede. O exemplo a seguir usa xcopy. Também é possível usar o robocopy, caso queira. Exemplo:

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

Importante

Para evitar um erro, verifique se o caminho de instalação completo no compartilhamento de rede tem menos do que 80 caracteres. Algumas organizações usaram com êxito os links simbólicos para contornar a limitação de 80 caracteres.

Mantendo o layout

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

Se você hospedar um layout em um compartilhamento de arquivo, atualize uma cópia privada do layout (por exemplo, c:\vsoffline) e, depois que todo o conteúdo atualizado for baixado, copie-a no compartilhamento de arquivo (por exemplo, \\server\products\VS). Se você não fizer isso, haverá uma possibilidade de que os usuários que executarem a instalação enquanto o layout estiver sendo atualizado não consigam obter todo o conteúdo do layout que ainda não estará completamente atualizado.

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

A Microsoft lança com frequência versões atualizadas do produto para corrigir problemas de funcionalidade ou segurança. É altamente recomendável que você mantenha seu layout atualizado com a versão mais recente do produto para que os clientes sempre tenham acesso à versão mais recente e segura do produto. Isso é extremamente importante se os clientes não têm acesso à Internet e só podem receber atualizações de produtos do layout.

Quando você cria o layout inicial, as opções especificadas, tais como quais cargas de trabalho e idiomas a incluir no layout, são salvas no arquivo de configuração do layout. Posteriormente, ao atualizar o 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 para sua versão mais atual.

Suponha que você já tenha criado esse layout parcial usando um dos bootstrappers evergreen da tabela acima.

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

É fácil atualizar esse layout para a versão mais recente do produto, oferecida pela Microsoft e hospedada em servidores Microsoft. Você só precisa usar o bootstrapper evergreen existente no layout e executar o comando --layout para baixar os pacotes mais recentes em seu layout, da seguinte maneira:

vs_enterprise.exe --layout c:\VSLayout

É assim que se atualiza o layout para uma versão mais recente 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 dos erros que podem ter ocorrido. Se você quiser executar uma operação de atualização de layout de maneira autônoma (por exemplo, se você tiver um script que é executado regularmente para atualizar seu layout para a versão mais recente), então, 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 determinada versão do produto. Por exemplo, talvez você queira fazer com que seu layout corresponda à versão mais recente segura da linha de base de manutenção que você padronizou na sua organização. Veja como fazer isso:

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

Você pode usar uma atualização de administrador para atualizar seu layout para uma versão específica. Para obter a atualização do administrador, acesse o Catálogo do Microsoft Update e pesquise pela versão de atualização desejada. Baixe o update.exe no computador que está hospedando o layout, abra um prompt de comando e execute um comando da seguinte maneira:

visualstudioupdate-16.0.0to16.11.23.exe layout --layoutPath c:\VSLayout

Observe que as atualizações do administrador não iniciarão uma instalação de layout original, mas atualizarão apenas um layout existente ou uma instância de cliente.

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

Você pode usar uma atualização de administrador para atualizar seu layout para uma versão específica. Para obter a atualização do administrador, acesse o Catálogo do Microsoft Update e pesquise a atualização que você deseja usar para atualizar seu layout. Baixe o update.exe no computador que está hospedando o layout, abra um prompt de comando nesse computador e execute um comando da seguinte maneira:

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

Observe que as atualizações do administrador não iniciarão uma instalação de layout original, mas atualizarão apenas um layout existente ou uma instância de cliente.

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 continuará sendo baseado em um canal com suporte para que 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, depois que o canal 17.0 LTSC ficar sem suporte, não lançaremos mais atualizações de segurança para ele, assim, seu layout e clientes ficarão inseguros.

Para alterar o canal no qual o layout se baseia, basta adquirir o bootstrapper do canal desejado na página Histórico de Versões do Visual Studio 2022, copiá-lo na sua pasta de layout e executar uma atualização normal. Em seguida, seus clientes devem ser notificados adequadamente sobre a atualização para que também possam se manter seguros.

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 modo confiável.

No exemplo a seguir, 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 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 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 atualizar um layout existente para que se torne um layout completo, use a opção --all, como 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 no layout.

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

Por fim, você pode editar diretamente o arquivo de configuração layout.json na pasta de layout e atualizar a seção "add" 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 um computador cliente é executar o bootstrapper no layout do computador cliente. A seção 'add' do arquivo response.json no layout determinará quais componentes são selecionados por padrão na interface do usuário 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 ela corresponda mais adequadamente ao conteúdo na seção 'add' do arquivo layout.json recém-modificado.

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

Algumas empresas vão querer aproveitar o recurso introduzido no Visual Studio 2022 versão 17.4, que remove componentes que passaram para um estado sem suporte. É algo 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 o layout para ter a versão mais recente do instalador, como descrito acima. Em segundo lugar, você precisará adicionar a linha "removeOos": true ao arquivo response.json, como ilustrado acima. Se o layout tiver esses dois detalhes definidos corretamente, as atualizações subsequentes do administrador respeitarão a configuração e removerão componentes sem suporte dos computadores cliente.

Verificar um layout

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

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á em layouts com versões anteriores.

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

Observação

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

Lembre-se de que a Microsoft envia periodicamente as atualizações para o Visual Studio, portanto, um layout mais recente pode não conter a mesma versão do layout inicial, a menos que você use os bootstrappers de link fixo.

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 conexão de Internet, portanto, verifique se o computador está conectado à Internet antes de você 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 requeridos pela instalação do Visual Studio mais recente. Você pode usar a opção --clean para remover pacotes obsoletos de uma pasta de layout de rede.

Para fazer isso, você precisará dos caminhos de arquivo para os manifestos de catálogo que contêm esses pacotes obsoletos. Você pode encontrar os que manifestos de catálogo na pasta "Arquivo morto" do cache de layout de rede. Eles são salvos nela quando você atualiza um layout. Na pasta "Arquivo morto", há uma ou mais pastas chamadas "GUID", cada qual 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 mais interessantes 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 do manifesto de catálogo. Você pode fazer o mesmo ao percorrer as outras pastas "GUID". Depois de tomar a decisão sobre os catálogos que deseja limpar, execute o comando --clean fornecendo os caminhos de 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á. Você terá a oportunidade 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

Observação

A partir de abril de 2023, o instalador mais recente será 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 abril 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, ao atualizar o cliente com esse layout, o cliente adquirirá o instalador mais recente incluído e fornecido por esse 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 bugs e novas funcionalidades que continuamos a adicionar ao instalador.

Dica

Se você quiser alterar o local em que a instalação do Visual Studio 2019 do cliente procura atualizações, ou se você quer remover todos os componentes sem suporte, então deverá obter o instalador mais recente do Visual Studio 2022 no computador cliente. Uma maneira de fazer isso é incluir o instalador do Visual Studio 2022 nos layouts do Visual Studio 2019 usando os parâmetros descritos abaixo. A funcionalidade para usar o instalador mais recente só está disponível para bootstrappers do Visual Studio 2019 criados após o Visual Studio 2022 enviado originalmente. Portanto, o vs_enterprise.exe no exemplo abaixo deve ser uma versão enviada após 10 de novembro de 2021.

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

  • Você pode passar o parâmetro --useLatestInstaller para o bootstrapper ao criar ou atualizar 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 melhor e mais recente instalador disponível.

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

  • Você pode editar o arquivo layout.json 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 do arquivo layout.json, portanto, se você quiser que o 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 antigo que o instalador mais recente), basta editar o arquivo layout.json e remover a configuração "UseLatestInstaller": true.

Observe que você também pode encontrar essa configuração "UseLatestInstaller": true no arquivo response.json do layout, mas lá ela é ignorada. 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 "useLatestInstaller": true específica é usada para garantir que o layout contenha o instalador mais recente para que os computadores cliente possam adquiri-lo do layout.

Instalar o Visual Studio em um computador cliente a partir de uma instalação de rede

Os administradores podem implantar o Visual Studio em estações de trabalho cliente como parte de um script de instalação. Ou, os usuários que têm direitos de administrador podem executar a instalação diretamente do compartilhamento para instalar o Visual Studio em seu computador.

  • Os usuários podem instalar manualmente o produto a partir de um layout de rede executando o seguinte comando:

    \\server\products\VS\vs_enterprise.exe

  • Os administradores podem fazer a instalação em um modo autônomo executando o seguinte comando:

    \\server\products\VS\vs_enterprise.exe --quiet --wait --norestart

Verifique se a conta do sistema ou do usuário que está executando a instalação tem acesso adequado ao compartilhamento de rede que contém o layout. Confira mais informações em Solucionar problemas de erros relacionados à rede ao instalar ou usar o Visual Studio.

Observação

Seja paciente. Verifique se você concluiu --wait para o instalador e para o produto. Ao instalar ou atualizar um cliente a partir de um layout, primeiro sempre será instalado ou atualizado o instalador e depois o próprio produto do Visual Studio. Esses dois processos precisam ser concluídos para uma atualização ser considerada bem-sucedida.

Ao executar a instalação ou atualização como parte de um arquivo em lote automatizado autônomo, a opção --wait é útil para garantir que o processo vs_enterprise.exe aguarde até que a instalação seja concluída antes de retornar um código de saída. Isso é útil se um administrador corporativo quiser executar ações adicionais na instalação concluída, tal como aplicar uma chave de produto a uma instalação bem-sucedida. O uso da opção --wait impede que as operações subsequentes sejam disparadas prematuramente. Se você não usar --wait, o processo vs_enterprise.exe poderá ser encerrado antes que as duas partes da instalação sejam concluídas e retornará um código de saída impreciso, que não representará o estado da operação de instalação.

Instalar em um cliente sem acesso à Internet

Quando você instala a partir de um layout, o conteúdo instalado por padrão será adquirido do layout. No entanto, se você selecionar um componente que não esteja no layout e se o cliente estiver configurado para procurar por atualizações nos servidores hospedados da Microsoft, o instalador também tentará adquirir pacotes do Visual Studio na Internet. Se você quiser impedir que a instalação do Visual Studio baixe qualquer conteúdo que não está no seu layout, use a opção --noWeb. Se a opção --noWeb for usada e o layout não tiver qualquer conteúdo selecionado a ser instalado, a instalação falhará.

Importante

A opção --noWeb não impede que o instalador do Visual Studio em um computador cliente conectado à Internet verifique se há atualizações se o cliente estiver configurado para examinar se há atualizações nos servidores hospedados da Microsoft. Em vez disso, --noWeb impede que o cliente baixe os pacotes do produto. Confira mais informações na página Atualizar um cliente do Visual Studio instalado a partir de um layout de rede.

Se você receber uma mensagem de erro informando que "Não foi possível encontrar um produto que corresponda aos parâmetros a seguir", verifique se você está usando a opção --noweb.

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

Você pode modificar o arquivo response.json na pasta de layout para definir valores padrão para quando o produto for instalado inicialmente no computador cliente. As opções de configuração comuns incluem:

  • Capacidade de configurar quais cargas de trabalho, componentes ou idiomas devem ser selecionados por padrão durante a instalação inicial.
  • Capacidade de especificar de onde o cliente deve receber atualizações. Os exemplos incluem os servidores padrão hospedados pela Microsoft na Internet ou um local de layout de rede controlado pelo administrador.

Para obter mais informações sobre como personalizar e definir as configurações padrão do cliente para o layout, confira Automatizar a instalação do Visual Studio com um arquivo de resposta.

Configurar políticas para comportamento de implantações empresariais

Você também pode controlar outros comportamentos de implantação empresarial, tais como os de instalação, atualização e download, o comportamento da atualização do administrador, como os layouts aparecem na caixa de diálogo Configurações de Atualização e o comportamento de notificação.

Confira detalhes adicionais em Configurar políticas para implantações empresariais do Visual Studio.

Códigos do Erro

Se você tiver usado 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 A operação foi 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 A operação foi concluída com êxito e a reinicialização foi iniciada
3010 A operação foi concluída com êxito, mas a instalação requer a reinicialização antes de ser usada
5003 O inicializador falhou ao baixar o instalador
5004 A operação foi cancelada
5005 Erro de análise de linha de comando do inicializador
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 de conteúdo de origem
8006 Processos do Visual Studio em execução
-1073720687 Falha de conectividade
–1073741510 O Instalador do Microsoft Visual Studio foi terminado (por usuário ou processo externo)
Outro
(por exemplo:
-1, 1, 1.603)		 Condição de falha ocorreu. Verifique os logs para obter mais informações

Obter suporte para o layout de rede

Caso você tenha um problema com o layout de rede, gostaríamos de saber a respeito. A melhor maneira de nos comunicar o assunto é usando a ferramenta Relatar um Problema, exibida no Instalador do Visual Studio e no IDE do Visual Studio. Se você for um Administrador de TI e não tiver o Visual Studio instalado, poderá enviar comentários de Administração de TI aqui. Ao usar essa ferramenta, será muito útil se você puder enviar os logs da ferramenta VS Collect, que pode nos ajudar a diagnosticar e corrigir o problema.

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

Também temos outras opções de suporte disponíveis. Confira nossa Visual Studio Developer Community.

Confira também