Compartilhar via


Ferramentas para detectar e gerenciar instâncias do Visual Studio

Existem várias ferramentas que você pode usar para detectar e gerenciar instalações do Visual Studio em computadores cliente.

Detectando instâncias existentes do Visual Studio

As seguintes ferramentas e utilitários ajudarão você a detectar e gerenciar instâncias instaladas do Visual Studio em computadores cliente:

  • vswhere: um executável integrado ao Visual Studio ou disponível para distribuição separada que ajuda a encontrar o local de todas as instâncias do Visual Studio em um computador específico.
  • VSSetup.PowerShell: scripts do PowerShell que usam a API de Configuração de Instalação para identificar instâncias instaladas do Visual Studio.
  • VS-Setup-Samples: amostras de C# e C++ que demonstram como usar a API de Configuração de Instalação para consultar uma instalação existente.
  • Instrumentação de Gerenciamento do Windows (WMI): as informações da instância do Visual Studio podem ser consultadas por meio da classe MSFT_VSInstance do Visual Studio.
  • A API de Configuração de Instalação fornece interfaces para desenvolvedores que desejam criar seus próprios utilitários para interrogar instâncias do Visual Studio.
  • Inventário de software do Microsoft Endpoint Configuration Manager: pode ser usado para coletar informações sobre instâncias do Visual Studio em dispositivos cliente.

Usar o vswhere.exe

vswhere.exe é incluído automaticamente no Visual Studio 2017 e posterior, ou você pode baixá-lo na páginas de versões do vswhere. Use o vswhere -? para obter informações de ajuda sobre a ferramenta. Por exemplo, este comando mostra todas as versões do Visual Studio, incluindo versões mais antigas do produto e pré-lançamentos e gera os resultados no formato JSON:

C:\Program Files (x86)\Microsoft Visual Studio\Installer>vswhere.exe -legacy -prerelease -format json

Usando WMI (Instrumentação de Gerenciamento do Windows)

Se o Utilitário Detector de Clientes do Visual Studio estiver instalado no computador, você poderá consultar informações da instância do Visual Studio usando o WMI. O Utilitário Detector de Clientes do Visual Studio é instalado por padrão com todas as atualizações do Visual Studio 2017, do Visual Studio 2019 e do Visual Studio 2022 lançadas em ou após 12 de maio de 2020. Ele também estará disponível no Catálogo do Microsoft Update se você quiser instalá-lo de forma independente. Para obter um exemplo de como usar o utilitário para retornar informações de instância do Visual Studio, abra o PowerShell como administrador no computador cliente e digite o seguinte comando:

Get-CimInstance MSFT_VSInstance -Namespace root/cimv2/vs

Usando o Microsoft Endpoint Configuration Manager

O inventário de software do Microsoft Endpoint Configuration Manager: pode ser usado para coletar informações sobre instâncias do Visual Studio em dispositivos cliente. Por exemplo, a consulta a seguir retornará o nome de exibição, a versão e o nome do dispositivo em que o Visual Studio está instalado para todas as instâncias instaladas do Visual Studio 2017, 2019 e 2022:

select distinct SMS_G_System_COMPUTER_SYSTEM.Name, SMS_G_System_ADD_REMOVE_PROGRAMS.DisplayName, SMS_G_System_ADD_REMOVE_PROGRAMS.Version from SMS_R_System inner join SMS_G_System_COMPUTER_SYSTEM on SMS_G_System_COMPUTER_SYSTEM.ResourceID = SMS_R_System.ResourceId inner join SMS_G_System_ADD_REMOVE_PROGRAMS on SMS_G_System_ADD_REMOVE_PROGRAMS.ResourceID = SMS_R_System.ResourceId where SMS_G_System_ADD_REMOVE_PROGRAMS.DisplayName like "Visual Studio %[a-z]% 201[7,9]" or SMS_G_System_ADD_REMOVE_PROGRAMS.DisplayName like "Visual Studio %[a-z]% 2022"

A edição do Registro para uma instância do Visual Studio

No Visual Studio, configurações do Registro são armazenadas em um local privado, o que permite várias instâncias lado a lado no mesmo computador com a mesma versão do Visual Studio.

Como essas entradas não são armazenadas no Registro global, há instruções especiais para usar o Editor do Registro para fazer alterações nas configurações do Registro:

  1. Se você tiver uma instância do Visual Studio aberta, feche-a.

  2. Inicie o regedit.exe.

  3. Selecione o nó HKEY_LOCAL_MACHINE.

  4. No menu principal do Regedit, selecione Arquivo>Carregar Hive... e selecione o arquivo de Registro privado, que é armazenado na pasta AppData\Local. Por exemplo:

    %localappdata%\Microsoft\VisualStudio\<config>\privateregistry.bin
    

    Observação

    <config> corresponde à instância do Visual Studio que você deseja procurar.

Você precisará fornecer um nome de hive, que se tornará o nome do hive isolado. Depois de fazer isso, você poderá pesquisar o Registro no hive isolado que criou.

Importante

Antes de iniciar o Visual Studio novamente, você deve descarregar a seção isolada que criou. Para fazer isso, selecione Arquivo>Descarregar Hive no menu principal do Regedit. (Se você não fizer isso, o arquivo permanecerá bloqueado e o Visual Studio não poderá ser iniciado.)

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: