Atualizar um cliente do Visual Studio que foi instalado por meio de um layout

  • Artigo

Você pode e deve atualizar periodicamente todas as instalações do Visual Studio para que elas recebam as correções de segurança e funcionalidade mais recentes.

Se o Visual Studio estiver instalado em um computador em uma organização e tiver sido originalmente instalado por meio de um layout, provavelmente o computador cliente fará parte de um "ambiente gerenciado", o que significa que ele é regido por uma equipe administrativa central e precisa seguir as políticas organizacionais. Para atualizar computadores cliente em ambientes gerenciados, considere as perguntas abaixo porque as respostas informarão como você deve abordar o processo de atualização.

  • De onde vêm as atualizações: de um layout ou de servidores hospedados pela Microsoft? Se a atualização veio de um layout, o layout foi atualizado? O layout está hospedado em um compartilhamento de rede ou em um servidor Web de intranet interno?
  • A atualização será iniciada manualmente pelo usuário ou será um evento iniciado pelo administrador, como por meio de uma atualização de administrador ou de um comando programático? Lembre-se de que o responsável por executar a atualização deve ter permissões de administrador no computador cliente.

Preparar a origem da atualização

Se os clientes estiverem configurados para adquirir atualizações de servidores hospedados pela Microsoft, eles precisarão ter acesso à Internet. Durante a atualização, os clientes baixarão e instalarão a última versão disponível da Microsoft no canal de atualização que o cliente assinou.

Se os clientes estiverem configurados para adquirir atualizações usando um layout, a primeira etapa para atualizar o cliente é verificar se o layout contém a versão atualizada do Visual Studio. O administrador de TI deve atualizar o layout existente com as atualizações mais recentes do produto para que as novas instalações ou as atualizações do cliente possam receber a versão atualizada ou criar um novo layout em um diretório de layout diferente usado para atualizar os computadores cliente. A melhor prática é atualizar os layouts na segunda terça-feira do mês logo após o lançamento das atualizações de segurança.

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

Iniciar manualmente a atualização no computador cliente

Um usuário no computador cliente com permissões suficientes pode iniciar manualmente a atualização do Visual Studio por conta própria. O cliente do Visual Studio vai procurar no local de origem as atualizações para determinar se algum pacote de atualização está disponível. É por isso que é importante manter o layout de origem atualizado.

Os usuários podem atualizar manualmente uma instância do Visual Studio:

  • iniciando o Instalador do Visual Studio. Se a atualização estiver disponível, eles poderão clicar em Atualizar.
  • iniciando o IDE do Visual Studio e respondendo ao sinalizador ou à mensagem de notificação ou, para atualizações, escolhendo Ajuda > Verificar se há atualizações.

Se algum arquivo estiver em uso quando a atualização for iniciada, por exemplo, se o Visual Studio estiver aberto, a atualização será bloqueada até que o Visual Studio seja fechado. Ocasionalmente, a atualização exigirá uma reinicialização.

Configurar manualmente onde o cliente do Visual Studio procura atualizações

Quando o Visual Studio é instalado inicialmente no computador cliente, ele registra o local em que deve verificar se há atualizações. Se o Visual Studio foi instalado a partir de servidores hospedados pela Microsoft, ele procurará, por padrão, as atualizações nos servidores hospedados pela Microsoft. Se o Visual Studio foi instalado ou atualizado invocando um bootstrapper em um layout de rede ou executando o script a ser instalado por meio de um layout hospedado na Web, ele vai procurar atualizações no local especificado pelo layout.

Com a funcionalidade padrão do Visual Studio 2019, depois que o cliente tiver instalado o produto, a configuração de local de atualização do cliente será bloqueada e não pode ser alterada. A única maneira de alterar de forma confiável o local de origem para atualizações é desinstalar e reinstalar o produto usando a configuração correta.

No entanto, se o cliente do Visual Studio usar o mais recente Instalador do Visual Studio 2022, o local de origem para atualizações do cliente poderá ser alterado. Isso é útil se você quiser instalar a partir de um layout, mas tiver atualizações provenientes de outro layout. Há várias maneiras de colocar o Instalador do Visual Studio 2022 em um computador cliente. A maneira mais fácil é usar qualquer versão do Visual Studio que tenha sido enviada após junho de 2023, pois essas versões contêm automaticamente o instalador mais recente. Outra maneira é instalar e usar o produto Visual Studio 2022. Por fim, você pode distribuir o Instalador do Visual Studio 2022 por meio dos layouts do Visual Studio 2019.

Para ver e configurar manualmente o local de atualização no qual o cliente vai procurar atualizações, abra Configurações de Atualização e verifique se ele está configurado corretamente. Em seguida, você pode iniciar a atualização do cliente.

Atualizar notificações

Se houver uma atualização disponível no local em que o cliente estiver procurando atualizações, ele exibirá uma mensagem ou um sinalizador de notificação.

Para obter detalhes sobre como controlar quando as notificações de atualização são apresentadas aos usuários, confira Controlar as atualizações nas implantações do Visual Studio com base em rede.

Usar atualizações de administrador para atualizar os computadores cliente

Se você está em uma organização, a prática recomendada é registrar os computadores cliente em atualizações de administrador do Visual Studio. As versões de segurança do Visual Studio normalmente ficam disponíveis em "terças-feiras de patch", que é a segunda terça-feira do mês. O Administrador de TI deve ter o hábito de manter e atualizar os layouts mensalmente, como toda manhã da segunda quarta-feira do mês, e usar o Microsoft Endpoint Manager para implantar as atualizações de segurança do Visual Studio nos computadores cliente na organização. As atualizações de administrador disparam clientes para examinar o local de origem da atualização em busca de novas atualizações e, se o layout foi atualizado, a atualização é aplicada automaticamente ao computador cliente (considerando que o Visual Studio não esteja em uso).

Atualizar programaticamente os computadores cliente

Os administradores podem atualizar programaticamente as instalações do cliente do Visual Studio emitindo os comandos ao instalador do lado do cliente ou invocando um bootstrapper no layout da rede.

Atualizar programaticamente o Visual Studio usando o Instalador do Visual Studio

Você pode iniciar uma atualização do Visual Studio invocando programaticamente o instalador do cliente e emitindo o comando de atualização. Esse comando atualiza o Visual Studio com base nos bits do produto disponíveis no local de origem de atualizações. Se você quiser alterar o local de origem da atualização no cliente durante a atualização, faça isso programaticamente passando o parâmetro --channelUri junto com o comando de atualização. Por exemplo:

Você pode alterar o canal para um layout de rede e executar um comando de atualização no cliente da seguinte maneira:

"C:\program files (x86)\microsoft\visual studio\installer\>setup.exe" update --installPath "C:\Program Files\Microsoft Visual Studio\2019\Enterprise" --channelUri "\\\\server\\share\\newlayoutdir\\channelmanifest.json"

ou desta maneira, que define a origem das atualizações em um local hospedado pela Microsoft:

"C:\program files (x86)\microsoft\visual studio\installer\>setup.exe" update --installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise" --channelUri "https://aka.ms/vs/17/release/channel"

Observe que nos dois exemplos anteriores, você não pode iniciar o instalador programaticamente no mesmo diretório em que o instalador reside.

Atualizar programaticamente o Visual Studio usando um bootstrapper

Você pode atualizar o Visual Studio chamando programaticamente um bootstrapper do mesmo local do qual originalmente você instalou. Se você baixou um bootstrapper da Microsoft e, se o cliente tem acesso à Internet, baixe e use qualquer bootstrapper atualizado para atualizar o cliente do Visual Studio. Preste atenção ao canal do bootstrapper, pois isso pode fazer com que o canal de atualização do cliente seja alterado.

Se o bootstrapper estiver localizado em um compartilhamento de layout de rede, o administrador deverá primeiro atualizar o layout de rede para conter as atualizações do produto Visual Studio para que o cliente possa usar esse bootstrapper na atualização.

O exemplo a seguir atualiza o cliente usando o bootstrapper existente no layout de rede original. Esse método considera que o administrador de TI já atualizou o layout.

\\server\share\originalinstallVSdirectory\vs_enterprise.exe update --installPath "C:\clientmachine\installpath" --quiet

Você também pode iniciar uma atualização do cliente Visual Studio 2019 chamando um bootstrapper programaticamente de um local de layout de rede diferente que contém a versão do produto de destino da atualização do cliente. Para fazer isso, o Instalador do Visual Studio 2022 precisa estar no cliente. A maneira mais fácil de habilitar isso é garantir que o novo layout do Visual Studio 2019 esteja usando o instalador mais recente. Se você executar o bootstrapper usando um novo layout hospedado na rede, o canal de atualização no cliente será definido como o local de atualização especificado no layout. Por exemplo, você pode executar esse comando no computador cliente usando um novo bootstrapper em um novo layout hospedado na rede:

Você também pode iniciar uma atualização do cliente do Visual Studio chamando um bootstrapper programaticamente de um local de layout de rede diferente que contém a versão do produto de destino da atualização do cliente. Se você executar o bootstrapper de um novo layout hospedado na rede, o canal de atualização no cliente será definido como o local de atualização especificado no layout. Por exemplo, você pode executar esse comando no computador cliente usando um novo bootstrapper em um novo layout hospedado na rede:

   \\server\share\desiredupdatelayoutdir\vs_enterprise.exe update --installPath "C:\clientmachine\installpath" --quiet

Qualquer que seja o valor do channelUri no arquivo response.json do novo layout, ele será o local onde o cliente vai procurar atualizações futuras.

Observação

Use o comando vswhere.exe para identificar o caminho de instalação de uma instância existente do Visual Studio em um computador cliente.

Atualizar programaticamente um cliente que não tem acesso à Internet

Se o computador cliente não tiver acesso à Internet, ele precisará adquirir as atualizações por meio de um layout. Lembre-se de que há duas partes que precisam ser atualizadas sempre que o Visual Studio é atualizado. O primeiro é o instalador e o segundo é o próprio produto Visual Studio. Para layouts hospedados na rede, você pode invocar o bootstrapper ou o instalador a fim de atualizar o cliente. Para layouts hospedados em servidor Web da intranet, você pode fazer a atualização invocando o instalador no cliente. O exemplo a seguir ilustra as duas situações e ambas consideram que o administrador já atualizou o layout ao máximo de bits seguros.

Este exemplo instrui o Visual Studio a procurar explicitamente esses dois componentes usando um layout de rede. O primeiro comando força o instalador a atualizar usando o layout e o segundo comando impede que todos os pacotes sejam baixados dos servidores hospedados pela Microsoft na Internet.

   \\server\share\VSlayoutdirectory\vs_enterprise.exe --quiet --update --wait --offline
   \\server\share\VSlayoutdirectory\vs_enterprise.exe update --installPath "C:\clientmachine\installpath" --noWeb --wait --quiet --norestart

Este exemplo instrui o Visual Studio a se atualizar usando o conteúdo incluído no layout interno hospedado no servidor Web da intranet.

   "C:\program files (x86)\microsoft\visual studio\installer\>setup.exe" update --installPath "C:\Program Files\Microsoft Visual Studio\2019\Enterprise"

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 Administrador de TI e não tiver o Visual Studio instalado, envie os comentários de Administrador de TI aqui. Ao usar essa ferramenta, é 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.

Conteúdo relacionado