使用命令行参数安装 Visual Studio
发布时间:2026-10-06 | 浏览:1
访问此页面需要授权。 可以尝试 登录 或 更改目录 。
访问此页面需要授权。 可以尝试 更改目录 。
以编程方式或从命令提示符安装 Visual Studio 时,可以使用各种命令行参数来控制或自定义安装以执行以下操作:
使用预选的某些选项和行为在客户端上启动安装。
创建或维护用于安装或更新客户端计算机的产品文件的网络布局。
以下命令行谓词和参数可用于以下可执行文件或程序:
安装程序引导程序,它是启动下载过程和初始安装的小型(约 1 MB)文件(例如,vs_enterprise.exe)。
可能已安装在计算机上且位于文件夹 C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe 的 Visual Studio 安装程序。 须从与安装程序所在目录 不同的 目录以编程方式启动安装程序。 安装程序通常用于更新或修改命令。
使用 winget 的 --override 开关时使用 winget 命令 。
使用管理员更新包(可从 Microsoft 更新目录 下载)以编程方式更新网络布局。 有关详细信息,请参阅 更新或修改布局 一文。
并非所有命令或参数都适用于每种情况,并且记录了任何特殊注意事项或异常。 此外,在某些情况下,你可能无法访问前面所述的所有这些可执行文件。 例如,如果通过布局安装 Visual Studio,则客户端计算机可能只有可用于执行编程的安装程序。
要获取始终安装最新当前频道版本的 Visual Studio 2022 的最新引导程序,请下载以下文件之一。 或者,若要安装特定版本或 Visual Studio 2022 的特定通道,请参阅 Visual Studio 2022 发布历史记录 页。 此页面具有指向每个维护版本的固定版本引导程序的链接。
要获取始终安装最新当前频道版本的 Visual Studio 2026 的最新引导程序,请下载以下文件之一。 或者,若要安装特定版本或 Visual Studio 2026 的特定通道,请参阅 Visual Studio 2026 发布历史记录 页。 此页面具有指向每个维护版本的固定版本引导程序的链接。
如果之前下载了引导程序文件,并想要验证它将安装的版本,请执行以下操作。 在 Windows 中,打开文件资源管理器,右键单击引导程序文件,选择 属性 ,然后选择 详细信息 选项卡。 产品版本 字段将描述引导程序将安装的 通道和版本 。 版本号应始终被读取为“所指定的最新服务版本”,除非有明确指定,否则通道为当前版本。 因此,具有 LTSC 17.0 产品版本的引导程序将安装最新的 17.0.x 服务版本,该版本在 17.0 LTSC 通道上可用。 产品版本仅显示“Visual Studio 2022”的引导程序将在当前频道上安装最新版本的 Visual Studio 2022。
如果之前下载了引导程序文件,并想要验证它将安装的版本,请执行以下操作。 在 Windows 中,打开文件资源管理器,右键单击引导程序文件,选择 属性 ,然后选择 详细信息 选项卡。 产品版本 字段将描述引导程序将安装的 通道和版本 。 版本号应始终被读取为“所指定的最新服务版本”,除非有明确指定,否则通道为当前版本。 因此,产品版本为 Stable 18.0 的引导程序将安装 18.0 稳定频道上可用的最新 18.0.x 维护版本。 产品版本仅标注为 Visual Studio 2026 的引导程序将安装稳定频道上的最新版 Visual Studio 2026。
安装、更新、修改、修复、卸载和导出命令和命令行参数
调用 Visual Studio 引导程序或安装程序以编程方式安装产品或维护布局时:
第一个参数是描述要执行的操作的命令(谓词)。
后续的可选命令行参数(以两个短划线(--)为前缀,进一步定义该操作应该如何发生。
所有 Visual Studio 命令行参数都区分大小写, 命令行参数示例 页上可以找到更多示例。
语法示例: vs_enterprise.exe [command] <optional parameters>...
指定多个不同的工作负荷、组件或语言时,必须针对每个项目分别重复 --add 或 --remove 命令行开关。
所有布局管理操作(如创建或更新布局)都使用引导程序 exe 运行,并假定该命令是默认的安装(空白)。 所有布局管理操作都应以所需的 --layout 初始参数开头。 下表介绍了可用于 使用命令行创建或更新布局 的其他参数。
ModifySettings 命令和命令行参数
可以在客户端计算机上使用安装程序或引导程序,通过传入 modifySettings 命令和所需的更新通道,以编程方式修改更新设置,并为 Visual Studio 的指定实例配置更新源位置。
从 Visual Studio 2022 开始,可以使用客户机上的安装程序,并将回滚命令与安装路径实例一起传入,从而以编程方式 回滚更新 。
可以从 Microsoft更新目录 下载 管理员更新 ,并使用它更新客户端安装或布局。
如果要将布局更新到特定版本的 Visual Studio,只需将管理员更新下载到托管布局的计算机,在该计算机上打开命令提示符并运行以下命令,如下所示:
在客户端上,如果将管理员更新下载到客户端计算机上的安装目录中,只需双击该文件即可应用更新。 还可以打开命令窗口并传递下面的某些参数来更改默认行为。
在 SCCM 中配置管理员更新
如果要通过 Microsoft Endpoint Manager(SCCM)部署管理员更新,则可以使用以下参数修改包以调整行为。 还可以通过客户端计算机上的配置文件控制参数。 有关详细信息,请参阅用于配置管理员更新 的 方法
请注意,除非指定了布局谓词,否则所有管理员更新参数都默认在“更新”上下文中运行。
用于将参数传递到管理员更新的语法示例:
如果遇到错误 87( The parameter is incorrect ),请验证 --installerUpdateArgs 该值是否带引号,以及该值内的开关是否以空格分隔。
可供从中更新的通道缓存在客户端上,随着时间的推移,它们可能会混乱。 可以手动删除 更新通道 ,方法是打开 Visual Studio 安装程序,切换到“可用”选项卡,然后单击产品卡右上角的 X 。 可以使用 removeChannel 命令以编程方式删除通道(例如较旧的布局位置)。 可以在客户端计算机上以编程方式运行 与where ,以确定哪些通道缓存在客户端计算机上。
使用 winget 安装或修改 Visual Studio
可以使用 Windows 包管理器 “winget”工具以编程方式在计算机上安装、修改或更新 Visual Studio 以及由 winget 管理的其他包。
默认情况下,winget 仅安装 Visual Studio 核心工作负载。
但是,如果要自定义安装并指定要在初始安装期间获取的其他工作负荷和组件,则可以使用 winget 的 --override 开关以及 winget 的 install 命令,并传入包含要添加的工作负载和组件的 导出的 vsconfig 文件 :
当然,还可以在初始安装过程中直接包括组件,如下所示:
默认情况下,winget 仅安装 Visual Studio 核心工作负载。
但是,如果要自定义安装并指定要在初始安装期间获取的其他工作负荷和组件,则可以使用 winget 的 --override 开关以及 winget 的 install 命令,并传入包含要添加的工作负载和组件的 导出的 vsconfig 文件 :
当然,还可以在初始安装过程中直接包括组件,如下所示:
如果计算机上已安装 Visual Studio,则可以使用 winget 的 configure 命令 以及 Visual Studio PowerShell DSC 提供程序 、yaml 文件和 .vsconfig 文件将组件 添加 到现有 Visual Studio 安装。 Winget 的 configure 命令实质上充当 Visual Studio 的“修改”操作。 请参阅 如何创作 WinGet 配置文件 了解如何创建 winget 配置。
不能将 --override 开关或 Visual Studio DSC 提供程序与 winget 的 upgrade 命令一起使用,因为 upgrade 本质上只是充当 Visual Studio 的“更新”操作并安装你选择的最新版本的组件。 无法通过更新/升级添加组件。 需要使用 winget 的 configure 来添加组件。
请注意,Visual Studio 安装程序操作当前需要管理员权限,因此 winget 将提示你根据需要提升权限以完成命令。 此外,目前无法使用 winget 在客户端计算机上安装多个版本(即不同 SKU)或同一 SKU 的多个实例。 最后,如果要配置(修改)Visual Studio 以添加组件或将其升级到最新版本,则必须关闭 Visual Studio。
工作负荷 ID 和组件 ID 的列表
有关按 Visual Studio 产品排序的工作负荷和组件 ID 的列表,请参阅 Visual Studio 工作负载和组件 ID 页。
根据操作的结果, %ERRORLEVEL% 环境变量设置为以下值之一:
每个操作都会在 %TEMP% 目录中生成多个日志文件,这些日志文件指示安装进度。 按日期对文件夹进行排序,并分别查找引导程序、安装程序应用和安装引擎以 dd_bootstrapper 、 dd_client 和 dd_setup 开头的文件。
有时,情况可能会出错。 如果 Visual Studio 安装失败,请参阅 排查 Visual Studio 安装和升级问题 以获取分步指南。
使用 安装聊天 (仅限英语)支持选项来解决与安装相关的问题。
使用 报告问题 工具向我们报告产品问题,该工具可以在 Visual Studio 安装程序和 Visual Studio IDE 中找到。 如果你是 IT 管理员且未安装 Visual Studio,则可以提交 IT 管理员反馈 。
建议一项功能、跟踪产品问题,并在 Visual Studio 开发人员社区 中查找答案。
用于 Visual Studio 安装的命令行参数示例
创建 Visual Studio 的脱机安装
使用响应文件自动化 Visual Studio 安装
Visual Studio 工作负荷和组件 ID
想要尝试使用 Ask Learn 阐明或指导你完成本主题?
上次更新时间为 2025-12-12