Atualizar um cliente do Visual Studio que foi instalado a partir de um layout

📣adoraríamos ouvir seus comentários!Reserve um momento para concluir esta pesquisa e informe-nos como podemos melhorar a experiência de layout. Obrigado por seu apoio!

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 a partir de um layout, provavelmente o computador cliente faz parte de um "ambiente gerenciado", o que significa que ele é regido por uma equipe administrativa central e deve aderir às 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: um layout ou servidores hospedados pela Microsoft? Se a atualização for proveniente de um layout, o layout foi atualizado? O layout está hospedado em um compartilhamento de rede ou em um webserver de intranet interno?
• A atualização será iniciada manualmente pelo usuárioou será um evento iniciado pelo administrador, como por meio de uma atualização de administrador ou por meio de um comando programático ? Lembre-se de que quem executar a atualização deve ter permissões de administrador no computador cliente.

Preparar a fonte de atualização

Se seus clientes estiverem configurados para adquirir atualizações de servidores hospedados pela Microsoft, eles deverão ter acesso à Internet. Durante a atualização, os clientes baixarão e instalarão a versão mais recente disponível da Microsoft no canal de atualização ao qual o cliente está inscrito.

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 do cliente ou as atualizações do cliente possam receber a versão atualizada ou podem criar um layout totalmente novo em um diretório de layout diferente que você pode usar para atualizar os computadores cliente. A melhor prática é atualizar os layouts na segunda terça-feira do mês logo após as atualizações de segurança serem lançadas.

Verifique se o usuário ou a conta do sistema que está executando a atualização tem acesso adequado ao compartilhamento de rede ou ao site interno que contém o layout. Para obter mais informações, consulte 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 procurará no seu local de origem por atualizações para determinar se há pacotes de atualização disponíveis. É 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 uma atualização estiver disponível, eles podem 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, uma 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 onde deve verificar se há atualizações. Se o Visual Studio tiver sido instalado a partir de servidores hospedados pela Microsoft, ele procurará, por padrão, atualizações de 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.

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

Atualizar notificações

Se houver uma atualização disponível no local em que o cliente está procurando atualizações, o cliente 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, consulte Atualizações de controle para implantações do Visual Studio baseadas 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 desenvolver o hábito de manter e atualizar seus layouts mensalmente, como na 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 em sua organização. Atualizações de administrador farão com que os clientes verifiquem seu local de origem de atualizações para quaisquer novas atualizações e, se o layout tiver sido atualizado, a atualização será aplicada automaticamente ao computador cliente (presumindo que o Visual Studio não está em uso).

Atualizar programaticamente os computadores cliente

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

Atualizar programaticamente o Visual Studio usando o Instalador do Visual Studio

Você pode iniciar uma atualização para o Visual Studio invocando programaticamente o instalador do cliente e emitindo o comando de atualização. Esse comando atualizará o Visual Studio com base nos componentes do produto que estão disponíveis no local de origem para atualizações. Se você quiser alterar o local de origem da atualização no cliente durante a execução da atualização, poderá fazer 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 assim, que define a origem das atualizações para 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 a execução do instalador programaticamente do 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 você instalou originalmente. Se você baixou um bootstrapper da Microsoft, se o cliente tiver acesso à Internet, poderá baixar e usar qualquer bootstrapper atualizado para atualizar seu 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 pressupõe 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 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 será o local onde o cliente procura atualizações futuras.

Nota

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 do Visual Studio. Para layouts hospedados na rede, você pode invocar o bootstrapper ou o instalador para atualizar o cliente. Para layouts hospedados do webserver da intranet, você pode atualizar invocando o instalador no cliente. O exemplo a seguir ilustra ambas as situações e ambos pressupõem que o administrador já atualizou o layout em si para os bits mais 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 fazer a atualização a partir do 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 a partir do conteúdo incluído no layout hospedado no servidor web interno 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 seu 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 do Visual Studio. Se você é um Administrador de TI e não tem o Visual Studio instalado, pode enviar o feedback do 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 chat de instalação (em inglês apenas) para problemas relacionados à instalação.

Também temos outras opções de suporte disponíveis. Veja nossa Comunidade de Desenvolvedores do Visual Studio .

Conteúdo relacionado

• Criar e manter um layout de rede
• guia de administrador do Visual Studio
• Solucionar problemas de erros relacionados à rede ao instalar ou usar o Visual Studio
• Usar parâmetros de linha de comando para instalar o Visual Studio
• Ferramentas para detectar e gerenciar instâncias do Visual Studio
• Configurar políticas para implantações empresariais do Visual Studio
• Ciclo de Vida e Manutenção de Produtos do Visual Studio