Configurar políticas para implantações empresariais do Visual Studio

Você pode configurar determinados aspectos do comportamento de implantação e atualização do Visual Studio por meio de políticas. Algumas dessas configurações são particulares a uma instância instalada do Visual Studio e algumas das configurações podem ser globais e se aplicar a todas as instâncias do Visual Studio no computador cliente. Você pode configurar o seguinte:

• Se os usuários sem permissões de administrador tiverem permissão para atualizar ou modificar o Visual Studio
• Os componentes sem suporte devem ser removidos do computador
• Onde alguns pacotes compartilhados com outras versões ou instâncias são instalados
• Onde e se os pacotes são armazenados em cache
• Se as atualizações de administrador estiverem habilitadas e como elas devem ser aplicadas
• Quais canais de atualização estão disponíveis e como eles são apresentados ao cliente
• Como as notificações aparecem ou não aparecem

Configure e implante políticas globais para toda a sua organização usando o Catálogo de configurações do Microsoft Intune ou importando Modelos Administrativos do Visual Studio (ADMX) em ferramentas legadas, como o editor de Política de Grupo. Você também pode definir valores do Registro diretamente no computador cliente. Comportamentos por instância normalmente são controlados usando Opções de linha de comando no computador cliente.

Chaves do Registro

Há vários locais no registro em que você pode definir essas políticas. O Visual Studio verifica de forma sequencial, na seguinte ordem, se alguma política empresarial está definida. Assim que um valor de política é descoberto, as chaves restantes são ignoradas.

1. HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\VisualStudio\Setup
2. HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\Setup
3. HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\VisualStudio\Setup (em sistemas operacionais de 64 bits)

Alguns valores do Registro são definidos automaticamente na primeira vez em que são usados se ainda não estiverem definidos. Essa prática garante que as instalações subsequentes usem os mesmos valores. Esses valores são armazenados na segunda chave do Registro, HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\Setup.

Você pode definir os seguintes valores do Registro:

Controlando o comportamento de instalação, download e atualização

As configurações do Registro nesta seção controlam como e onde o produto do Visual Studio é baixado e instalado no computador cliente.

Nome	Tipo	Padrão	Descrição
AllowStandardUserControl	REG_DWORD	0	Permite que usuários sem permissões de administrador gerenciem manualmente suas instalações do Visual Studio usando a interface do usuário do Instalador: se definido como 1, os usuários sem permissões de administrador podem atualizar ou reverter manualmente uma atualização sem a necessidade de fornecer uma senha de administrador. Se definido como 2, os usuários sem permissões de administrador poderão usar todas as funcionalidades no Instalador do Visual Studio manualmente, incluindo Modificar e Instalar da guia Disponível. Os Usuários Padrão não podem executar nenhum comando do Instalador do Visual Studio programaticamente com os parâmetros --passive ou --quiet, independentemente de como essa política está definida. Essa política requer que a versão mais recente do Instalador do Visual Studio 2022 seja instalada no computador cliente.
CachePath	REG_SZ ou REG_EXPAND_SZ	%ProgramData% \Microsoft \VisualStudio \Packages	Manifesto do pacote e caminho do cache de conteúdo: o Visual Studio Installer impõe um limite de 50 caracteres para o caminho desse diretório de cache de armazenamento. Para obter mais informações, consulte Desabilitar ou mover a página de cache do pacote
KeepDownloadedPayloads	REG_DWORD	1	Manter os conteúdos do pacote após a instalação: desabilitar a política remove quaisquer cargas de pacote armazenadas em cache para a instância que você reparar ou modificar. Você pode alterar o valor a qualquer momento. Para saber mais, confira a página Desabilitar ou mover o cache do pacote.
SharedInstallationPath	REG_SZ ou REG_EXPAND_SZ	%ProgramFiles(x86)% \Microsoft Visual Studio \Shared	caminho de instalação compartilhado: o diretório em que alguns pacotes compartilhados entre versões de instâncias do Visual Studio são instalados. Você pode alterar o valor a qualquer momento, mas isso só afetará as instalações futuras. Todos os produtos já instalados no local antigo não devem ser movidos ou podem não funcionar corretamente. O Instalador do Visual Studio impõe um limite de 150 caracteres para o caminho.
BackgroundDownloadDisabled	REG_DWORD	0	Desabilitar o download de atualizações automaticamente: se definido como 1, a instalação será impedida de baixar atualizações automaticamente para todos os produtos instalados do Visual Studio. Você pode alterar o valor a qualquer momento.
RemoveOos	REG_DWORD	0	Remover componentes sem suporte durante as atualizações: se definido como 1, o Instalador do Visual Studio removerá todos os componentes instalados transferidos para um estado fora de suporte durante todas as atualizações subsequentes. Se definido como 0 ou ausente inteiramente, o comportamento respeitará outros locais em que essa configuração pode ser configurada, como o parâmetro de linha de comando ou a caixa de diálogo Configurações de Atualização . Para obter mais informações, confira a postagem no blog Remove out-of-support components (Remover componentes sem suporte). Essa funcionalidade requer que o instalador do Visual Studio 2022 versão 17.4 seja instalado no computador cliente.
DisableRollback	REG_DWORD	0	Desabilitar a capacidade de reverter ou desfazer uma atualização do Visual Studio: se definido como 1, os usuários serão impedidos de acessar o recurso de reversão, o que impede que o Visual Studio reverta a atualização mais recente, que pode conter uma correção de segurança. Se definido como 0 ou ausente inteiramente, os usuários poderão acessar o recurso de reversão no Visual Studio e desfazer uma atualização e reverter suas instâncias do Visual Studio para a versão instalada anteriormente. Para saber mais, confira a postagem no blog Rollback (Reversão).
HideAvailableTab	REG_DWORD	0	Ocultar a guia Disponível do instalador: se definido como 1, os administradores poderão ocultar a guia Disponível do instalador, o que pode impedir que os usuários da organização instalem acidentalmente o produto errado.
DisableSound	REG_DWORD	0	Desabilitar sons no instalador: se definido como 1, os usuários poderão desabilitar sons no Instalador do Visual Studio, o que impedirá qualquer indicação de áudio quando uma operação do instalador for concluída ou quando houver um erro. As operações do instalador incluem instalação, atualização, modificação e muitas outras operações feitas pelo instalador ou quaisquer caixas de diálogo de erro ao tentar a operação solicitada. Se definido como 0 ou totalmente ausente, os usuários poderão reabilitar os sons no instalador. Para obter mais informações, consulte a postagem no blog DisableSound.

Importante

Se você alterar a política de registro CachePath após qualquer instalação, deverá mover o cache do pacote existente para o novo local e certificar-se de que ele esteja protegido, de modo que SYSTEM e Administrators tenham Controle Total e que Everyone tenha acesso de leitura . A falha ao mover o cache existente ou protegê-lo pode causar problemas com instalações futuras.

Controle de Atualizações do Administrador

As configurações do Registro nesta seção controlam se e como as atualizações de administrador são aplicadas ao computador cliente.

Nome	Tipo	Padrão	Descrição
AdministratorUpdatesEnabled	REG_DWORD	0	Habilitar atualizações de administrador: permite que as atualizações do administrador sejam aplicadas ao computador cliente. Se esse valor estiver ausente ou estiver definido como 0, as atualizações do administrador serão bloqueadas. Um valor 1 disponibiliza o computador cliente para atualizações implantadas por meio do canal WSUS/SCCM. O valor recomendado de 2 disponibiliza o computador cliente para receber atualizações implantadas por meio do canal WSUS/SCCM ou do canal do Gerenciador do Windows Update para Empresas/Intune/Microsoft Endpoint. Essa chave do Registro é para o usuário administrador. Para obter mais informações, confira Habilitar Atualizações de Administrador.
AdministratorUpdatesNotifications	REG_DWORD	0	Permite que os administradores notifiquem os usuários para fecharem o Visual Studio para desbloquear a atualização do administrador: se o Visual Studio estiver aberto ou em uso, a atualização do administrador não será aplicada. Ao definir essa chave do Registro, o administrador pode fazer com que um prompt de notificação do sistema do Windows solicite que o usuário feche o Visual Studio e salve seu trabalho para que a atualização pendente possa ser aplicada. Essa chave do Registro é para o usuário administrador. Para obter mais informações, confira o comunicado da postagem no blog.
AdministratorUpdatesOptOut	REG_DWORD	0	Recusar atualizações de administrador: indica que o usuário não deseja receber atualizações de administrador para o Visual Studio. A ausência do valor do Registro ou um valor definido de 0 significa que o usuário do Visual Studio deseja receber atualizações de administrador para o Visual Studio. Essa política serve para o usuário desenvolvedor configurar se ele tiver permissões de administrador no computador cliente. A chave AdministratorUpdatesOptOut para codificar a preferência do usuário é priorizada sobre a chave AdministratorUpdatesEnabled, que codifica a intenção do administrador de TI. Se AdministratorUpdatesOptOut estiver definido como 1, a atualização será bloqueada no cliente, mesmo que a chave AdministratorUpdatesEnabled também esteja definida como 1. Essa ação pressupõe que os administradores de TI possam acessar e monitorar quais desenvolvedores optaram por recusar. As duas partes podem então discutir cujas necessidades são mais importantes. Os administradores de TI sempre podem alterar qualquer chave sempre que desejarem.
UpdateConfigurationFile	REG_SZ ou REG_EXPAND_SZ	%ProgramData% \Microsoft \VisualStudio \updates.config	caminho personalizado para o arquivo de configuração de atualização: o caminho para o arquivo no cliente que pode ser usado para configurar Atualizações Administrativas. Por padrão, esse arquivo não existe e a política não está definida. Se você optar por adicionar a política ao computador cliente e definir um local de arquivo de configuração personalizado, a atualização do Administrador procurará esse arquivo. Se o arquivo não existir, uma exceção será lançada e a atualização falhará. Para obter mais informações, consulte Métodos para configurar uma atualização de administrador.

Importante

Os computadores cliente conectados à nuvem gerenciados pelo Intune devem ser configurados para o Windows Update para Empresas e inscrever-se na opção "Habilitar Atualizações para Outros Produtos da Microsoft" a fim de receber atualizações de administrador do Visual Studio por meio do canal do Microsoft Update do Windows Update para Empresas.

Configurando o local de origem para atualizações

As configurações nesta seção permitem que um administrador personalize e controle quais canais de atualização estão disponíveis e como eles aparecem para clientes em uma organização corporativa. Para obter informações sobre quais são as configurações de atualização e como elas funcionam, confira a documentação Configurar o local de origem das atualizações. Essa funcionalidade exige que o cliente use o Instalador do Visual Studio 2022 e que o layout use uma versão do bootstrapper de 2019 que tenha sido lançada em ou após 10 de novembro de 2021. Para obter diretrizes, confira a doc Como obter o instalador do Visual Studio 2022 em seus computadores cliente com um layout do Visual Studio 2019.

As chaves nesta seção se aplicam somente ao caminho do registro Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\Setup

Nome	Tipo	Descrição
Channels	Key	Caminho da subchave para armazenar informações do canal de layout personalizado. O nome dessa chave é considerado o nome do canal e é o que aparece no menu suspenso Atualizar canal. O valor ChannelURI é necessário para estar presente na subchave Channels.
DisabledChannels	Key	Caminho da subchave para suprimir canais e impedir que apareçam na caixa de diálogo Atualizar canal. Se o canal for definido aqui (juntamente com o valor ChannelURI), ele será filtrado para fora da caixa de diálogo.
ChannelURI	REG_SZ	O channelURI deve ser adicionado à lista de valores de canal de atualização adicionando à seção Channels ou suprimido da lista de canais de atualização adicionando à seção de registro DisabledChannels. Para canais hospedados pela Microsoft, o channelURI é https://aka.ms/vs/16/release/channel ou https://aka.ms/vs/16/pre/channel. Para layouts, esse valor precisa apontar para o ChannelManifest.json do layout. Consulte exemplos.
Description	REG_SZ	Uma descrição personalizada do canal em duas linhas. Se você já tiver instalado a partir de um layout, a interface de usuário das Configurações de Atualização será definida como padrão para "Canal Privado" e poderá alterá-la usando a opção de Descrição.

Alguns exemplos de arquivo do Registro que ilustram como um administrador de TI pode querer personalizar a interface do usuário de Configurações de Atualização:

O primeiro exemplo de registro pode ser usado em uma situação em que o cliente instalou previamente a partir de um layout de rede localizado em \\vslayoutserver3\vs\2019_Enterprise. Conforme mencionado anteriormente, o Visual Studio usa como padrão o nome do canal para esse layout como "Canal Privado". Veja como você personalizaria o nome e a descrição do canal para este layout.

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\Setup\Channels]

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\Setup\Channels\More meaningful name of my existing layout]
"channelUri"="\\\\vslayoutserver3\\vs\\2019_Enterprise\\ChannelManifest.json"
"Description"="Dev Tools based on VS 2019 16.9.Spring.2020 servicing baseline"

Veja como adicionar algumas entradas de layout adicionais para outros canais de atualização personalizados que estão disponíveis como fonte para atualizações, e também como impedir que o canal Preview seja exibido.

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\Setup\Channels]

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\Setup\Channels\Spring 2021 dev toolset]
"channelUri"="\\\\new2019layoutserver\\share\\new2019layout\\ChannelManifest.json"
"Description"="Dev Tools based on VS 2019 16.11.Spring.2021 servicing baseline"

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\Setup\Channels\Next gen dev tools using VS 2022 toolset]
"channelUri"="\\\\vs2022Layoutserver\\share\\2022Enterprise\\ChannelManifest.json"
"Description"="Developer Tools based on the VS 2022 17.0.Winter.2021 LSTC servicing baseline"

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\Setup\DisabledChannels\Preview]
"channelUri"="https://aka.ms/vs/16/pre/channel"

Controlando notificações no IDE do Visual Studio

Conforme descrito anteriormente, o Visual Studio verifica o local do qual está instalado, como um compartilhamento de rede ou a Internet, para ver se há atualizações disponíveis. Quando uma atualização está disponível, o Visual Studio notifica o usuário com um ícone de notificação no canto inferior direito da janela.

Você pode desabilitar as notificações se não quiser que os usuários finais sejam notificados sobre atualizações. (Por exemplo, talvez você queira desabilitar as notificações se entregar atualizações por meio de um mecanismo central de distribuição de software.)

Como o Visual Studio 2022 armazena entradas de registro em um registro privado, você não pode editar diretamente o registro da maneira típica. No entanto, o Visual Studio inclui um utilitário vsregedit.exe que você pode usar para alterar as configurações do Visual Studio. Você pode desativar as notificações com o seguinte comando:

vsregedit.exe set "C:\Program Files\Microsoft Visual Studio\2022\Enterprise" HKCU ExtensionManager AutomaticallyCheckForUpdates2Override dword 0

Você pode ativar as notificações novamente com o seguinte comando:

vsregedit.exe set "C:\Program Files\Microsoft Visual Studio\2022\Enterprise" HKCU ExtensionManager AutomaticallyCheckForUpdates2Override dword 1

Para voltar ao comportamento padrão, você também pode excluir o valor com o seguinte comando:

vsregedit.exe remove "c:\Program Files\Microsoft Visual Studio\2022\Enterprise" HKCU ExtensionManager AutomaticallyCheckForUpdates2Override

Depois de executar o comando para alterar as configurações do Visual Studio, inicie o Visual Studio. Todas as instâncias já em execução do Visual Studio não alteram o comportamento até que o Visual Studio seja desligado e reiniciado. Como outra opção, você pode reiniciar o computador para garantir que a configuração entre em vigor.

Você pode confirmar a configuração com o seguinte comando:

vsregedit.exe read "c:\Program Files\Microsoft Visual Studio\2022\Enterprise" HKCU ExtensionManager AutomaticallyCheckForUpdates2Override dword

Se o valor não existir (condição padrão), o comando anterior indicará que ele falhou ao ler o valor. Se você definir o valor, o comando anterior refletirá o valor na configuração do Visual Studio (indica 0 ou 1 ou qualquer valor definido como – apenas 0 ou 1 são esperados).

(Substitua o diretório para corresponder à instância instalada que você deseja editar.)

Dica

Use vswhere.exe para localizar uma instância específica do Visual Studio em uma estação de trabalho do cliente.

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 problemas de produtos para nós usando a ferramenta Relatar um Problema que aparece no Instalador do Visual Studio como também 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.

Conteúdo relacionado

• Instalar o Visual Studio
• guia de administrador do Visual Studio
• Aplicando atualizações de administrador
• Desabilitar ou mover o cache do pacote
• Usar parâmetros de linha de comando para instalar o Visual Studio