用于检测和管理 Visual Studio 实例的工具

项目
2025-02-10

可以使用多种工具来检测和管理客户端计算机上的 Visual Studio 安装。

检测现有 Visual Studio 实例

以下工具和实用工具将帮助你检测和管理客户端计算机上安装的 Visual Studio 实例：

vswhere：一个内置于 Visual Studio 中的可执行文件，也可以单独分发，帮助你找到特定计算机上所有 Visual Studio 实例的位置。
VSSetup.PowerShell：使用安装程序配置 API 标识已安装的 Visual Studio 实例的 PowerShell 脚本。
VS-Setup-Samples：C# 和C++示例，演示如何使用安装程序配置 API 查询现有安装。
Windows Management Instrumentation （WMI）：可以通过 Visual Studio 类MSFT_VSInstance查询 Visual Studio 实例信息。
安装程序配置 API 为想要生成自己的实用工具来询问 Visual Studio 实例的开发人员提供接口。
Microsoft Endpoint Configuration Manager 软件清单：可用于收集有关客户端设备上的 Visual Studio 实例的信息。

使用 vswhere.exe

vswhere.exe 自动包含在 Visual Studio 2017 及更高版本中，也可以从 vswhere 发布页中下载。使用 vswhere -? 获取有关该工具的帮助信息。例如，此命令显示 Visual Studio 的所有版本，包括产品的早期版本和预发布，并输出 JSON 格式的结果：

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

使用 Windows 管理工具 (WMI)

如果计算机上安装 Visual Studio 客户端检测器实用工具，则可以使用 WMI 查询 Visual Studio 实例信息。默认情况下，Visual Studio 客户端检测器实用工具会与每个 Visual Studio 2017、Visual Studio 2019 和 Visual Studio 2022 的更新一起安装，这些更新是在 2020 年 5 月 12 日或之后发布的。如果要独立安装，还可以在 Microsoft更新目录中使用它。有关如何使用实用工具返回 Visual Studio 实例信息的示例，请以管理员身份在客户端计算机上打开 PowerShell，然后键入以下命令：

Get-CimInstance MSFT_VSInstance -Namespace root/cimv2/vs

使用 Microsoft Endpoint Configuration Manager

Microsoft Endpoint Configuration Manager 软件清单功能可用于查询和收集有关客户端设备上的 Visual Studio 实例的信息。例如，以下查询将返回所有已安装的 Visual Studio 2017、2019 和 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"

编辑 Visual Studio 实例的注册表

在 Visual Studio 中，注册表设置存储在专用位置，该位置允许在同一台电脑上并存相同版本的多个 Visual Studio 实例。

由于这些条目未存储在全局注册表中，因此使用注册表编辑器对注册表设置进行更改有特殊说明：

如果你有正在打开的 Visual Studio 实例，请将其关闭。
启动 regedit.exe。
选择 HKEY_LOCAL_MACHINE 节点。
在 Regedit 主菜单中，选择文件>加载 Hive...，然后选择存储在 AppData\Local 文件夹中的专用注册表文件。例如：
```
%localappdata%\Microsoft\VisualStudio\<config>\privateregistry.bin
```
备注

<config> 对应于要浏览的 Visual Studio 实例。

系统会提示你输入配置单元名称，这将成为你的独立配置单元的名称。执行此操作后，应该能够在所创建的独立配置单元下浏览注册表。

重要

必须先卸载已创建的独立配置单元，然后才能再次启动 Visual Studio。为此，请从 Regedit 主菜单中选择文件>卸载 Hive。（如果不执行此操作，该文件将保持锁定状态，Visual Studio 将无法启动。

支持或故障排除

有时，情况可能会出错。如果 Visual Studio 安装失败，请参阅排查 Visual Studio 安装和升级问题以获取分步指南。

下面是更多支持选项：

使用安装聊天（仅限英语）支持选项来解决与安装相关的问题。
使用报告问题工具向我们报告产品问题，该工具可在 Visual Studio 安装程序和 Visual Studio IDE 中使用。如果您是 IT 管理员且未安装 Visual Studio，您可以提交 IT 管理员反馈。
建议一项功能、跟踪产品问题，并在 Visual Studio 开发人员社区中查找答案。

Visual Studio 管理员指南

通过