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

Às vezes, um administrador corporativo deseja criar um ponto de instalação de rede que contém Visual Studio arquivos que podem ser implantados em estações de trabalho cliente. Isso é para facilitar cenários em que os máquinas cliente podem ter permissões limitadas ou acesso limitado à Internet ou quando uma organização deseja padronizar em uma versão específica do modelo de ferramentas do desenvolvedor. Projetamos um 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 Visual Studio necessários para a instalação inicial e as atualizações subsequentes do produto.

Há muitas informações sobre essa página da Web e ela é agrupada nas seções a seguir:

  • Antes de começar: realça dicas e outras considerações importantes que você deve considerar ao planejar.
  • Adquira o bootstrapper correto: diretrizes 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 do canal, a versão do instalador e o tamanho da pasta.
  • Instalar o layout em máquinas 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 Visual Studio nos máquinas cliente. Diretrizes e informações sobre a atualização de máquinas cliente que foram originalmente instaladas de um layout são abordadas na atualização separada de uma instalação baseada em rede Visual Studio página.
  • 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, Visual Studio 2017 Professional e Visual Studio 2017 Enterprise), deverá criar um ponto de instalação de rede separado para cada edição. Além disso, o layout de instalação do Visual Studio original e todas as atualizações subsequentes do produto devem estar localizados no mesmo diretório de rede para garantir que a funcionalidade de reparo e desinstalação do cliente funcione corretamente. Por fim, o caminho de layout deve ter menos de 80 caracteres, embora algumas organizações tenham usado links simbólicos com êxito para resolver a limitação de 80 caracteres.
  • Planejando atualizações: Você deve decidir como os seus máquinas cliente devem receber atualizações de produto 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 recebam atualizações do local de layout de rede ou de servidores hospedados pela Microsoft na Internet. Depois que o cliente tiver instalado do layout, a configuração do local de atualização do cliente será bloqueada e imutável.
  • 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 links simbólicos com êxito para resolver a limitação de 80 caracteres.
  • Planejando atualizações: Você deve decidir como os seus máquinas cliente devem receber atualizações de produto 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 recebam atualizações do local de layout de rede ou de servidores hospedados pela Microsoft na Internet.

Importante

A limitação a seguir existe com o gerenciamento de layout quando você usa apenas Visual Studio funcionalidade 2019: depois que o cliente é instalado do layout, o local de atualização do cliente é bloqueado e imutável. Isso significa 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 de produto subsequentes na pasta de layout original da onde seus clientes instalaram. Em outras palavras, a funcionalidade base 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 do produto de um local de layout diferente.

Essa limitação em que o local de atualização do produto é corrigido e as atualizações do 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 que você inclua e use o instalador mais recente (Visual Studio 2022), que rege todas as versões modernas da família de produtos Visual Studio, para gerenciar seus layouts do Visual Studio 2019 e eliminar a limitação na versão de 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 links simbólicos com êxito para resolver a limitação de 80 caracteres.
  • Planejando atualizações: Recomendamos que você decida como os seus máquinas cliente devem receber atualizações de produto antes de fazer a instalação inicial do cliente. Isso é para garantir que a configuração do local de atualização de seus clientes seja inicializada corretamente. Suas opções incluem fazer com que os clientes recebam atualizações do local de layout de rede ou de 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.

Baixe o Visual Studio bootstrapper para criar o layout de rede

Baixe o bootstrapper para a edição do Visual Studio você deseja 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 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.

Para obter os bootstrappers mais recentes do Visual Studio 2017 versão 15.9, baixe um dos arquivos abaixo. Os bootstrappers listados abaixo sempre instalarão a versão mais recente e segura do Visual Studio 2017, não importa quando você os executar:

Edition Bootstrapper
Visual Studio 2017 Enterprise versão 15.9 vs_enterprise.exe
Visual Studio 2017 Professional versão 15.9 vs_professional.exe
Visual Studio 2017 Build Tools versão 15.9 vs_buildtools.exe

Outros bootstrappers com suporte incluem vs_feedbackclient.exe, vs_teamexplorer.exe, vs_testagent.exe, vs_testcontroller.exe e vs_testprofessional.exe.

Os bootstrappers listados abaixo sempre instalarão a versão mais recente e segura do Visual Studio 2019, independentemente de quando você os executar. 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 serviç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
Visual Studio 2019 Build Tools 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 quando você os executar. 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, acesse a página Histórico de Versões do Visual Studio 2022 que tem links para os bootstrappers de versão fixa e evergreen para cada versão de serviç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
Visual Studio ferramentas de build 2022 vs_buildtools.exe

Dica

Se você baixou anteriormente um arquivo 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, veja o Número de versão do produto. Para corresponder esse número a uma versão de Visual Studio, consulte Visual Studio de build e datas de lançamento.

Dica

Se você baixou anteriormente um arquivo 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, veja o Número de versão do produto. Para corresponder esse número a uma versão Visual Studio, consulte a tabela na parte inferior da página Visual Studio 2019.

Dica

Se você baixou anteriormente um arquivo 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, em seguida, 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 é presumido como Atual, a menos que explicitamente especificado. Portanto, um bootstrapper com uma versão do 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 do Produto que simplesmente informa 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 nos parâmetros de linha de comando de uso para instalar a página Visual Studio para criar e manter o layout de rede. Exemplos comuns de criação de layouts iniciais são ilustrados abaixo e nos exemplos de parâmetro de linha de comando para Visual Studio de instalação.

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 de Visual Studio, execute o seguinte no computador em que você planeja hospedar o layout de rede:

vs_enterprise.exe --layout c:\VSLayout

Verifique se seu layout tem o canal correto

É importante garantir que o layout de rede seja baseado no canalcorreto, 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 seu layout for baseado no canal VisualStudio. 17. Release. LTSC. 17.0 e se os clientes estiverem configurados para receber atualizações de servidores hospedados da Microsoft, todas as atualizações de segurança disponibilizadas no canal 17,0 LTSC estarão disponíveis para os clientes que instalaram ou atualizaram a partir desse layout.

Os bootstrappers listados acima se baseiam no canal atual. para criar um layout baseado em um dos canais do LTSC, basta adquirir o bootstrapper do canal correto na página do histórico de versão Visual Studio 2022 , copiá-lo para a 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 de seu 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 as 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 um idioma, 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 seu layout está usando o instalador mais recente

recomendamos que você sempre use o instalador de Visual Studio mais recente em seu layout e distribua-o para seus clientes. Dessa forma, você terá acesso aos novos recursos e à funcionalidade que disponibilizaremos nas versões subsequentes do produto. por exemplo, se você distribuir o instalador do Visual Studio 2022 em seus layouts de Visual Studio 2019, seus clientes do Visual Studio 2019 com base nesse layout terão a capacidade de alterar o local de origem das atualizações. O cenário em que essa funcionalidade seria útil é se você quiser instalar a partir de um layout, mas tiver atualizações provenientes de outro layout. Mais detalhes, incluindo como desligar o uso do instalador mais recente, são descritos abaixo

Importante

essa capacidade de usar o instalador mais recente só está disponível para Visual Studio bootstrappers 2019 que foram criados após Visual Studio 2022 originalmente enviados. 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 melhor 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 a partir de computadores cliente. Se você criou o layout em um computador local, será necessário copiá-lo para um local de rede. O exemplo a seguir usa xcopy . Você também pode usar robocopy , caso queira. Exemplo:

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

Importante

Para evitar um erro, verifique se o caminho completo do layout 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 seu layout

é possível atualizar um layout de rede de Visual Studio com as atualizações de produto mais recentes 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, principalmente 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, 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, haverá uma chance maior de que todos os usuários que estiverem executando a instalação enquanto você estiver atualizando o layout possam obter uma incompatibilidade de conteúdo do layout, pois ele ainda não foi completamente atualizado.

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

A Microsoft frequentemente lança versões atualizadas do produto para corrigir problemas de funcionalidade ou de segurança. É recomendável que você mantenha seu layout atualizado com a versão mais recente do produto, para que o novo cliente seja instalado sempre que o caso mais recente seja recebido. 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 linguagens a serem incluídas no layout, são salvas no arquivo de configuração do layout. Posteriormente, quando desejar atualizar esse layout para uma versão mais recente do produto, você não precisará 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á criou esse layout parcial usando um dos inicializadores de verde 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-verde e executar o --layout comando novamente para baixar os pacotes mais recentes no 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 da linha de base de serviço na qual você padronizou sua organização. Veja como fazer isso:

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

você pode ir para a página de histórico de versões do Visual Studio 2022 e baixar um bootstrapper de versão fixo 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, vá para o Catálogo Microsoft Update, procure a atualização para a qual você deseja atualizar o 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 só atualizarão um layout existente ou uma instância de cliente.

Modificar o canal do layout de rede

Ocasionalmente, à medida que os canais saem do suporte, você precisará garantir que o layout da rede continue a ser baseado em um canal com suporte para que os clientes possam continuar a receber notificações de atualizações de segurança. Se seu layout for baseado no canal VisualStudio. 17. Release. LTSC. 17.0, depois que o canal 17,0 LTSC sair do suporte, não liberaremos mais atualizações de segurança para ele e o layout e os clientes ficarão inseguros.

para alterar o canal do qual o layout se baseia, basta adquirir o bootstrapper do canal desejado na página do histórico de versão Visual Studio 2022 , copiá-lo para a pasta de layout e executar uma atualização normal. Em seguida, os clientes devem ser notificados de uma atualização de forma adequada para que possam permanecer seguros também.

Modificar o conteúdo do layout

É possível modificar esse layout e adicionar ou remover cargas de trabalho ou componentes ou linguagens 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 gerenciadas e do Azure, e os recursos em inglês e alemão, serão incluídos nesse 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 uma linguagem localizada sem atualizar a versão. (esse comando adiciona o ASP.NET e a carga de trabalho de desenvolvimento da Web.) agora, a área de trabalho gerenciada, o Azure e o ASP.NET & cargas de trabalho de desenvolvimento para a Web estão incluídos 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 layout.json arquivo de 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 para o layout.

Para obter esses novos componentes instalados no computador cliente, certifique-se de executar 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 incluir sempre 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 uma 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, uma vez que o instalador mais recente esteja em seu cliente, as instalações do cliente poderão aproveitar as correções de bugs 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 Visual Studio 2022 em seus layouts do Visual Studio 2019 usando os parâmetros descritos abaixo. A capacidade de usar o instalador mais recente só está disponível para os bootstrappers Visual Studio 2019 que foram construídos após o Visual Studio 2022 originalmente enviado. Portanto, a vs_enterprise.exe no exemplo abaixo deve ser uma versão enviada após 10 de novembro de 2021.

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

  • 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. Veja um exemplo de como atualizar o layout e configurá-lo para usar o instalador mais recente e o 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
    
    }
    

Não é possível remover essa configuração programaticamente 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 antigo do que o instalador mais recente), basta editar o arquivo layout.json "UseLatestInstaller": true e remover a configuração.

Observe que você também pode encontrar "UseLatestInstaller": true essa 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 "useLatestInstaller": true específica é usada para garantir que o conteúdo do layout contenha o instalador mais recente, para que os máquinas cliente possam adquirir o instalador mais recente do layout.

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 contêm versões anteriores.

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

Observação

Alguns arquivos de metadados importantes que são necessários para a --verify opção 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ê encontrar esse erro, tente atualizar o layout novamente ou crie novamente um novo layout de rede em uma pasta diferente.

Lembre-se de que a Microsoft envia atualizações para Visual Studio periodicamente, 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 fixos](#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 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 Visual Studio mais recente. 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 encontrar 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 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 --wait de que você para o instalador e o produto para concluir. Ao instalar ou atualizar um cliente de um layout, o instalador é sempre a primeira coisa a ser instalada ou atualizada e, em seguida, o Visual Studio produto em si será instalado ou atualizado. Ambos os processos precisam ser finalizes para serem considerados uma atualização bem-sucedida.

Ao executar a instalação ou a atualização como parte de um arquivo em lote automatizado autônomo, --wait vs_enterprise.exe a opção é útil para garantir que o 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 mais 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 deem início prematura. Se você --waitnão usar , vs_enterprise.exe o 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 que está instalado assume como padrão a aquisição do layout. No entanto, se você selecionar um componente que não está no layout e o cliente tiver sido configurado para procurar atualizações nos servidores hospedados pela Microsoft, o instalador também tentará adquirir pacotes Visual Studio da Internet. Se você quiser impedir que Visual Studio a instalação do download de qualquer conteúdo da Web ausente em seu layout, use a --noWeb opção . 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 Visual Studio instalador em um computador cliente conectado à Internet procure atualizações se o cliente tiver sido configurado para verificar 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 Visual Studio que foi instalado de uma página de 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", certifique-se de que você está usando a opção --noweb .

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

Você pode modificar alguns arquivos na pasta de layout para definir valores padrão que são usados quando o produto é instalado inicialmente no computador cliente. As opções comuns de configuração 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. As opções são do local de layout de rede controlado pelo administrador ou de servidores hospedados pela Microsoft na Internet (que é o padrão).

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

Configurar o comportamento de implantação empresarial

Você também pode controlar outro comportamento de implantação empresarial, como:

  • Se as atualizações de administrador devem ser habilitadas e como elas devem ser aplicadas.
  • Quais canais de atualização estão disponíveis e como os layouts de rede aparecem para os máquinas cliente na caixa de diálogo Configurações atualização.
  • Onde os pacotes compartilhados estão instalados.
  • Onde e se os pacotes são armazenados em cache.
  • Como as notificações são exibidas ou não aparecem.

Consulte Definir padrões para implantações corporativas do Visual Studio para obter detalhes adicionais.

Você também pode controlar outro comportamento de implantação empresarial, como onde os pacotes compartilhados estão instalados. Consulte Definir padrões para implantações corporativas do Visual Studio para obter detalhes adicionais.

Códigos de 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 Visual Studio do instalador está em execução
1003 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 na pré-verificação do download em segundo plano
8003 Falha selecionável sem suporte
8004 Falha no diretório de destino
8005 Verificando a falha de cargas de origem
8006 Visual Studio processos 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 o layout de rede, queremos saber mais sobre ele. A melhor maneira de nos informar é usando a ferramenta Relatar um Problema que aparece no Instalador do Visual Studio e no IDE Visual Studio. Se você for um Administrador de TI e não tiver Visual Studio instalado, envie comentários de Administrador de TI aqui. Quando você usa essa ferramenta, seria muito útil se você pudesse enviar os logs da 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. Consulte nosso Visual Studio developer Community.

Confira também