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

Este documento descreve tipos e características diferentes das atualizações do administrador do Visual Studio. Neste artigo, você encontrará informações sobre como e quando eles devem ser distribuídos em toda a 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, confira Habilitar atualizações de administrador.

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

Noções básicas sobre atualizações do 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 do administrador do Visual Studio é publicada nos servidores do Microsoft Update, no qual é detectada como disponível e aplicável pelo agente cliente do Windows Update nativo.

O pacote de atualização do administrador do Visual Studio contém informações que o instalador do Visual Studio nos computadores cliente precisa para conseguir baixar e iniciar a atualização. O Instalador do Visual Studio 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 do 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 de produto mais alto e uma data de lançamento posterior é um superconjunto de uma versão mais antiga e anterior.

Observação

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 do administrador do Visual Studio só se aplicam a versões de manutenção do Visual Studio que ainda tenham 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, confira Ciclo de vida e manutenção do produto 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 do administrador

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

• As 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 limitadas, altamente direcionadas e compatíveis no nível de manutenção. As atualizações de segurança não avançarão o cliente para uma versão secundária posterior; elas foram projetadas para fornecer correções para vulnerabilidades de segurança ao 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 a atualização como uma atualização de segurança, mas ela realmente não teria nenhum efeito significativo no 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 componentes necessárias. As atualizações de segurança são publicadas nos três canais de distribuição listados anteriormente.

• As atualizações de recursos permitem que os administradores de TI avancem os computadores da organização para uma versão secundária 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 o cliente para uma versão secundária posterior; elas foram projetadas para fornecer correções de desempenho e confiabilidade ou outras atualizações de componente necessárias ao 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 lançada independentemente. 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 do administrador

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

• 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 "Feature Pack" será aplicada às edições do Visual Studio 2022 licenciadas para uso empresarial no cliente que está no Canal atual e o atualizará 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 do administrador que está sendo aplicada, a atualização do administrador não terá efeito.

Configurar o computador cliente para receber Atualizações do Administrador

Opções de configuração

Há algumas opções de configuração que podem ser usadas para personalizar a experiência de atualização do administrador do Visual Studio para que ela seja compatível e esteja alinhada com as preferências e os requisitos de implantação da 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 ter a opção AllowMUUpdateServicePolicy habilitada 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 para todo o computador, o que significa que ela se aplica a todas as instâncias do Visual Studio instaladas na caixa.

• 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 USER) deve ter privilégios administrativos no computador e acesso ao local de origem dos bits de produtos.

  • 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 for 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 do administrador, você precisará conceder as permissões de grupo "Computadores de Domínio" no compartilhamento de layout de rede.
  • O computador cliente deve ter, em algum momento, já executado o bootstrapper a partir desse local de layout de rede. Idealmente, a instalação original do cliente teria ocorrido usando o bootstrapper do layout de rede, mas também é possível ter acabado de instalar uma atualização usando um bootstrapper atualizado nesse mesmo local de rede. Qualquer uma dessas ações deveria inserir, 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 com suporte de atualização do administrador, confira a documentação Controlar Políticas de Grupo de Atualização do Administrador ou Usar parâmetros de linha de comando para atualizar o Visual Studio.

Métodos para configurar uma atualização do 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 de 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 do 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 é aplicável a todos os computadores, 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 é 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 definindo 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 no 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, confira Usar parâmetros de linha de comando para instalar o Visual Studio.

Aqui está um arquivo de configuração de exemplo:

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

Atualizar 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

Determinar 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>Sobre, e verifique se o número de 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, confira Ferramentas 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 capturam o progresso da operação de atualização. Classifique a pasta por data e procure os arquivos começando com dd_updatedriver, dd_bootstrapper, dd_client e 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. Confira a Ferramenta de Coleta de Logs do Visual Studio para obter mais detalhes.

Códigos e condições de erros

Importante

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

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

Código do 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 foi aplicada.
1002	O Instalador do Visual Studio está em pausa. A atualização não foi 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 internet detectada. A atualização não conseguiu contactar o local da Internet que contém os arquivos atualizados. A atualização não foi aplicada.
1005	O valor do registro AdministratorUpdatesEnabled está definido como 0 ou não está definido. A atualização não foi aplicada.
1006	O valor do registro AdministratorUpdatesOptOut está definido como 1. A atualização não foi 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 é recomendada uma reinicialização, 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 foi aplicada.

Para obter uma lista completa de códigos de erro do cliente, confira 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, confira Solução de problemas de instalação e atualização do Visual Studio para obter diretrizes passo a passo.

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

• Oferecemos uma opção de suporte por meio do chat de instalação (somente em inglês) para problemas relacionados à instalação.
• Relate problemas do produto para nós por meio da 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.
• Sugira um recurso, acompanhe os problemas do produto e encontre respostas na Comunidade de Desenvolvedores do Visual Studio.

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

• Faça perguntas à comunidade no Fórum de P e R de Configuração do Visual Studio.
• Acesse a página de suporte do Visual Studio e verifique se o problema está listado nas perguntas frequentes.
• Forneça comentários sobre recursos ou relate um problema à equipe do Visual Studio em relação à sua experiência.
• Entre em contato com o gerente de contas técnicas da Microsoft na sua organização.

Confira também

Para saber mais, explore os seguintes recursos adicionais:

• Habilitar atualizações de administrador
• Guia do administrador do Visual Studio
• Ciclo de vida e manutenção do produto Visual Studio
• Instalar o Visual Studio
• Atualizar 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
• Criar uma instalação de rede do Visual Studio
• Atualizar um cliente do Visual Studio que foi instalado de um layout de rede
• Perguntas frequentes do Catálogo do Microsoft Update
• Documentação do SCCM (Microsoft Endpoint Configuration Manager)
• Importar atualizações do Catálogo da Microsoft no Configuration Manager
• Documentação do WSUS (Windows Server Update Services)