使用命令行参数安装、更新和管理 Visual Studio

以编程方式或从命令提示符安装 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 2022 Enterprise	vs_enterprise.exe
Visual Studio 2022 Professional	vs_professional.exe
Visual Studio 2022 Community	vs_community.exe
Visual Studio 2022 生成工具	vs_buildtools.exe

提示

如果之前下载了引导程序文件，并想要验证它将安装的版本，请执行以下操作。 在 Windows 中，打开文件资源管理器，右键单击引导程序文件，选择 属性，然后选择 详细信息 选项卡。产品版本 字段将描述引导程序将安装的 通道和版本。 版本号应始终被读取为“所指定的最新服务版本”，除非有明确指定，否则通道为当前版本。 因此，具有 LTSC 17.0 产品版本的引导程序将安装最新的 17.0.x 服务版本，该版本在 17.0 LTSC 通道上可用。 产品版本仅显示“Visual Studio 2022”的启动加载程序将在当前通道上安装最新版本的 Visual Studio 2022。

安装、更新、修改、修复、卸载和导出命令和命令行参数

调用 Visual Studio 引导程序或安装程序以编程方式安装产品或维护布局时：

• 第一个参数是描述要执行的操作的命令（谓词）。
• 后续的可选命令行参数（以两个短划线（--）为前缀，进一步定义该操作应该如何发生。

所有 Visual Studio 命令行参数都区分大小写，命令行参数示例 页上可以找到更多示例。

语法示例：vs_enterprise.exe [command] <optional parameters>...

命令	说明
（空白）	默认命令同时安装产品，并用于所有布局维护操作。
modify	修改已安装的产品。
update	更新已安装的产品。
updateall	按顺序更新所有已安装的产品。 使用 --quiet 和 --passive 参数。
repair	修复已安装的产品。
uninstall	卸载已安装的产品。
export	将安装配置导出到 *.vsconfig 文件中。

重要

指定多个不同的工作负荷、组件或语言时，必须针对每个项目分别重复 --add 或 --remove 命令行开关。

参数	说明
--installPath <dir>	对于默认安装命令，此参数 可选 并描述在客户端计算机上安装实例的位置。 对于其他命令，如 update 或 modify，此参数是必需的，用于指示实例在执行操作时使用的安装目录。
--productId <id>	可选：被修改并与 --channelId 结合使用的产品实例的 ID。 productID 类似于“Microsoft.VisualStudio.Product.Enterprise”。
--channelUri	可选：在执行更新命令期间，可以传递新的 --channelUri 来更改更新设置位置。 推荐与 --installPath 参数配对，以便明确您要配置的是哪个 Visual Studio 实例。 请参阅 --channelUri 的语法示例
--channelId <id>	通道的 ID，例如 VisualStudio.17.Release。 请参阅 --channelId 的语法示例。 channelId 是修改操作所必需的，与 --productID 或 --installPath 一起使用。
--add <one or more workload or component IDs>	可选：在安装或修改命令期间，此可重复参数指定要添加的一个或多个工作负荷或组件 ID。 将安装项目的所需组件，而不是建议组件或可选组件。 可以使用 --includeRecommended 和/或 --includeOptional 参数全局控制其他组件。 若要包含多个工作负荷或组件，请重复 --add 命令（例如，--add Workload1 --add Workload2）。 对于精细的控制，可以将 ;includeRecommended 或 ;includeOptional 追加到 ID（例如，--add Workload1;includeRecommended 或 --add Workload2;includeRecommended;includeOptional）。 有关详细信息，请参阅 工作负荷和组件 ID 页。
--all	可选：在安装或修改命令期间，此可选参数会使产品的所有工作负载和组件被安装。
--allWorkloads	可选：在安装或修改命令期间，此参数将安装所有工作负载和组件，但不建议或可选组件。
--includeRecommended	可选：在安装或修改命令期间，此参数包括安装的任何工作负荷的建议组件。 它不包括可选组件。 使用 --allWorkloads 或 --add指定工作负荷。 请注意，通过使用 --includeRecommended 参数，你将启用 更新设置 对话框，以“为更新时安装的工作负载添加建议组件”。 请参阅 自定义更新设置 以更改此设置。
--includeOptional	可选：在安装或修改命令期间，此参数包括安装的任何工作负荷的可选组件。 它不包括建议的组件。 使用 --allWorkloads 或 --add指定工作负荷。
--addProductLang <language-locale>	可选：在安装或修改命令期间，此可重复参数指定应随产品一起安装的 UI 语言包。 如果不存在，安装将使用与计算机区域设置对应的语言包。 有关详细信息，请参阅 [语言区域设置列表]
--remove <one or more workload or component IDs>	可选：在修改命令期间，此可重复参数指定要删除的一个或多个工作负荷或组件 ID。 该参数是 --add 参数的补充或与其行为相似。
本页上的 (#list-of-language-locales) 部分。
--removeProductLang <language-locale>	可选：在安装或修改命令期间，此可重复参数确定应从产品中删除的 UI 语言包。 它与 --addProductLang 参数互为补充，且功能相似。
--in <path>	可选：响应文件的 URI 或路径，该文件可以包含配置设置。
--quiet	可选：与任何命令一起使用，此参数可防止在执行命令时显示任何用户界面。 无论如何设置 allowStandardUserControl 策略，标准用户都无法以编程方式使用。
--passive, -p	可选：此参数使用户界面以非交互方式显示。 此参数与 --quiet 参数互斥（实际上替代）。 无论如何设置 AllowStandardUserControl 策略，标准用户都无法以编程方式使用。
--norestart	可选：此参数必须与 --passive 或 --quiet 参数配对。 在安装、更新或修改命令期间，添加 --norestart 参数会延迟任何必要的重新启动。
--force	可选：此参数会强制关闭 Visual Studio，即使有任何 Visual Studio 进程正在使用。 强制 Visual Studio 关闭可能会导致工作丢失，因此请谨慎使用。
--installWhileDownloading	可选：在安装、更新或修改命令期间，此参数允许 Visual Studio 并行下载和安装产品。 这是默认体验。
--downloadThenInstall	可选：在安装、更新或修改命令期间，此参数强制 Visual Studio 在安装之前下载所有文件。 它与 --installWhileDownloading 参数互斥。
--nickname <name>	可选：在安装命令期间，此参数定义分配给已安装产品的昵称。 昵称不能超过 10 个字符。
--productKey	可选：在安装命令期间，此参数定义用于已安装产品的产品密钥。 产品密钥由 25 个字母数字字符组成，格式为 xxxxxxxxxxxxxxxxxxxxxxxxx。
--removeOos true	可选：在安装、更新或修改命令期间，此参数后跟 true 或 false，告知 Visual Studio 安装程序是否删除转换到不支持状态的所有已安装组件。 此行为适用于单个事件。 如果要使此行为永久化，请将此参数应用于 modifySettings 命令（稍后介绍）或 配置 removeOOS 全局策略。 有助于保护机器安全，是非常有用的。
--config <path to *.vsconfig file>	可选：在安装或修改操作期间，可以使用 --config 参数传入配置文件，以根据以前保存的安装配置文件指定要添加的工作负荷、组件或扩展。 此操作仅累加;它不会删除文件中未指定的任何内容。 此外，不会添加不适用于产品的配置文件中指定的项。 强烈建议你指定配置文件的完全限定路径。 在导出操作期间，此参数确定保存安装配置文件的位置。
--allowUnsignedExtensions	可选：如果在安装或修改操作中，在 --passive 或 --quiet 上下文中使用 --config 文件运行，并且配置文件中指定了扩展，则为了加载没有数字签名的扩展，此参数是必需的。
--installerOnly	可选：在安装或更新操作期间，此参数告知 Visual Studio 安装程序仅安装本身（安装程序），而不是 Visual Studio 产品。 其功能等效于 --update 参数，但更直观。 用于准备和预配置客户端计算机。
--help, --?, -h, -?	显示此页面的脱机版本。

布局命令和命令行参数

所有布局管理操作（如创建或更新布局）都使用引导程序 exe 运行，并假定该命令是默认的安装（空白）。 所有布局管理操作都应以所需的 --layout 初始参数开头。 下表介绍了可用于 使用命令行创建或更新布局 的其他参数。

布局参数	说明
--layout <dir>	指定要创建或更新脱机安装缓存的目录。 有关详细信息，请参阅 创建基于网络的 Visual Studio安装。
--lang <one or more language-locales>	可选：与 --layout 一起使用，使用具有指定一个或多个指定语言的资源包准备脱机安装缓存。 有关详细信息，请参阅此页面上 语言区域设置列表 部分。
--add <one or more workload or component IDs>	可选：要添加的一个或多个工作负载或组件 ID。 将安装项目的所需组件，而不是建议组件或可选组件。 可以使用 --includeRecommended 和/或 --includeOptional全局控制更多组件。 对于精细的控制，可以将 ;includeRecommended 或 ;includeOptional 追加到 ID（例如，--add Workload1;includeRecommended 或 --add Workload2;includeOptional）。 有关详细信息，请参阅 工作负荷和组件 ID 页。 注意：如果使用 --add，则仅下载指定的工作负荷和组件及其依赖项。 如果未指定 --add，所有工作负载和组件都会下载到布局。
--includeRecommended	可选：包含所有已安装工作负载的推荐组件，但不包含可选组件。 使用 --allWorkloads 或 --add指定工作负荷。
--includeOptional	可选：包括建议的 和 可选部件，适用于布局中包含的任何工作负荷。 使用 --add指定工作负荷。
--wait	可选：该过程在返回退出代码之前等待安装完成。 在需要等待安装完成以处理来自该安装的返回代码的自动安装中，wait 非常有用。 --wait 参数只能传递到引导程序;安装程序（setup.exe）不支持它。 更新布局时非常有用。 可在此处查看其他示例。
--useLatestInstaller	可选：仅适用于早于 2023 年 4 月的 Visual Studio 启动加载程序的传统功能。 2023 年 4 月之后发货的任何内容默认使用最新的安装程序。 如果存在此参数，则 Visual Studio 安装程序的最新版本包含在布局中，即使它属于较新的主版本产品也是如此。 如果要利用最新版本中提供的新功能或 bug 修复，则最新的安装程序非常有用。 有关详细信息，请参阅 配置布局以始终使用最新的安装程序 文档。
--config <path to *.vsconfig file>	可选：如果存在，Visual Studio 将使用配置文件 内容来配置布局。 请确保指定配置文件的完全限定路径。
--noWeb	可选：如果存在，Visual Studio 安装程序将使用布局目录中的文件来安装 Visual Studio，并且不会从 Web 下载任何包。 如果用户尝试安装布局中没有的组件，安装程序将失败。 如果尝试部署在内部 Intranet 网站上托管的布局，请不要使用此参数。 有关详细信息，请参阅在无法访问 Internet 的客户端上安装。 重要：--noWeb 参数不会阻止连接 Internet 的客户端计算机上的 Visual Studio 安装程序在客户端配置为从 Microsoft 托管服务器获取更新时检查更新。 在这种情况下，--noWeb 只是阻止客户端下载产品包。
--verify	可选：验证布局的内容。 列出了任何损坏或缺失的文件。
--fix	可选：验证布局的内容。 如果任何文件已损坏或缺失，则会重新加载这些文件。 需要 Internet 访问才能修复布局。
--clean <one or more paths to catalogs>	可选：从更新到较新版本的布局中删除旧版本的组件。

高级布局参数	说明
--channelId <id>	可选：要安装的实例的通道 ID，例如，表示为 VisualStudio.17.Release。 如果指定了 --installPath，则 channelId 对于安装命令是必需参数，对于其他命令则可忽略。 请参阅 --channelId 的语法示例。
--channelUri <uri>	可选：通道清单的 URI。 此值可控制更新的源位置，初始值在布局的 response.json 文件中配置。 有关可能的值，请参阅 --channelUri 的 语法示例。 如果不需要更新，--channelUri 可以指向不存在的文件（例如 --channelUri C：\doesntExist.chman）。 此参数可用于 install 命令;其他命令将忽略它。
--installChannelUri <uri>	可选：用于安装的通道清单的 URI。 --channelUri 指定的 URI（指定 --installChannelUri 时必须指定）用于检测更新。 此参数可用于 install 命令;其他命令将忽略它。
--installCatalogUri <uri>	可选：要用于安装的目录清单的 URI。 如果有指定，该频道管理器会尝试先从此 URI 下载目录清单，然后再在安装频道清单中使用该 URI。 此参数用于支持脱机安装，其中使用已下载的产品目录创建布局缓存。 此参数可用于 install 命令;其他命令将忽略它。
--productId <id>	可选：已安装实例的产品 ID。 此参数在正常安装条件下预填充。 productID 类似于“Microsoft.VisualStudio.Product.Enterprise”。
--arch all	可选：默认情况下，仅使用 x64 产品二进制文件创建布局。 若要在布局中包含适用于适用于工作负载的 ARM 二进制文件以及 x64 二进制文件，请使用 --arch all 或 --arch * 参数。 若要仅创建 ARM 二进制文件布局，请使用 --arch arm64
--keepLayoutVersion	可选：将更改应用到布局中，而不更新布局中包含的产品版本。
--locale <language-locale>	可选：更改安装程序本身用户界面的显示语言。 将保留设置。 有关详细信息，请参阅此页面上 语言区域设置列表 部分。
--cache	可选：如果存在，安装后将保留这些包以供后续修复。 这会替代用于后续安装、修复或修改的全局策略设置。 默认策略是缓存包。 对于卸载命令，将忽略此情况。 有关详细信息，请了解如何禁用或移动包缓存。
--nocache	可选：如果存在，则安装或修复后将删除包。 只有在需要时才会再次下载，并在使用后再删除。 这会替代用于后续安装、修复或修改的全局策略设置。 默认策略是缓存包。 对于卸载命令，将忽略此情况。 有关详细信息，请了解如何禁用或移动包缓存。
--noUpdateInstaller	可选：如果存在，则阻止安装程序在指定静默时更新自身。 如果在需要更新安装程序时通过无提示安装指定 noUpdateInstaller，则安装程序将忽略该命令并返回非零退出代码。
--path <name>=<path>	可选：用于指定安装的自定义安装路径。 支持的路径名称是共享、缓存和安装。
--path cache=<path>	可选：使用指定的位置下载安装文件。 只能在安装 Visual Studio 时设置此位置。 示例：--path cache="C:\VS\cache"
--path shared=<path>	可选：包含用于并行安装 Visual Studio 的共享文件。 某些工具和 SDK 安装到此驱动器上的某个位置，而另一些工具和 SDK 可能会替代此设置并安装到另一个驱动器。 示例：--path shared="C:\VS\shared" 重要：只能在安装 Visual Studio 时设置一次。
--path install=<path>	可选：等效于 –-installPath。 具体而言，--installPath "C:\VS" 和 --path install="C:\VS" 是等效的。 一次只能使用其中一个命令。

ModifySettings 命令和命令行参数

可以在客户端计算机上使用安装程序或引导程序，通过传入 modifySettings 命令和所需的更新通道，以编程方式修改更新设置，并为 Visual Studio 的指定实例配置更新源位置。

命令	说明
modifySettings	用于修改 Visual Studio 特定实例更新设置的动词。

modifySettings 参数	说明
--installPath <dir>	建议 用于指定要对其执行操作的 Visual Studio 实例。
--newChannelUri	必需：通道清单的 URI。 此值指定下一个更新源位置。 有关可能的值，请参阅 --channelUri 的 语法示例。 如果不需要更新，--channelUri 可以指向不存在的文件（例如 --channelUri C：\doesntExist.chman）。
--channelUri	通道清单的 URI。 如果 --installPath 未知，可以使用。 必须与 productID 结合使用，以标识要执行操作的正确实例。
--productId <id>	如果指定了 --channelUri，则必须使用该参数，并用于标识要执行操作的正确实例。 productID 类似于“Microsoft.VisualStudio.Product.Enterprise”。
--includeRecommended	可选：在 modifySettings 命令期间，此参数（必须在该命令后立即包含 true 或 false 字）告知 Visual Studio 安装程序在“更新设置”对话框中禁用“为已安装的工作负载添加建议的组件”功能。
--quiet	可选：此参数可防止执行命令时显示任何用户界面。 标准用户无法以编程方式使用。
--removeOos true	可选：在执行 modifySettings 命令期间，此参数（后面必须紧跟 true 或 false）指示 Visual Studio 安装程序永久删除（或不删除）所有已转换为不支持状态的已安装组件。 有助于保持机器安全，很有用。

语法示例：

C:\>"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modifySettings --installPath "C:\Program Files\Microsoft\Visual Studio\2022\Enterprise" --newChannelUri https://aka.ms/vs/17/release.LTSC.17.0/channel --removeOos true

 C:\>"C:\Program Files\Microsoft\Visual Studio\2022\Enterprise\vs_enterprise.exe" modifySettings --channelUri https://aka.ms/vs/17/release.LTSC.17.0/channel --productID Microsoft.VisualStudio.Product.Enterprise --newChannelUri \\layoutserver\share\path\channelmanifest.json --removeOos true --quiet

回滚命令和命令行参数

从 Visual Studio 2022 开始，可以通过使用客户端计算机上的安装程序并将回滚命令与安装路径实例一起传入来实现以编程方式回滚更新。

命令	说明
rollback	命令用于将某个特定的 Visual Studio 实例回滚到先前安装的更新。 如果启用 DisableRollback，此命令将不起作用。

回滚参数	说明
--installPath <dir>	建议 用于指定要对其执行操作的 Visual Studio 实例。

语法示例：

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" rollback -–installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise"

管理员更新命令和命令行参数

可以从 Microsoft更新目录 下载 管理员更新，并使用它更新客户端安装或布局。

更新布局

如果要将布局更新到特定版本的 Visual Studio，只需将管理员更新下载到托管布局的计算机，在该计算机上打开命令提示符并运行以下命令，如下所示：

visualstudioupdate-17.0.0to17.1.5.exe layout --layoutPath c:\VSLayout

更新客户端

在客户端上，如果将管理员更新下载到客户端计算机上的安装目录中，只需双击该文件即可应用更新。 还可以打开命令窗口并传递下面的某些参数来更改默认行为。

在 SCCM 中配置管理员更新

如果要通过 Microsoft Endpoint Manager（SCCM）部署管理员更新，则可以使用以下参数修改包以调整行为。 还可以通过客户端计算机上的配置文件控制参数。 有关详细信息，请参阅用于配置管理员更新 的 方法

请注意，除非指定了布局谓词，否则所有管理员更新参数都默认在“更新”上下文中运行。

管理员更新参数	说明
--installerUpdateArgs [optional parameters]	此参数充当与管理员更新方案相关的特定参数的“直通数组”。 为此启用的可选参数包括： --quiet：这是管理员更新的默认体验，此处列出是为了完整性考虑。 --passive：此参数替代 --quiet 参数。 它会导致 UI 以非交互方式显示。 --norestart：此参数必须与 --quiet 或 --passive 结合使用，并导致任何必要的重新启动延迟。 --noWeb：此参数阻止 Visual Studio 在 Internet 上检查产品的更新。 --force：此参数强制 Visual Studio 关闭，即使 Visual Studio 正在使用。 请谨慎使用此参数，因为它可能会导致工作丢失。 仅当管理员更新在用户上下文中执行时，才能使用此参数;如果在系统上下文中执行管理员更新，则忽略该更新。 --installWhileDownloading：此参数允许 Visual Studio 并行下载和安装产品。 这是管理员更新的默认体验，在此处列出供完整性使用。 --keepWindowsUpdateOn：此参数阻止安装程序在客户端上关闭 Windows 更新代理。 如果要将管理员更新从目录导入 SCCM，则应使用此参数。 可能还需要将 SCCM 包的超时时间设置为超过默认的 10 分钟。 将 SCCM 部署类型更改为“必需”使得此参数不必要。 --downloadThenInstall：此参数强制 Visual Studio 在安装之前下载所有文件。 它与 --installWhileDownloading 参数互斥。
--checkPendingReboot	如果计算机上有待处理的重新启动，则更新将中止，无论哪个应用程序可能导致重新启动。 默认情况下，系统不检查是否有挂起的重启。

用于将参数传递到管理员更新的语法示例：

visualstudioupdate-16.9.0to16.9.4.exe --installerUpdateArgs=--force,--noWeb,--keepWindowsUpdateOn --checkPendingReboot

删除通道命令和命令行参数

可供从中更新的通道缓存在客户端上，随着时间的推移，它们可能会混乱。 可以手动删除更新通道，方法是打开 Visual Studio 安装程序，切换到“可用”选项卡，然后单击产品卡右上角的 X。 可以使用 removeChannel 命令以编程方式删除通道（例如较旧的布局位置）。 可以在客户端计算机上以编程方式运行 与where，以确定哪些通道缓存在客户端计算机上。

命令	说明
removeChannel	用于从客户端计算机中删除通道的命令。

removeChannel 参数	说明
--channelUri	必需：旧通道清单的 URI。
--quiet	可选 此参数可防止执行命令时显示任何用户界面。
--passive	可选 此参数替代 --quiet 参数。 它会导致 UI 以非交互方式显示。

语法示例：

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" removeChannel --channelUri "\\\\server\\share\\layoutdirectory\\ChannelManifest.json"

使用 winget 安装或修改 Visual Studio

可以使用 Windows 包管理器“winget”工具以编程方式在计算机上安装、修改或更新 Visual Studio 以及由 winget 管理的其他包。

默认情况下，winget 仅安装 Visual Studio 核心工作负载。

winget install --id Microsoft.VisualStudio.2022.Community

但是，如果要自定义安装并指定要在初始安装期间获取的其他工作负荷和组件，则可以使用 winget 的 --override 开关以及 winget 的 install 命令，并传入包含要添加的工作负载和组件的 导出的 vsconfig 文件：

winget install --id Microsoft.VisualStudio.2022.Community --override "--passive --config c:\my.vsconfig"

当然，还可以在初始安装过程中直接包括组件，如下所示：

 winget install --id Microsoft.VisualStudio.2022.Community --override "--quiet --add Microsoft.Visualstudio.Workload.Azure"

如果计算机上已安装 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 页。

语言区域设置列表

语言-区域设置	语言
Cs-cz	捷克语
De-de	德语
En-us	英语
Es-es	西班牙语
Fr-fr	法语
It-it	意大利语
Ja-jp	日语
Ko-kr	朝鲜语
Pl-pl	波兰语
Pt-br	葡萄牙语 - 巴西
Ru-ru	俄语
Tr-tr	土耳其语
Zh-cn	中文 - 简体
Zh-tw	中文 - 传统

错误代码

根据操作的结果，%ERRORLEVEL% 环境变量设置为以下值之一：

值	结果
0	操作成功完成
740	需要提升
1001	Visual Studio 安装程序进程正在运行
1003	Visual Studio 正在使用
1602	操作已取消
1618	另一个安装正在运行
1641	操作已成功完成，系统已重新启动
3010	操作成功完成，但安装需要重新启动才能使用
5003	Bootstrapper 无法下载安装程序
5004	操作已取消
5005	Bootstrapper 命令行分析错误
5007	操作被阻止 - 计算机不符合要求
8001	Arm 计算机检查失败
8002	后台下载预检查失败
8003	不支持可选择的失败
8004	目标目录失败
8005	验证源有效负载失败
8006	正在运行的 Visual Studio 进程
8010	操作系统不受支持。 请参阅 系统要求
-1073720687	连接失败
-1073741510	Microsoft Visual Studio 安装程序已终止（由用户或外部进程）
其他 （例如： -1、1、1603）	发生了故障，请查看日志，了解详细信息

每个操作都会在 %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