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

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 eles devem ser distribuídos 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 Habilitando atualizações de administrador.

Lembre-se de que as atualizações do 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 instalação nova.

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

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

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

A grande maioria das máquinas clientes é atualizada usando os canais WSUS/SCCM ou Windows Update for Business/Microsoft Update/Intune. Em ambos os cenários, a atualização do administrador do Visual Studio é publicada nos servidores do Microsoft Update, onde é detetada 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 que o instalador do Visual Studio nas máquinas cliente precisa ser capaz de baixar e iniciar a atualização. O Visual Studio Installer baixa os binários de atualização de produto reais de onde quer que a máquina cliente esteja configurada para baixar atualizações do - 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 do produto mais alto e uma data de lançamento posterior é um superconjunto de uma versão mais antiga e inferior.

Observação

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

As atualizações de administrador do Visual Studio só se aplicam às versões de serviço do Visual Studio que ainda estão sob suporte. Para obter mais informações sobre quais linhas de base de serviço do Visual Studio ainda estão em suporte durante um período de tempo específico, consulte Visual Studio Product Lifecycle and Servicing. Todas as linhas de base de serviço do Visual Studio com suporte serão mantidas seguras.

Tipos e características das atualizações do administrador

Há três tipos de atualizações de 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 de nível de serviç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 são projetados para fornecer correções para vulnerabilidades de segurança para um cliente que já está em um determinado nível de versão secundária. 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 instalada na máquina cliente. Por exemplo, poderíamos corrigir uma vulnerabilidade de segurança nos componentes .NET e rotularíamos a atualização como uma atualização de segurança, mas ela realmente não teria nenhum efeito significativo em uma máquina 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 na sua organização para uma versão menor mais recente do Visual Studio. As atualizações de recursos só se aplicam às edições do Visual Studio que são comumente encontradas em empresas, como SKUs Enterprise, Professional e Build Tools. Todas as atualizações de recursos serão publicadas apenas no do Catálogo do Microsoft Update como "Feature Packs", onde estão disponíveis para serem importadas manualmente para o SCCM Configuration Manager. As atualizações de recursos são cumulativas e conterão qualidade adicional e correções de segurança anteriores.

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

Decodificando os títulos das atualizações do administrador

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

• 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 Current ou no canal LTSC 17.0e o levará para a versão 17.0.3.
• 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 no cliente que está no canal atual e será atualizada para a versão 17.1.0.
• 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 irá atualizá-la para a versão 17.2.7.
• de atualização de segurança do Visual Studio 2022 versão 17.3.7 será aplicada a qualquer edição do Visual Studio 2022 no cliente que estiver no canal Atual e a levará para a versão 17.3.7.

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

Configurando a máquina 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 alinhada com as preferências e os requisitos de implantação da sua organização.

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

• Windows Update para Empresas opt-in do Microsoft Update**

  As máquinas cliente conectadas à nuvem gerenciadas pelo Intune devem ser configuradas para o Windows Update for Business e optadas pelo AllowMUUpdateServicePolicy para receber atualizações de administrador do Visual Studio por meio do canal do Microsoft Update do Windows Update for Business.

• atualização de aceitação pelo administrador do Visual Studio

  Esta chave de registo é necessária para que o computador cliente receba atualizações de administrador através dos canais WSUS ou Windows Update for Business Microsoft Update. É uma chave de registro em toda a máquina, o que significa que 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, as máquinas 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 na máquina cliente que está executando a atualização (normalmente SYSTEM, mas pode ser personalizada para USER) deve ter privilégios administrativos na máquina e acesso ao local de origem dos bits do produto.

  • Se o produto for obtido da Internet, a conta SYSTEM que estiver a executar a atualização deve ter acesso a pelo menos aos 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 do Domínio" para o compartilhamento de layout de rede.
  • A máquina cliente deve já ter executado, em algum momento, o bootstrapper a partir da localização do layout de rede. Idealmente, a instalação do cliente original teria acontecido usando o bootstrapper do layout de rede, mas também é possível ter instalado apenas uma atualização usando um bootstrapper atualizado nesse mesmo local de rede. Qualquer uma dessas ações incorporaria, na máquina cliente, uma conexão com esse local de layout específico.
  • O local do layout de rede (ao qual o cliente está conectado) deve ser atualizado para conter os bits de produto atualizados que a atualização do administrador deseja implantar.

Para obter uma lista exaustiva de todos os comportamentos de atualização do administrador com suporte, consulte a documentação Controlling Administrator Update Group Policies ou a documentação Usar parâmetros de linha de comando para atualizar o Visual Studio.

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

Existem três métodos principais de configurar atualizações de administrador: por meio de políticas ), por meio de um ficheiro de configuração na máquina cliente, ou por meio de uma modificação do pacote de implementação da Atualização do Administrador no SCCM Configuration Manager ou no Microsoft Endpoint Manager.

Políticas

As atualizações do administrador procuram configurações de política específicas, 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 na máquina cliente em um arquivo de configuração opcional, que tem o benefício de defini-lo apenas uma vez e aplicá-lo a todas as atualizações futuras do administrador. A abordagem do arquivo de configuração se comporta como uma chave do Registro e é em toda a máquina, o que significa que se aplicará a todas as instalações do Visual Studio instaladas na máquina cliente. O local padrão para o arquivo de configuração está em C:\ProgramData\Microsoft\VisualStudio\updates.config. No entanto, se desejar usar outro local para armazenar o ficheiro, pode fazê-lo configurando a política UpdateConfigurationFile e definindo o valor para o caminho do seu ficheiro de configuração.

O arquivo de configuração, que está no formato JSON, suporta a 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 que não é suportada, a atualização falhará. Para obter mais informações, consulte Usar parâmetros de linha de comando para instalar o Visual Studio.

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

"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

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 na máquina cliente para identificar as várias versões do Visual Studio no computador. Para obter mais informações, consulte Ferramentas para detetar e gerenciar instâncias do Visual Studio.
• Cada tentativa de atualização administrativa gera vários arquivos de log no diretório %temp% da máquina cliente que captura o progresso da operação de atualização. Classifique a pasta por data e procure os 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 o Visual Studio Log Collection Tool 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 do 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 Visual Studio Installer ou um processo de instalação relacionado está em execução. A atualização não é aplicada.
1002	O Visual Studio Installer está pausado. A atualização não é aplicada.
1003	O Visual Studio está em uso, portanto, a atualização foi cancelada. Esta condição pode ser anulada usando o sinalizador --force.
1004	Nenhuma conexão à internet detetada. 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 valor do Registro AdministratorUpdatesEnabled está 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 faltam 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. Reinicie 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.
Outros	Ocorreu um erro ao tentar aplicar a atualização. A atualização não é aplicada.

Para obter uma lista exaustiva 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

Por vezes, as coisas podem correr mal. Se a instalação do Visual Studio falhar, consulte Solucionar problemas de instalação e atualização do Visual Studio para obter orientação passo a passo.

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

• Use a opção de suporte do chat de instalação (apenas em inglês) para problemas relacionados à instalação.
• Comunique-nos problemas de produto 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, poderá enviar comentários do administrador de TI.
• Sugira um recurso, acompanhe 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 do administrador do Visual Studio ou relatar problemas que afetam as atualizações:

• Faça perguntas à comunidade no Visual Studio Setup Q&A Forum.
• Vá para a página de suporte do Visual Studioe verifique se o problema está listado nas Perguntas frequentes.
• Forneça comentários sobre recursos ou relate um problema para a equipe do Visual Studio em relação à sua experiência.
• Entre em contato com o gerente técnico de contas da sua organização para a Microsoft.

Ver também

Para saber mais, explore os seguintes recursos adicionais:

• Ativando 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
• Usando parâmetros de linha de comando para instalar o Visual Studio
• Ferramentas para detetar 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 a partir de um layout de rede
• Perguntas frequentes sobre o catálogo do Microsoft Update
• Documentação de Microsoft Endpoint Configuration Manager (SCCM)
• Importar atualizações do Catálogo Microsoft para o Configuration Manager
• Documentação do Windows Server Update Services (WSUS)