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

📣 Adoraríamos ouvir o seu feedback!Por favor, reserve um momento para completar este de pesquisa e deixe-nos saber como podemos melhorar a experiência de layout. Obrigado pelo vosso 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 uma máquina em uma organização e tiver sido originalmente instalado a partir de um layout, provavelmente a máquina cliente faz parte de um "ambiente gerenciado", o que significa que ela é governada por uma equipe administrativa central e deve aderir às políticas organizacionais. Para atualizar máquinas cliente em ambientes gerenciados, considere as perguntas abaixo, pois 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 servidor web de intranet interno?
A atualização será iniciada manualmente pelo usuárioou é um evento iniciado pelo administrador, como por meio de um de atualização do administrador do ou por meio de um comando programático ? Lembre-se de que quem executa a atualização deve ter permissões de administrador na máquina 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 que o cliente está inscrito.

Se seus clientes estiverem configurados para adquirir atualizações de um layout, a primeira etapa antes de atualizar o cliente é certificar-se de que o layout em si contém a versão atualizada do Visual Studio. O administrador de TI deve atualizar o layout existente com as atualizações de produto mais recentes para que tanto as novas instalações de cliente quanto as atualizações de cliente possam receber a versão atualizada ou possam criar um layout totalmente novo em um diretório de layout diferente que você pode usar para atualizar as máquinas cliente. A prática recomendada é 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 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 na máquina cliente

Um usuário na máquina cliente com permissões suficientes pode iniciar manualmente a atualização do Visual Studio. O cliente Visual Studio procurará atualizações em seu local de origem 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 da seguinte forma:

iniciando o instalador do Visual Studio. Se uma atualização estiver disponível, eles poderão selecionar Atualizar.
iniciar o IDE do Visual Studio e responder ao sinalizador ou mensagem de notificação, ou escolher 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 é inicialmente instalado na máquina cliente, ele registra o local onde ele deve verificar se há atualizações. Se o Visual Studio foi 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 de layout de rede ou executando o script para instalar a partir de um layout hospedado na Web, ele procurará atualizações no local de especificado pelo layout.

Para visualizar e configurar manualmente o local de atualização a partir 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.

Notificações de atualização

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 utilizadores, consulte Controlar atualizações para implementações do Visual Studio baseadas em rede.

Usar atualizações de administrador para atualizar as máquinas cliente

Se você estiver em uma organização, a prática recomendada é inscrever suas máquinas 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 os seus layouts mensalmente, como na manhã da segunda quarta-feira do mês, e utilizar o Microsoft Endpoint Manager para distribuir as atualizações de segurança do Visual Studio nas máquinas clientes em toda a organização. As atualizações do administrador acionarão os clientes para examinar o local de origem da atualização para quaisquer novas atualizações e, se o layout tiver sido atualizado, a atualização será aplicada automaticamente à máquina cliente (presumindo que o Visual Studio não esteja em uso).

Atualizar programaticamente as máquinas cliente

Os administradores podem atualizar programaticamente as instalações de 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 update. Este comando atualizará o Visual Studio com base nos componentes do produto que estão disponíveis na localização 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 ao lado do comando update. Por exemplo:

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

"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"

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" update --installPath "C:\Program Files\Microsoft Visual Studio\18\Enterprise" --channelUri "https://aka.ms/vs/stable/channel"

Observe que nos dois exemplos anteriores, você não pode iniciar a execução do instalador programaticamente a partir 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 a partir do qual você instalou originalmente. Se você baixou um bootstrapper da Microsoft, então se seu cliente tiver acesso à Internet, você pode baixar e usar qualquer bootstrapper atualizado para atualizar seu cliente Visual Studio. Preste atenção ao canal do bootstrapper, pois isso pode fazer com que o canal de atualização do cliente mude.

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

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á tenha atualizado o layout.

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

Você também pode iniciar uma atualização para seu cliente Visual Studio chamando programaticamente um bootstrapper de um local de layout de rede diferente que contém a versão do produto para a qual você deseja atualizar o cliente. Se você executar o bootstrapper a partir de um novo layout hospedado na rede, o canal de atualização no cliente será definido para o local de atualização especificado no layout. Por exemplo, você pode executar este comando na máquina cliente usando um novo bootstrapper em um novo layout hospedado na rede:

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

Seja qual for o valor do channelUri no arquivo response.json do novo layout será o local onde o cliente procura 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 uma máquina cliente.

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

Se a sua máquina cliente não tiver acesso à internet, ela deve obter as atualizações 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 em rede, você pode invocar o bootstrapper ou o instalador para atualizar o cliente. Para layouts hospedados no servidor web da intranet, você pode atualizar invocando o instalador no cliente. O exemplo a seguir ilustra ambas as situações, e ambas pressupõem que o administrador já atualizou o próprio layout para os bits mais seguros.

Este exemplo instrui o Visual Studio a explicitamente procurar desses componentes de um layout de rede. O primeiro comando força o instalador a atualizar a partir do layout, e o segundo comando impede que quaisquer pacotes sejam baixados de 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 do servidor Web da intranet interna.

   "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" update --installPath "C:\Program Files\Microsoft Visual Studio\2019\Enterprise"

Obtenha suporte para o seu layout de rede

Se você tiver um problema com o layout da sua rede, queremos saber sobre isso. A melhor maneira de nos informar é usando a ferramenta Report a Problem que aparece no Visual Studio Installer e no IDE do Visual Studio. Se você for um administrador de TI e não tiver o Visual Studio instalado, envie comentários do administrador de TI aqui. Quando utilizas esta ferramenta, seria muito útil se conseguires enviar os logs de da ferramenta VS Collect que nos podem ajudar a diagnosticar e corrigir o problema.

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

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

Feedback

Esta página foi útil?

Last updated on 2025-12-12