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

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 que contenha arquivos do Visual Studio que podem ser implantados em estações de trabalho do cliente. Isso é para facilitar cenários em que os computadores cliente podem ter permissões limitadas ou acesso limitado à Internet ou 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 as atualizações subsequentes do produto.

Há muitas informações nesta página da Web e elas são agrupadas nas seguintes seções:

  • Antes de começar: destaca dicas e outras considerações importantes sobre as quais você deve pensar ao planejar.
  • Adquira o bootstrapper correto: orientação sobre onde encontrar e como distinguir os vários bootstrappers que estão 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 para um compartilhamento de rede.
  • Atualizar, modificar e manter o layout de rede: informações sobre como manter melhor o layout, 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, como quais cargas de trabalho e componentes instalar por padrão e de 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 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 para 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, Visual Studio 2019 Professional e Visual Studio 2019 Enterprise), deverá criar um ponto de instalação de rede separado para cada edição. Além disso, o caminho de layout deve ter menos de 80 caracteres, embora algumas organizações tenham usado com êxito 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 de local de atualização dos clientes esteja 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

A seguinte limitação existe com o gerenciamento de layout quando você usa apenas a funcionalidade do Visual Studio 2019: depois que o cliente é instalado a partir do layout, o local de atualização do cliente é bloqueado e imutável. Isso implica que, se você pretende que seus clientes recebam atualizações do layout preservando a funcionalidade de reparo e desinstalação, deverá colocar todas as atualizações subsequentes do produto na pasta de layout original da qual os clientes instalaram. Em outras palavras, a funcionalidade base do Visual Studio 2019 não dá suporte à capacidade de um cliente fazer uma instalação original de um local de layout e, em seguida, fazer com que esse cliente receba uma atualização de produto de um local de layout diferente.

Essa limitação em 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 do cliente para atualizações. 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 isso.

  • Gerenciamento de Pastas: 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 ponto de instalação de rede separado para cada edição. Além disso, o caminho de layout deve ter menos de 80 caracteres, embora algumas organizações tenham usado com êxito 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 é para garantir que a configuração de local de atualização dos clientes seja inicializada 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 do Visual Studio desejada e copie-o para o diretório que você deseja servir como 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 executável que você usa 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 recente e segura do Visual Studio 2019, independentemente de você executá-las. 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 para cada versão de manutenção e baixe o que você deseja. Copie-o para o diretório que você deseja servir 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 com suporte incluem vs_teamexplorer.exe, vs_testagent.exee vs_testcontroller.exe.

Os bootstrappers listados abaixo sempre instalarão a versão mais recente e segura do Visual Studio 2022 no canal Atual, independentemente de você executá-los. Como alternativa, se você quiser criar ou atualizar um layout para uma versão específica ou um canal específico do Visual Studio 2022, vá para a página Histórico de Versões do Visual Studio 2022 que tenha links para os bootstrappers de versão sempre verdes e fixos para cada versão de manutenção em cada canal e baixe o que você deseja. Copie-o para o diretório que você deseja servir como o local de origem do layout.

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

Dica

Se você baixou anteriormente um arquivo de bootstrapper e deseja verificar qual é a versão, veja como. No Windows, abra Explorador de Arquivos, clique com o botão direito do mouse no arquivo bootstrapper, escolha Propriedades, escolha a guia Detalhes e, em seguida, exiba o número da versão do produto. Para corresponder esse número a uma versão do Visual Studio, consulte 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á, veja como. No Windows, abra 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 o canal é considerado Atual, a menos que especificado explicitamente. Portanto, um bootstrapper com uma versão product do LTSC 17.0 instalará a versão de manutenção 17.0.x mais recente que está disponível no canal 17.0 LTSC. Um bootstrapper com uma versão product 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, conforme definido na página usar parâmetros de linha de comando para instalar o Visual Studio para criar e manter o layout de rede. Exemplos comuns de criação de layouts iniciais são ilustrados abaixo e na página de parâmetros de linha de comando para a página de 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 todas as cargas de trabalho no diretório de layout no servidor de rede. Dessa forma, seus clientes terão acesso a toda a oferta de 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 tem 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 eles 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 do canal correto da página Histórico de Versões do Visual Studio 2022 , copiá-lo para 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 idioma.

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 apenas uma linguagem, execute:

    vs_enterprise.exe --layout C:\VSLayout --lang en-US
    
  • Para criar um layout com todas as cargas de trabalho e componentes para 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 recomendados para essa carga de trabalho, 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
    
  • Para criar um layout com duas cargas de trabalho e todos os componentes recomendados e opcionais, execute:

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

Verifique se o layout está usando o instalador mais recente

Recomendamos que você sempre use o instalador mais recente do Visual Studio em seu layout e distribua-o aos seus clientes. Dessa forma, você terá acesso aos novos recursos e funcionalidades que disponibilizamos nas versões subsequentes do produto. 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 terão a capacidade de alterar o local de origem para atualizações. O cenário em que essa funcionalidade seria útil é se você quiser instalar de um layout, mas tiver atualizações provenientes de outro layout. Mais detalhes, incluindo como desativar usando o instalador mais recente, são descritos abaixo

Importante

Essa funcionalidade para usar o instalador mais recente só está disponível para bootstrappers do Visual Studio 2019 que foram criados após o Envio original do Visual Studio 2022. 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 de todo o produto que usa o instalador mais recente e maior 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 cliente. Se você criou o layout em um computador local, precisará copiá-lo para um local de rede. O exemplo a seguir usa xcopy. Você também pode usar robocopy, se desejar. Exemplo:

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

Importante

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

Atualizar ou modificar o layout

É possível atualizar um layout de rede do Visual Studio com as atualizações mais recentes do produto para que ele possa ser usado como um ponto de instalação e uma fonte de atualização para que as estações de trabalho cliente recebam a versão mais recente do Visual Studio. É uma prática recomendada atualizar periodicamente seu layout, especialmente se você pretende que seus clientes recebam atualizações do layout. 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 arquivos, talvez queira atualizar uma cópia privada do layout (por exemplo, c:\VSLayout) e, depois que todo o conteúdo atualizado for baixado, copie-o para o compartilhamento de arquivos (por exemplo, \\server\products\VS). Se você não fizer isso, há uma chance maior de que todos os usuários que executam a Instalação enquanto você estiver atualizando o layout possam obter uma incompatibilidade de conteúdo do layout porque ele ainda não foi 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. Recomendamos que você mantenha seu layout atualizado com a versão mais recente do produto, para que as instalações do novo cliente sempre recebam a funcionalidade mais recente. Também é muito importante manter o layout atualizado se os clientes estiverem configurados para receber atualizações do layout.

Quando você cria o layout inicial, as opções especificadas, como quais cargas de trabalho e idiomas incluir no layout, são salvas no arquivo de configuração do layout. Posteriormente, quando você quiser atualizar esse layout para uma versão mais recente do produto, não será necessário especificar novamente as opções usadas durante a criação do layout inicial. Os comandos de atualização de layout usam automaticamente as configurações de layout salvas.

Suponha que você já tenha criado esse layout parcial usando um dos bootstrappers evergreen na 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 oferecido pela Microsoft e hospedado em servidores Microsoft. Você só precisa usar o mesmo bootstrapper evergreen e executar o --layout comando novamente para baixar os pacotes mais recentes em seu layout.

vs_enterprise.exe --layout c:\VSLayout

Você também pode atualizar seu 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 usuários possam ver o resultado final e um resumo dos erros que podem ter ocorrido. Se você estiver executando uma operação de layout de forma 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 versão específica 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 na qual você padroniza 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 exata especificada no bootstrapper. Você usaria exatamente a mesma sintaxe acima.

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 exata 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 para a qual você deseja 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 como este:

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

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

Modificar o canal do layout de rede

Ocasionalmente, à medida que os canais fazem a transição para fora do suporte, você precisará garantir que o layout de rede continue sendo baseado em um canal com suporte para que seus clientes possam continuar 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 e seu layout e clientes ficarão inseguros.

Para alterar o canal do 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 para sua pasta de layout e executar uma atualização normal. Em seguida, seus clientes devem ser notificados adequadamente de uma atualização para que eles também possam se manter seguros.

Modificar o conteúdo do layout

É possível modificar esse layout e adicionar ou remover cargas de trabalho ou componentes ou idiomas adicionais. No exemplo a seguir, adicionaremos a carga de trabalho do Azure e um idioma localizado ao layout que criamos acima. 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 disso, o layout é atualizado para a versão mais recente disponível.

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.

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

Veja como adicionar uma carga de trabalho adicional e um idioma localizado sem atualizar a versão. (Esse comando adiciona a carga de trabalho ASP.NET e Desenvolvimento para a Web.) Agora, as cargas de trabalho da Área de Trabalho Gerenciada, do Azure e do ASP.NET & desenvolvimento da Web estão incluídas nesse layout. Os recursos de idioma para inglês, alemão e francês também estão incluídos para todas essas cargas de trabalho. No entanto, o layout não é atualizado para a versão mais recente disponível quando esse comando é executado. Ele permanece com a versão existente.

vs_enterprise.exe --layout c:\VSLayout --add Microsoft.VisualStudio.Workload.NetWeb --lang fr-FR --keepLayoutVersion

Importante

Uma operação de atualização não baixa nem instala componentes opcionais adicionais no layout ou no cliente. Se você precisar adicionar ou alterar componentes opcionais, primeiro remova os componentes opcionais antigos do arquivo de layout.json configuração e inclua os novos componentes necessários na seção "adicionar" de layout.json. Em seguida, quando você executar o --layout comando para atualizar o layout, ele baixará os componentes recém-adicionados no layout.

Para instalar esses novos componentes no computador cliente, execute estas três etapas. Primeiro, verifique se o layout contém os novos componentes, conforme descrito acima. Em seguida, atualize o cliente para os bits mais recentes no layout. Por fim, novamente no cliente, execute uma operação de modificação que instalará os novos componentes (que foram adicionados ao layout) no computador cliente.

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

Você pode configurar 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 cliente for atualizado desse 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 bug e a nova funcionalidade 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, 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 capacidade de usar o instalador mais recente só está disponível para bootstrappers do Visual Studio 2019 que foram criados após o Visual Studio 2022 originalmente enviado. 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 --useLatestInstaller parâmetro 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 instalador mais recente e maior disponível.

    vs_enterprise.exe --layout C:\VSLayout --useLatestInstaller
    
  • Você pode editar o arquivo layout.json diretamente para adicionar essa configuração.

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

Não há como remover programaticamente essa configuração no arquivo layout.json, portanto, se você quiser que 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 "UseLatestInstaller": true configuração.

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

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

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

Verificar um layout

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

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

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

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 ausentes, "--verify" não poderá ser executado e a instalação apresentará um erro. Se você tiver 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, um layout mais recente pode não conter a mesma versão do layout inicial, a menos que você use [bootstrappers de link fixo](#download-the-visual-studio-bootstrapper-to create-the-network-layout).

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 necessários para a instalação mais recente do Visual Studio. Você pode usar a opção --clean para remover pacotes obsoletos da pasta de layout de rede.

Para fazer isso, você precisará dos caminhos de arquivo para os manifestos de catálogo que contêm esses pacotes obsoletos. Você pode encontrar os manifestos do catálogo em uma pasta "Arquivo Morto" no 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.

Instalar o Visual Studio em um computador cliente 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 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
    

Observação

Seja paciente. Certifique-se de concluir --wait o instalador e o produto. Ao instalar ou atualizar um cliente de um layout, o instalador é sempre a primeira coisa a ser instalado ou atualizado e, em seguida, o próprio produto do Visual Studio será instalado ou atualizado. Esses dois processos precisam ser concluídos para serem considerados uma atualização 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 vs_enterprise.exe processo aguarde até que a instalação seja concluída antes de retornar um código de saída. Isso será útil se um administrador corporativo quiser executar outras ações em uma instalação concluída, como aplicar uma chave do produto (Product Key) 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 vs_enterprise.exe processo poderá sair antes que ambas as partes da instalação sejam concluídas e, portanto, retornará um código de saída impreciso que não representa o estado da operação de instalação.

Instalar em um cliente que não tem acesso à Internet

Quando você instala de um layout, o conteúdo instalado será adquirido do layout por padrão. No entanto, se você selecionar um componente que não esteja no layout e o cliente tiver sido configurado para examinar os servidores hospedados da Microsoft para atualizações, o instalador também tentará adquirir pacotes do Visual Studio da Internet. Se você quiser impedir que a instalação do Visual Studio tente baixar qualquer conteúdo da Web ausente em seu layout, use a opção --noWeb . Se --noWeb for usado e o layout não tiver nenhum conteúdo selecionado para ser instalado, a instalação falhará.

Importante

A --noWeb opção não impede que o instalador do Visual Studio em um computador cliente conectado à Internet verifique se há atualizações se o cliente tiver sido configurado para examinar se há atualizações nos servidores hospedados pela Microsoft. Em vez disso, --noWeb simplesmente impede que o cliente baixe os pacotes de produtos. Para obter mais informações, consulte a página Atualizar um cliente do Visual Studio que foi instalado de um layout de rede .

Se você receber uma mensagem de erro informando "Um produto que corresponde aos parâmetros a seguir não pode ser encontrado", 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 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 hospedados pela Microsoft padrão na Internet ou de 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, consulte Automatizar a instalação do Visual Studio com um arquivo de resposta.

Configurar políticas para o comportamento de implantação empresarial

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

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

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 Verificando falha nos conteúdos 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

Se você tiver um problema com seu layout de rede, queremos saber sobre ele. A melhor maneira de nos dizer é usando a ferramenta Relatar um Problema que aparece 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 Administração de TI aqui. Quando você usa essa ferramenta, seria muito útil se você pudesse enviar os logs pela ferramenta VS Collect , o 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 Developer Community do Visual Studio.

Confira também