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

Você pode configurar certos aspetos do comportamento de implantação e atualização do Visual Studio por meio de políticas. Algumas dessas configurações são específicas para 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 na máquina cliente. Você pode configurar o seguinte:

• Os usuários sem permissões de administrador devem ter permissão para atualizar ou modificar o Visual Studio
• Os componentes não suportados devem ser removidos da máquina
• Onde alguns pacotes compartilhados com outras versões ou instâncias são instalados
• Onde e se os pacotes são armazenados em cache
• As atualizações do administrador devem ser ativadas e como 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 abrangentes para toda a organização usando o catálogo de configurações do Microsoft Intune ou importando Modelos Administrativos do Visual Studio (ADMX) para ferramentas legadas, como o editor de Diretiva de Grupo. Você também pode definir valores do Registro diretamente na máquina cliente. Os comportamentos de por instância geralmente são controlados usando as opções de linha de comando na máquina cliente.

Chaves de registo

Há vários locais no registro onde você pode definir essas políticas. O Visual Studio verifica sequencialmente, por esta 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 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 Visual Studio é baixado e instalado na máquina 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 precisar fornecer uma senha de administrador. Se definido como 2, os utilizadores sem permissões de administrador podem usar todas as funcionalidades no Visual Studio Installer manualmente, incluindo Modificar e Instalar na guia Disponível. Os utilizadores padrão não podem executar nenhum comando do Visual Studio Installer programaticamente com os parâmetros --passive ou --quiet, independentemente de como esta política está configurada. Esta política requer que a versão mais recente do instalador do Visual Studio 2022 seja instalada na máquina cliente.
CachePath	REG_SZ ou REG_EXPAND_SZ	%ProgramData% \Microsoft \VisualStudio \Pacotes	Manifesto do pacote e caminho do cache de carga útil: o Visual Studio Installer impõe um limite de 50 caracteres para o caminho desse diretório de cache de armazenamento. Para mais informações, consulte a página Desativar ou mover o cache do pacote.
KeepDownloadedPayloads	REG_DWORD	1	Manter os conteúdos do pacote após a instalação: a desativação da política remove todos os conteúdos do pacote em cache na instância que reparar ou modificar. Você pode alterar o valor a qualquer momento. Para obter mais informações, consulte a página Desativar ou mover a cache do pacote.
SharedInstallationPath	REG_SZ ou REG_EXPAND_SZ	%ProgramFiles(x86)% \Microsoft Visual Studio \Compartilhado	Caminho de instalação compartilhada: o diretório onde alguns pacotes compartilhados entre versões de instâncias do Visual Studio estão instalados. Você pode alterar o valor a qualquer momento, mas isso afetará apenas instalações futuras. 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	Desativar o download de atualizações automaticamente: se definido como 1, a instalação será impedida de baixar atualizações automaticamente para todos os produtos Visual Studio instalados. Você pode alterar o valor a qualquer momento.
RemoveOos	REG_DWORD	0	Remover componentes fora de suporte durante as atualizações: se definido como 1, o instalador do Visual Studio removerá todos os componentes instalados em transição para um estado fora de suporte durante todas as atualizações subsequentes. Se definido como 0 ou totalmente ausente, o comportamento removeOos respeita outros locais onde 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, consulte a postagem no blog sobre a remoção de componentes fora de suporte . Essa funcionalidade requer que o instalador do Visual Studio 2022 versão 17.4 seja instalado na máquina 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, que impede o Visual Studio de reverter a atualização mais recente, que pode conter uma correção de segurança. Se definido como 0 ou totalmente ausente, 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 obter mais informações, consulte a postagem do blog Rollback.
HideAvailableTab	REG_DWORD	0	Ocultar a guia Disponível do instalador: se definido como 1, os administradores podem ocultar a guia Disponível do instalador, o que pode impedir que os usuários dentro da organização instalem acidentalmente o produto errado.
DisableSound	REG_DWORD	0	Desativar sons nodo instalador: se definido como 1, os usuários poderão desabilitar os sons no Instalador do Visual Studio, o que impedirá qualquer sinal de áudio quando uma operação do instalador for concluída ou quando houver um erro. As operações do instalador incluem instalar, atualizar, modificar 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 podem reativar os sons no instalador. Para obter mais informações, consulte a postagem do blog DisableSound.

Importante

Se alterar a diretiva de registo CachePath após quaisquer instalações, deverá mover a cache de pacote existente para o novo local e certificar-se de que está protegido para 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.

Controlando atualizações do administrador

As configurações do Registro nesta seção controlam se e como as atualizações do administrador são aplicadas à máquina cliente.

Nome	Tipo	Padrão	Descrição
AdministratorUpdatesEnabled	REG_DWORD	0	Ativar atualizações de administrador: permite que as atualizações de administrador sejam aplicadas ao computador cliente. Se esse valor estiver ausente ou definido como 0, as atualizações do administrador serão bloqueadas. Um valor de 1 torna a máquina cliente disponível para atualizações implantadas por meio do canal WSUS/SCCM. O valor recomendado de 2 disponibiliza a máquina cliente para receber atualizações implantadas por meio do canal WSUS/SCCM ou do canal Windows Update for Business/Intune/Microsoft Endpoint Manager. Essa chave do Registro é para o usuário administrador. Para obter mais informações, consulte Habilitando atualizações do administrador.
AdministratorUpdatesNotifications	REG_DWORD	0	Permite que os administradores notifiquem os usuários para fechar 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 esta chave do Registro, o administrador pode causar uma notificação de aviso do Windows que solicita ao usuário para fechar o Visual Studio e salvar o seu trabalho, de modo a que a atualização pendente possa ser aplicada. Essa chave do Registro é para o usuário administrador. Para obter mais informações, consulte o anúncio da postagem do blog .
AdministratorUpdatesOptOut	REG_DWORD	0	Desativar 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. Esta política é para o usuário desenvolvedor configurar se ele tiver permissões de administrador na máquina 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 não participar. As duas partes podem então discutir quais são as necessidades mais importantes. Os administradores de TI sempre podem alterar qualquer uma das chaves sempre que quiserem.
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 as 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 à máquina 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

As máquinas cliente conectadas à nuvem geridas pelo Intune devem ser configuradas para Windows Update for Business e terem a opção de "Habilitar Atualizações para Outros Produtos da Microsoft" para receber atualizações de administrador do Visual Studio através do canal Windows Update for Business Microsoft Update.

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 os clientes em uma organização corporativa. Para obter informações sobre quais são as configurações de atualização e como elas funcionam, consulte a configurar o local de origem das atualizações a documentação. Esta funcionalidade requer que o cliente esteja a usar o Visual Studio 2022 Installer e que o layout utilize uma versão do bootstrapper de 2019 lançada em ou após 10 de novembro de 2021. Para obter orientação, consulte como obter o instalador do Visual Studio 2022 nas suas máquinas cliente através de um layout do Visual Studio 2019 na documentação.

As chaves nesta seção só se aplicam 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 personalizadas do canal de layout. O nome desta chave é considerado o nome do canal e é o que aparece no menu suspenso do canal Update. O valor ChannelURI deve estar presente sob a subchave Channels.
DisabledChannels	Key	Caminho da subchave para suprimir canais e impedir que eles 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 para adicionar à lista de valores de canal de atualização, adicionando na hive Channels, ou suprimir da lista de canais de atualização, adicionando na hive de registo 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.jsondo layout. Consulte exemplos.
Description	REG_SZ	Uma descrição personalizada de duas linhas do canal. Se você já instalou a partir de um layout, a interface do usuário de Configurações de Atualização assume como padrão "Canal Privado" e você pode alterá-la usando a Descrição.

Alguns exemplos de ficheiros de registo que ilustram como um administrador de TI poderá querer personalizar a interface do utilizador Configurações de Atualização:

O primeiro exemplo de registo pode ser usado numa situação em que o cliente tenha instalado anteriormente a partir de um layout de rede localizado em \\vslayoutserver3\vs\2019_Enterprise. Como mencionado anteriormente, o Visual Studio padroniza o nome do canal para esse layout como "Canal Privado". Veja como você personalizaria o nome e a descrição do canal para esse 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 para outros canais de atualização personalizados que estão disponíveis como fonte de atualizações e também como impedir que o canal de pré-visualização apareça.

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 a partir 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 desativar as notificações se não quiser que os usuários finais sejam notificados sobre atualizações. (Por exemplo, talvez você queira desativar 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 do Registro em umde registro privado, você não pode editar diretamente o registro da maneira típica. No entanto, 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 indica que ele não conseguiu ler o valor. Se você definir o valor, o comando anterior refletirá o valor na configuração do Visual Studio (ele indica 0 ou 1, ou qualquer valor definido como – apenas 0 ou 1 são esperados).

(Certifique-se de substituir 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 cliente.

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:

• Utilize a opção de suporte do chat de instalação (em inglês apenas) para problemas relacionados com a 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 .

Conteúdo relacionado

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