Compartilhar via

Aplicando atualizações de administrador que usam o Microsoft Endpoint Manager (SCCM ou Intune)

  • Artigo

Este documento descreve diferentes tipos e características de atualizações de administrador do Visual Studio. Neste artigo, você encontrará informações sobre como e quando elas devem ser distribuídas em toda a sua organização, quais opções de configuração estão disponíveis e como exibir relatórios e solucionar problemas.

Pré-requisitos

Para obter mais informações sobre os pré-requisitos para usar atualizações de administrador, consulte Habilitar atualizações de administrador.

Lembre-se de que as atualizações de administrador são atualizações, não instalações iniciais. Eles presumem que o Visual Studio já está instalado no computador. Em outras palavras, a aplicação de atualizações de administrador não iniciará uma nova instalação.

Noções básicas sobre as atualizações de administrador do Visual Studio

O pacote de atualização do administrador do Visual Studio publicado no sistema do Microsoft Update está disponível por meio de três canais de distribuição:

  1. O canal WSUS (Windows Server Update Server), que normalmente é controlado pelo SCCM Configuration Manager, que faz parte da solução de gerenciamento de dispositivos do Microsoft Endpoint Manager.
  2. O canal Windows Update para Empresas do Microsoft Update, que normalmente é controlado pelo Intune, faz parte da solução de gerenciamento de dispositivos do Microsoft Endpoint Manager. Atualmente, somente as atualizações de segurança são publicadas neste canal.
  3. O canal do Catálogo do Microsoft Update, no qual você pode baixar o pacote e usá-lo para atualizar um layout ou atualizar uma instância de cliente.

A grande maioria dos computadores cliente é atualizada usando os canais WSUS/SCCM ou Windows Update para Empresas/Microsoft Update/Intune. Em ambos os cenários, a atualização de administrador do Visual Studio é publicada nos servidores do Microsoft Update, em que é detectada como disponível e aplicável pelo agente cliente nativo do Windows Update.

O pacote de atualização do administrador do Visual Studio contém informações de que o instalador do Visual Studio nos computadores cliente precisa ser capaz de baixar e iniciar a atualização. O Visual Studio Installer baixa os binários reais de atualização de produto do local que o computador cliente está configurado para baixar atualizações, seja da Internet ou de um layout.

O pacote de atualização do administrador não contém informações suficientes para executar uma instalação limpa do produto, nem contém nenhum dos binários reais do produto. As atualizações de administrador do Visual Studio são cumulativas, o que significa que qualquer atualização do Visual Studio que tenha um número de versão mais alto do produto e uma data de lançamento posterior é um superconjunto de uma versão mais antiga e inferior.

Nota

Por padrão, a conta SYSTEM do computador cliente baixará e instalará as atualizações do administrador do Visual Studio, o que significa que a conta SYSTEM deve ter privilégios administrativos para o computador e também deve ter acesso à Internet ou ao local de layout de rede para baixar os bits de produtos atualizados.

As atualizações de administrador do Visual Studio só se aplicam às versões de manutenção do Visual Studio que ainda estão sob suporte. Para obter mais informações sobre quais linhas de base de manutenção do Visual Studio ainda têm suporte durante um período específico, consulte o Ciclo de Vida eManutenção de Produtos do Visual Studio. Todas as linhas de base de manutenção do Visual Studio com suporte serão mantidas seguras.

Tipos e características de atualizações de administrador

Há três tipos de atualizações de administrador para o Visual Studio:

  • atualizações de segurança são aplicáveis a todas as edições do Visual Studio (por exemplo, Enterprise, Professional, Community etc.) e contêm alterações de nível de manutenção limitadas, altamente direcionadas e compatíveis. As atualizações de segurança não avançarão um cliente para uma versão secundária posterior; eles foram projetados para fornecer correções para vulnerabilidades de segurança para um cliente que já está em um nível de versão secundária específico. As atualizações de segurança terão pelo menos uma correção de segurança, mas a correção de segurança pode ou não estar em um componente ou carga de trabalho instalado no computador cliente. Por exemplo, poderíamos corrigir uma vulnerabilidade de segurança nos componentes do .NET e rotularíamos a atualização como uma atualização de segurança, mas ela realmente não teria nenhum efeito significativo em um computador cliente que tivesse apenas componentes C++ instalados. As atualizações de segurança também podem conter outras correções de confiabilidade ou outras atualizações de componente necessárias. As atualizações de segurança são publicadas nos três canais de distribuição listados anteriormente.

  • Atualizações de recursos permitem que os administradores de TI atualizem os computadores em sua organização para uma versão menor mais recente do Visual Studio. As atualizações de recursos se aplicam apenas às edições do Visual Studio que normalmente são encontradas em empresas, como SKUs das Ferramentas de Build, do Enterprise e do Professional. Todas as atualizações de recursos serão publicadas somente no Catálogo do Microsoft Update como "Feature Packs", em que estão disponíveis para serem importadas manualmente, como opção, no SCCM Configuration Manager. As atualizações de recursos são cumulativas e conterão mais qualidade e correções de segurança anteriores.

  • As atualizações de qualidade também são aplicáveis somente às edições do Visual Studio que são comumente encontradas em empresas e contêm alterações limitadas, altamente direcionadas e compatíveis no nível de manutenção. As atualizações de qualidade não avançarão um cliente para uma versão secundária posterior; eles foram projetados para fornecer correções de desempenho e confiabilidade ou outras atualizações de componente necessárias para um cliente que já está em um nível de versão secundária específico. As atualizações de qualidade se acumulam junto com as atualizações de segurança e, portanto, conterão correções de segurança somente se a correção de segurança já tiver sido liberada de forma independente. As atualizações de qualidade também serão publicadas somente no Catálogo do Microsoft Update como "Atualizações", em que estão disponíveis para serem importadas manualmente, como opção, no SCCM Configuration Manager.

Decodificação dos títulos das atualizações de administrador

O título de cada administrador atualiza a versão resultante da atualização. Por exemplo

  • A atualização do Visual Studio 2019 da versão 16.0.0 para 16.9.0, classificada como um "Feature Pack", será aplicada às edições do Visual Studio 2019 licenciadas para uso empresarial no cliente corporativo para toda a faixa de versões do produto de 16.0.0 a 16.9.0, e atualizará a edição do cliente corporativo para 16.9.0.
  • atualização do Visual Studio 2019 versão 16.0.0 a 16.11.21 classificadas como "Atualizações de Segurança" serão aplicadas às edições do Visual Studio 2019 licenciadas para uso corporativo no cliente entre as versões 16.0.0 e 16.11.20, e atualizará essas edições de cliente para 16.11.21.
  • atualização de segurança do Visual Studio 2019 versão 16.11.21 será aplicada às edições do Visual Studio 2019 licenciadas para uso corporativo no cliente entre as versões 16.0.0 e 16.11.20 e atualizará essas edições de cliente para 16.11.21.
  • A atualização do Visual Studio 2022 versão 17.0.3 classificada como "Atualização de Segurança" será aplicada a qualquer edição do Visual Studio 2022 no cliente que esteja no Canal atual ou no canal LTSC 17.0 e o atualizará para a versão 17.0.3.
  • A atualização do Visual Studio 2022 versão 17.1.0, classificada como um "Feature Pack", será aplicada às edições do Visual Studio 2022 licenciadas para uso corporativo nos clientes que estão no canal Atual, atualizando-as para a versão 17.1.0.
  • A atualização do Visual Studio 2022 versão 17.2.7 classificada como "Atualização de Segurança" será aplicada a qualquer edição do Visual Studio 2022 no cliente que esteja no Canal atual ou no canal LTSC 17.2 e o atualizará para a versão 17.2.7.
  • A atualização de segurança do Visual Studio 2022 versão 17.3.7 aplicada a qualquer edição do Visual Studio 2022 no cliente que esteja no Canal atual e o atualizará para a versão 17.3.7.

Se a instância do cliente for maior que a versão da atualização de administrador que está sendo aplicada, a atualização do administrador não terá efeito.

Configurando o computador cliente para receber atualizações de administrador

Opções de configuração

Há algumas opções de configuração que podem ser usadas para adaptar a experiência de atualização do administrador do Visual Studio para que ela seja compatível e alinhada com as preferências e requisitos de implantação da sua organização.

As opções de configuração mais comuns são as seguintes:

  • Aceitação do Windows Update para Empresas do Microsoft Update**

    Os computadores cliente conectados à nuvem gerenciados pelo Intune devem ser configurados para o Windows Update para Empresas e optados pelo AllowMUUpdateServicePolicy para receber atualizações de administrador do Visual Studio por meio do canal Windows Update para Empresas do Microsoft Update.

  • Aceitação de atualização do administrador do Visual Studio

    Essa chave do Registro é necessária para que o computador cliente receba atualizações de administrador por meio dos canais do WSUS ou do Windows Update para Empresas do Microsoft Update. É uma chave do Registro do sistema, o que significa que ela se aplica a todas as instâncias do Visual Studio instaladas no computador.

  • Local de origem dos bits de produto atualizados

    Ao executar a atualização, os computadores cliente baixarão os bits de produto atualizados da Internet por meio da CDN da Microsoft ou de um compartilhamento de layout de rede que o administrador preparou e manteve. Em ambos os casos, a conta no computador cliente que está executando a atualização (normalmente SYSTEM, mas pode ser personalizada para o USER) deve ter privilégios administrativos no computador e acesso ao local de origem dos bits do produto.

    • Se o produto for originado da Internet, a conta SYSTEM que executa a atualização deverá ter acesso a pelo menos os pontos de extremidade do Visual Studio.
    • Se o produto estiver sendo originado de um local de layout de rede, as seguintes condições deverão ser verdadeiras antes que a atualização do administrador possa ser implantada com êxito:
    • A conta que executa a atualização deve ter permissões para o compartilhamento de rede. Por exemplo, se as contas SYSTEM estiverem executando as atualizações de administrador, você precisará conceder permissões ao grupo "Computadores de Domínio" para o compartilhamento de layout de rede.
    • O computador cliente deve ter, em algum momento, já executado o carregador de inicialização a partir desse local de layout de rede. Idealmente, a instalação original do cliente teria acontecido usando o bootstrapper do layout de rede, mas também é possível ter instalado uma atualização usando um bootstrapper atualizado nesse mesmo local de rede. Qualquer uma dessas ações inseriria, no computador cliente, uma conexão com esse local de layout específico.
    • O local de layout de rede (no qual o cliente está conectado) deve estar atualizado para conter os bits de produtos atualizados que a atualização do administrador deseja implantar.

Para obter uma lista completa de todos os comportamentos de atualização de administrador com suporte, consulte as Diretrizes de Controle de Políticas de Grupo de Atualização do Administrador ou o documento Uso de Parâmetros de Linha de Comando para Atualizar o Visual Studio.

Métodos para configurar uma atualização de administrador

Há três métodos principais de configuração de atualizações de administrador: por meio de políticas ) por meio de um arquivo de configuração no computador cliente ou por meio de uma modificação do pacote de implantação atualização do administrador no SCCM Configuration Manager ou no Microsoft Endpoint Manager.

Políticas

As atualizações de administrador procuram uma configuração de política específica, como AdministratorUpdatesEnabled, conforme descrito em Configurar políticas para implantações empresariais. O acesso de administrador no computador cliente é necessário para configurar políticas.

Arquivo de configuração

Algumas configurações podem ser preservadas no computador cliente em um arquivo de configuração opcional, que tem o benefício de defini-lo apenas uma vez e tê-lo aplicado a todas as atualizações futuras do administrador. A abordagem do arquivo de configuração se comporta como uma chave do Registro e é de todo o computador, o que significa que ela se aplicará a todas as instalações do Visual Studio instaladas no computador cliente. O local padrão do arquivo de configuração está em C:\ProgramData\Microsoft\VisualStudio\updates.config. No entanto, se você quiser usar outro local para armazenar o arquivo, poderá fazer isso configurando a política UpdateConfigurationFile e defina o valor como o caminho do arquivo de configuração.

O arquivo de configuração, que está no formato JSON, dá suporte à opção installerUpdateArgs, que é uma matriz de cadeias de caracteres separadas por vírgulas que especificam mais opções que você pode passar para o instalador do Visual Studio. Se o conteúdo do arquivo incluir um campo inválido ou uma opção sem suporte, a atualização falhará. Para obter mais informações, consulte Usar parâmetros de linha de comando para instalar o Visual Studio.

Veja um exemplo de arquivo de configuração:

"installerUpdateArgs" : ["--quiet", "--keepWindowsUpdateOn"], 
"checkPendingReboot" :  "true"

Atualizando manualmente o Pacote de Atualizações do Administrador no SCCM ou no Intune

Os parâmetros de linha de comando de um pacote de atualização de administrador individual podem ser modificados manualmente no SCCM ou no Microsoft Endpoint Manager pelo Administrador de TI. Geralmente, não recomendamos essa abordagem, embora seja tecnicamente possível.

Verificação, códigos de erro e solução de problemas

Determinando que o Visual Studio foi atualizado

Você pode usar um dos seguintes métodos para verificar se a atualização do administrador foi instalada corretamente:

  • No computador cliente, inicie o Visual Studio, selecione Ajuda>Sobree verifique se o número da versão corresponde ao último número no título da atualização pretendida.
  • Use a ferramenta vswhere no computador cliente para identificar as várias versões do Visual Studio no computador. Para obter mais informações, consulte Tools para detectar e gerenciar instâncias do Visual Studio.
  • Cada tentativa de atualização administrativa gera vários arquivos de log no diretório %temp% do computador cliente que captura o progresso da operação de atualização. Classifique a pasta por data e procure arquivos que começam dd_updatedriver, dd_bootstrapper, dd_cliente dd_setup para as atualizações administrativas, o bootstrapper, o Instalador do Visual Studio e o mecanismo de instalação, respectivamente. Verifique se esses arquivos de log contêm um 0, indicando que a atualização foi aplicada com êxito. Esses arquivos de log também podem ser usados para verificar se o arquivo de configuração está sendo usado. Consulte a Ferramenta de Coleção de Logs do Visual Studio para obter mais detalhes.

Códigos e condições de erro

Importante

Lembre-se de que o Visual Studio deve ser fechado antes de instalar a atualização. Se o Visual Studio estiver aberto ou sendo usado, a instalação da atualização será cancelada.

As atualizações de administrador podem retornar os seguintes códigos de retorno:

Código de erro Definição
0 A atualização administrativa foi instalada com êxito.
1001 O Instalador do Visual Studio ou um processo de instalação relacionado está em execução. A atualização não é aplicada.
1002 O Instalador do Visual Studio está em pausa. A atualização não é aplicada.
1003 O Visual Studio está em uso, portanto, a atualização foi cancelada. Essa condição pode ser anulada usando o sinalizador --force.
1004 Nenhuma conexão com a internet detectada. A atualização não pôde entrar em contato com o local da Internet que contém os arquivos atualizados. A atualização não é aplicada.
1005 O AdministratorUpdatesEnabled valor do registro é definido como 0 ou não está definido. A atualização não é aplicada.
1006 O valor do registro AdministratorUpdatesOptOut é definido como 1. A atualização não é aplicada. A chave destina-se a computadores cliente que não devem ser atualizados pelo administrador.
1007 O Instalador do Visual Studio não está instalado.
1009 A instância do Visual Studio está configurada para usar um layout, mas estão faltando pacotes no layout para executar a atualização.
3010 O sistema requer uma reinicialização. A atualização pode ou não ter sido aplicada. Reinicialize o computador e tente a atualização novamente.
8006 A atualização foi cancelada porque o processo relacionado ao VS está em execução
862968 A atualização foi bem-sucedida e uma reinicialização é recomendada, mas não é necessária.
8007070 A atualização foi cancelada porque não há espaço suficiente no disco.
Outro Erro ao tentar aplicar a atualização. A atualização não é aplicada.

Para obter uma lista completa de códigos de erro do cliente, consulte Usar parâmetros de linha de comando para instalar o Visual Studio.

Suporte ou solução de problemas

Às vezes, as coisas podem dar errado. Se a instalação do Visual Studio falhar, consulte Solucionar problemas de instalação e atualização do Visual Studio para obter diretrizes passo a passo.

Aqui estão mais algumas opções de suporte:

  • Use a opção de chat de instalação (somente em inglês) para problemas relacionados à instalação.
  • Relate os problemas do produto para nós usando a ferramenta Relatar um Problema que aparece tanto no Instalador do Visual Studio quanto no IDE do Visual Studio. Se você for um Administrador de TI e não tiver o Visual Studio instalado, poderá enviar comentários do Administrador de TI.
  • Sugira um recurso, acompanhe os problemas do produto e encontre respostas no da Comunidade de Desenvolvedores do Visual Studio.

Você pode usar os seguintes métodos para fornecer comentários sobre atualizações de administrador do Visual Studio ou problemas de relatório que afetam as atualizações:

Consulte também

Para saber mais, explore os seguintes recursos adicionais: