创建和维护 Visual Studio 的网络安装
📣我们很乐意听到你的反馈!请花点时间完成此 调查,并告诉我们如何改进布局体验。感谢你的支持!
有时,企业管理员想要创建专用安装缓存(也称为“布局”),其中包含可以 部署到组织内客户端计算机的 Visual Studio 文件。
在以下情况下,创建布局非常有用:
- 用户的权限有限
- 客户端计算机对 Internet 的访问权限有限
- 组织希望对开发人员工具集的特定版本进行标准化
我们设计了 Visual Studio,以便管理员可以创建和维护布局并将其存储在内部网络共享上,并可以选择将其存储在组织的 Intranet 上。 Visual Studio 文件的布局是初始客户端安装和后续更新所需的所有文件的源位置。
此页上的信息分为三个主要部分:
- 创建布局:介绍如何使用正确的产品内容创建布局、配置默认设置、将其存储在网络文件共享上,以及使其在 Intranet 上可用。
- 维护布局:有关如何最好地更新布局的产品版本的信息,或修改布局的产品内容、通道设置、安装程序版本和文件夹大小。
- 帮助和支持:在何处寻求帮助
创建布局
准备网络文件共享存储位置
首先,需要确定要将下载的 Visual Studio 包存储在何处。 如果在企业中使用了多个版本的 Visual Studio(例如 Visual Studio 2022 Professional 和 Visual Studio 2022 Enterprise),则必须为每个版本创建单独的布局。 为每个版本创建单独的布局可能会占用大量磁盘空间,尤其是在你认为布局更新也会占用磁盘空间时。
布局路径必须少于 80 个字符;某些组织成功使用 符号链接 来解决 80 个字符的限制。
下载 Visual Studio 引导程序以创建布局
下载所需的 Visual Studio 版本的正确引导程序,并将其复制到要用作布局存储库的目录中。 创建布局后,即可使用它将 Visual Studio 安装到任何客户端计算机上。 引导程序是用于创建、更新和执行其他布局操作的可执行文件。 必须具有 Internet 连接和管理员权限才能完成此步骤。
无论何时运行,以下引导程序始终安装最新的最安全版本的 Visual Studio 2019。 或者,如果您想为特定版本的 Visual Studio 2019 创建或更新布局,请访问 Visual Studio 2019 版本发布 页面,该页面包含每个服务版本的专用引导程序链接,并下载所需的版本。 将其复制到要用作布局的源位置的目录中。
版本 | 引导程序 |
---|---|
Visual Studio 2019 Enterprise 版本 16.11 | vs_enterprise.exe |
Visual Studio 2019 Professional 版本 16.11 | vs_professional.exe |
Visual Studio 2019 生成工具版本 16.11 | vs_buildtools.exe |
其他受支持的引导程序包括 vs_teamexplorer.exe、vs_testagent.exe和 vs_testcontroller.exe。
无论何时运行以下引导程序,它们都会始终在当前通道上安装最新且最安全的 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 中,打开文件资源管理器,右键单击引导程序文件,选择 属性,选择 详细信息 选项卡,然后查看 产品版本 编号。 若要将该数字与 Visual Studio 的发布相匹配,请参阅 Visual Studio 2019 版本 页底部的表。
提示
如果之前下载了引导程序文件,并想要验证它将安装的版本,请执行以下操作。 在 Windows 中,打开文件资源管理器,右键单击引导程序文件,选择 属性,然后选择 详细信息 选项卡。产品版本 字段描述了引导程序将安装 通道和版本。 版本号应始终读取为“指定内容的最新服务版本”,除非明确指定,否则该通道假定为“当前”。 因此,产品版本为 LTSC 17.0 的引导程序会安装 17.0 LTSC 频道上提供的最新 17.0.x 服务版本。 产品版本显示“Visual Studio 2022”的引导程序会在当前频道上安装最新服务版本的 Visual Studio 2022。
下载 Visual Studio 包
必须建立 Internet 连接才能完成此步骤。
打开提升权限的命令提示符,导航到下载引导程序的目录,然后按照在“使用命令行参数安装 Visual Studio”页面中定义的引导程序参数来创建和维护您的网络布局。 以下示例说明了创建初始布局的常见方法。 在 Visual Studio 安装 页面的 命令行参数示例中,可以找到更多示例。
单个语言区域设置的完整初始布局需要 Visual Studio Community 的磁盘空间约 40 GB,Visual Studio Enterprise 的磁盘空间约为 50 GB。 额外的每个语言区域设置需要大约 0.5 GB 的磁盘空间。
建议的方法是创建包含所有工作负载和适当语言的初始 Visual Studio 布局,并将包存储在网络服务器上的布局目录中。 这样,任何客户端安装都有权访问整个 Visual Studio 产品/服务以及安装任何子集的功能。 若要创建 Visual Studio 的完整布局,请从计划托管网络布局的目录中运行以下命令:
vs_enterprise.exe --layout c:\VSLayout
请确保您的布局建立在正确的通道基础上
请务必确保网络布局基于正确渠道,因为它是管理员更新的条件之一,如果将其部署在整个组织中,请用于确定应更新的客户端实例。 例如,如果布局基于 VisualStudio.17.Release.LTSC.17.0 通道,并且客户端配置为接收来自Microsoft托管服务器的更新,则 17.0 LTSC 通道上提供的任何安全更新都可供安装或从该布局更新的客户端使用。
上面列出的引导程序基于当前通道。 若要基于其中一个 LTSC 通道创建布局,请从 Visual Studio 2022 发布历史记录 页获取正确的通道引导程序,将其复制到布局文件夹中,并使用它来创建或更新布局。
配置布局的内容
可以使用多种选项自定义网络布局的内容。 可以创建一个部分布局,该布局仅包含一组特定的 语言区域设置、工作负载、组件及其推荐或可选依赖项。 如果知道只将一部分工作负荷部署到客户端工作站,则部分布局非常有用。 用于自定义布局的典型命令行参数包括:
--add
:用于指定工作负载或组件 ID。
如果使用--add
,则仅下载由--add
指定的工作负载和组件。 如果不使用--add
,将下载所有工作负载和组件。--includeRecommended
,用于添加针对指定工作负载 ID 的所有推荐组件。--includeOptional
,用于添加针对指定工作负载 ID 的所有可选组件。--config
使用*.vsconfig
文件来指定 工作负载、组件或扩展,这些工作负载、组件或扩展应包含在布局中或由布局引用。 请确保指定配置文件的完整路径。--lang
:用于指定语言区域设置。
下面是有关如何创建自定义网络布局的几个示例。
若要仅使用一种语言为所有工作负载创建具有所需组件的布局,请运行:
vs_enterprise.exe --layout C:\VSLayout --lang en-US
若要为多种语言的所有工作负荷创建具有所需组件的布局,请运行:
vs_enterprise.exe --layout C:\VSLayout --lang en-US de-DE ja-JP
若要创建一个布局,其中包含一个工作负载以及所有语言中该工作负载的所有必需和建议组件,请运行:
vs_enterprise.exe --layout C:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --includeRecommended
若要使用三种语言创建包含两个工作负载和一个可选组件的布局,请运行:
vs_enterprise.exe --layout C:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Microsoft.VisualStudio.Component.Git --lang en-US de-DE ja-JP
使用配置文件初始化布局的内容
可以使用 --config
参数传入 *.vsconfig
文件。 请确保指定配置文件的完整路径。 在布局创建过程中使用 *.vsconfig
文件可自定义网络布局的内容,并将网络布局的内容限制为配置文件中指定的内容。 配置文件将复制到布局目录中,并重命名为 layout.vsconfig
。
*.vsconfig
文件中指定的任何扩展不会直接复制到布局中。 相反,布局的 response.json
文件包含对新创建的 layout.vsconfig
文件的引用,从而定义客户端扩展的安装位置。 如果要安装未进行数字签名的扩展,请确保编辑 response.json
以添加 "allowUnsignedExtensions": true
。 请参阅 response.json
内容示例。
vs_enterprise.exe --layout "C:\VSLayout" --config "C:\myconfig.vsconfig"
将布局复制到网络共享
需要在网络共享上存放布局,这样才能被客户端计算机访问。 如果在本地计算机上创建了布局,则需要将其复制到网络文件位置。 以下示例使用 xcopy
。 如果愿意,也可以使用 robocopy
。 例:
xcopy /e c:\VSLayout \\server\share\layoutdirectory
为此布局配置初始客户端安装默认值
将在布局的根文件夹中创建名为 response.json
的文件。 当客户端最初从布局安装时,此可自定义文件提供在客户端上配置的初始默认设置。 常见的配置选项包括配置:
- 默认情况下,应在客户端上安装哪些工作负荷、组件或语言
- 是否还应该安装建议的组件
- 客户端是否应遵循安装
*.vsconfig
文件 - 客户端应从何处接收更新
- 如果在更新期间应删除不受支持的组件
- 是否允许通过编程方式静默加载未签名扩展
有关详细信息,请参阅通过响应文件自动执行 Visual Studio 安装页。
使布局可通过 Intranet 站点访问
从 2023 年 6 月开始,你可以在内部 Intranet 网站上提供布局,从而利用 Web 服务器文件缓存和异地复制性能功能。 若要使用此新功能,需要使用最新的 Visual Studio 引导程序以及最新的 Visual Studio 安装程序。 IT 管理员必须执行以下操作才能利用此 Intranet Web 托管功能:
首先,创建和维护网络布局,并确保位在网络共享上存在并定期更新。 此外,如果希望客户端从 Intranet 布局位置获取其更新,请记得在布局 response.json中配置 channelUri 值。
接下来,管理员需要准备内部网站并将网站的源绑定到布局的网络文件位置。 它们还需要确保 Web 服务器遵循以下 MIME 类型:
文件扩展名 MIME 类型 .cab application/vnd.ms-cab-compressed
.exe application/octet-stream
.json application/json
.msi application/octet-stream
.msu application/octet-stream
.nupkg application/octet-stream
.opc application/octet-stream
.ps1 application/postscript
.vsix application/octet-stream
.xml text/xml
.zip application/x-zip-compressed
最后,若要在客户端上部署此布局,在客户端上运行 PowerShell 脚本以执行初始安装。 在 Visual Studio 从 Web 托管布局成功安装到客户端后,可以通过标准方法更新 Web 托管布局的客户端更新。
确保布局使用最新安装程序
备注
自 2023 年 6 月起,最新的安装程序默认随所有受支持的 Visual Studio 2017、Visual Studio 2019 和 Visual Studio 2022 的更新一起提供。 因此,如果使用其中一个产品版本,则无需显式执行任何操作即可获取具有最新功能和 bug 修复的安装程序的最新版本。
如果使用的是 2023 年 6 月之前发布的 Visual Studio 版本,建议始终在布局中使用最新的 Visual Studio 安装程序并将其分发到客户端。 例如,如果在 Visual Studio 2019 布局中分发 Visual Studio 2022 安装程序,则基于该布局的 Visual Studio 2019 客户端能够更改更新的源位置或轻松删除不支持的组件。 后续各节会介绍进一步的详细信息。
通过编程方式确保你使用的是最新安装程序的功能仅适用于最初交付 Visual Studio 2022 之后生成的 Visual Studio 2019 引导程序。 因此,以下示例中的 vs_enterprise.exe 必须是在 2021 年 11 月 10 日 之后发布 的版本。
若要创建整个产品的布局,并使用最新和最佳的安装程序,请运行
vs_enterprise.exe --layout C:\VSLayout --useLatestInstaller
维护布局
最佳做法是定期将 Visual Studio 布局更新到产品的最新安全版本。 这可确保布局既可用作安装点,又可用作客户端安装的更新源。 以下部分介绍最常见的或有用的布局维护操作。
如果在网络文件共享上托管布局,可能需要将更新的布局下载到专用本地共享(例如 c:\VSLayoutUpdate),然后在下载所有更新的内容后,将其复制到布局网络文件共享(例如\server\products\VS)。 如果不这样做,在您更新布局时碰巧运行安装程序的用户可能会因为布局尚未完全更新而遇到内容不匹配的问题。
将布局更新为产品的最新版本
Microsoft经常发布产品的更新版本来修复功能或安全问题。 我们强烈建议您保持您的布局与产品的最新版本同步更新,以确保您的客户始终能使用最新且最安全的产品版本。 如果客户端无法访问 Internet 并且只能从布局接收产品更新,则这一点非常重要。 Visual Studio 通常会在每月的第二个星期二(称为“补丁星期二”)发布安全更新,因此一个好的策略是,在补丁星期二下午更新所有需要更新的内容。
创建初始布局时,指定的选项(如要包含在布局中的工作负载和语言)保存在布局的配置文件中 layout.json
。 稍后,将该布局更新为较新版本的产品时,无需在布局中重新指定所需的产品组件。 布局更新只会将布局中的现有组件更新为其最新版本。
假设你已经使用上表中的其中一款长期有效引导程序创建了这一部分布局。
vs_enterprise.exe --layout c:\VSLayout --add Microsoft.VisualStudio.Workload.ManagedDesktop --lang en-US
要将托管在 Microsoft 服务器上的布局更新为 Microsoft 提供的产品的最新版本是很容易的。 只需在布局中使用现有的长期有效引导程序,然后在提升的提示符中运行 --layout
命令即可将最新的包下载到布局中,如下所示:
vs_enterprise.exe --layout c:\VSLayout
还可以通过无人参与方式将布局更新为更新的版本。 布局操作在新控制台窗口中运行安装过程。 该窗口处于打开状态,以便管理员可以查看最终布局更新结果和可能发生的任何错误的摘要。 如果要以无人参与的方式执行布局更新操作(例如,有一个脚本定期运行以将布局更新为最新版本),请使用 --passive
参数,该过程将自动关闭窗口。
vs_enterprise.exe --layout c:\VSLayout --passive
将布局更新为产品的特定版本
有时,你可能要将布局更新为产品的特定版本。 例如,你可能想要使布局与你已标准化组织的服务基线的最新安全版本相匹配。 下面介绍如何执行此操作:
可以转到 Visual Studio 2019 Releases 页面并下载特定的固定版本引导程序,将其复制到布局中,并使用它将布局更新到引导程序中指定的确切版本。 使用与上述完全相同的语法。
可以使用管理员更新将布局更新到产品的特定版本。 要获取管理员更新,请转到 Microsoft 更新目录并搜索要将布局更新到的更新版本。 将 update.exe
下载到托管布局的计算机,打开提升的命令提示符,然后运行如下命令:
visualstudioupdate-16.0.0to16.11.23.exe layout --layoutPath c:\VSLayout
请注意,管理员更新不会启动新布局的创建;它仅更新现有布局。 需要使用引导程序来创建初始布局。
可以转到 Visual Studio 2022 发布历史记录 页并下载特定的固定版本引导程序,将其复制到布局中,并使用它将布局更新到引导程序中指定的确切版本。 你将使用与上面完全相同的语法。
可以使用管理员更新将布局更新到产品的特定版本。 要获取管理员更新,请转到 Microsoft 更新目录,搜索要将布局更新到的更新。 将 update.exe
下载到托管布局的计算机,在该计算机上打开提升的命令提示符并运行如下所示的命令:
visualstudioupdate-17.0.0to17.4.4.exe layout --layoutPath c:\VSLayout
请注意,管理员更新不会启动新布局的创建;它只会更新现有布局。 需要使用引导程序来创建初始布局。
确保网络布局基于受支持的版本
有时,当通道从支持外转换时,需要确保网络布局继续基于受支持的通道,以便客户端可以继续接收安全更新通知。 如果你的布局基于 VisualStudio.17.Release.LTSC.17.0 通道,那么一旦 2023 年 7 月 17.0 LTSC 通道不再受支持,我们不会再为其发布安全更新,你的布局和客户端将变得不安全。 可在此处找到各种 Visual Studio 2022 通道的支持日期。
若要更改布局所基于的通道,请从 Visual Studio 2022 发布历史记录 页获取所需通道的引导程序,将其复制到布局文件夹中,并执行正常更新。 然后,应适当地通知客户端更新,以便它们也能保持安全。
修改布局的内容
可以修改部分布局,添加 其他工作负载、组件或语言。 无法可靠地从布局中删除组件。
在下面的示例中,我们将将 Azure 工作负载和本地化语言添加到以前仅使用托管桌面工作负载和英语创建的布局。 进行修改后,托管桌面和 Azure 工作负载以及英语和德语资源都将包含在此布局中。 除了添加组件之外,--layout
命令还会导致布局更新为引导程序指定的版本。 因此,如果使用长期有效引导程序,则生成的布局将具有新组件、新语言,并且所有布局内容都将更新到引导程序通道上的最新版本。
vs_enterprise.exe --layout c:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --lang de-DE
如果要修改现有部分布局,使其成为完整布局,请使用 --all 选项,如以下示例所示。 同样,此命令将导致布局内容更新到引导程序指定的版本。
vs_enterprise.exe --layout c:\VSLayout --all
可以通过传入包含布局中所需附加组件的 *.vsconfig
文件,将组件添加到布局中。 如果执行此操作,新的 *.vsconfig
内容将覆盖现有的 layout.vsconfig
内容。 有关详细信息,请参阅上一部分 使用配置文件初始化布局的内容。
vs_enterprise.exe --layout C:\VSLayout --config "C:\myupdatedconfig.vsconfig"
最后,可以直接编辑布局文件夹中的 layout.json
配置文件,并更新此文件的“添加”部分,以包括布局中包含的其他组件。 然后,需要使用前面所述的 --layout
来更新布局,以便下载最新组件。
备注
将新添加的布局组件安装到客户端计算机的最简单方法是从客户端计算机在布局中运行引导程序。 布局中 response.json
文件的“add”部分将确定在客户端的安装程序 UI 中默认选择哪些组件。 如果已使用上述方法之一修改布局,可能需要手动仔细检查,并可能调整 response.json
文件中的“add”部分,使其更恰当地匹配新修改 layout.json
文件的“add”部分中的内容。
配置布局以删除客户端计算机上不支持的组件。
某些企业希望利用 Visual Studio 2022 版本 17.4 中引入的功能,该功能会删除已过渡到支持不足状态的组件。 如果您正在管理布局,并且您的客户端正在接收管理员更新,那么设置起来相对容易。 首先,您需要配置布局以包含 最新版本的安装程序,如以下所述。 其次,需要将行 "removeOos": true
添加到 response.json
文件中。 如果布局正确设置了这两个详细信息,则后续管理员更新将遵循此设置,并将从客户端计算机中删除支持外组件。
验证布局
使用 --verify
对网络布局进行验证,以检查包文件是否缺失或无效。 在验证结束时,它会打印缺失的文件和无效文件的列表。
验证仅适用于 Visual Studio 特定小版本的最新版本。 新版本发布后,验证不适用于包含以前版本的布局。
vs_enterprise.exe --layout <layoutDir> --verify
备注
--verify
选项所需的一些重要元数据文件必须位于布局文件夹中。 如果缺少这些元数据文件,“--verify”无法运行,安装程序会显示错误。 如果遇到此错误,请尝试再次更新布局,或在其他文件夹中重新创建新的网络布局。
请记住,Microsoft定期更新 Visual Studio,因此,如果使用 常绿引导程序,则较新的布局可能不包含与初始布局相同的版本。 但是,如果使用 固定链接引导程序,则(几乎)总是会获取到一个确定性文件集。
修复布局
使用 --fix
执行与 --verify
相同的验证,并尝试修复已识别的问题。 --fix
进程需要 Internet 连接,因此在调用 --fix
之前,请确保计算机已连接到 Internet。
vs_enterprise.exe --layout <layoutDir> --fix
从布局中删除旧版本
对网络缓存执行布局更新后,布局文件夹可能有一些已过时的包,这些包不再需要最新的 Visual Studio 安装。 可以使用 --clean
选项从网络布局文件夹中删除过时的包。
要执行此操作,需要前往目录清单的文件路径,其中包含这些已过时的包。 可以在网络布局缓存的“存档”文件夹中找到目录清单。 当您更新布局时,它们会被保存在那里。 在“存档”文件夹中,有一个或多个“GUID”命名文件夹,每个文件夹都包含过时的目录清单。 “GUID”文件夹的数量应与对布局进行的更新数相同。
每个“GUID”文件夹中保存一些文件。 最感兴趣的两个文件是“catalog.json”文件和“version.txt”文件。 “catalog.json”文件是需要传递到 --clean
选项的过时目录清单。 另一个 version.txt 文件包含此过时目录清单的版本。 根据版本号,可以决定是否要从此目录清单中删除过时的包。 你可以在浏览其他“GUID”文件夹时执行相同的操作。 在决定要清理的目录后,通过提供这些目录的文件路径来运行 --clean
命令。
下面是如何使用 --clean 选项的示例:
c:\VSLayout\vs_enterprise.exe --layout c:\VSLayout --clean c:\VSLayout\Archive\1cd70189-fc55-4583-8ad8-a2711e928325\Catalog.json --clean c:\VSLayout\Archive\d420889f-6aad-4ba4-99e4-ed7833795a10\Catalog.json
执行此命令时,安装程序会分析网络布局文件夹,以查找要删除的文件列表。 然后,你将有机会查看要删除的文件,并确认删除。
将布局配置为始终包含并提供最新的安装程序
备注
自 2023 年 6 月起,最新安装程序默认随受支持的 Visual Studio 2017、Visual Studio 2019 和 Visual Studio 2022 的每次更新一起提供。 因此,您无需显式执行任何操作,即可在您的布局和客户端上部署最新版的安装程序,从而获得最新的功能和错误修复。
但是,如果您使用的是 2023 年 6 月之前创建的布局,那么您可以将布局显式配置为 始终 包含最新的安装程序并提供给客户,即使该安装程序被视为 Visual Studio 更新版本的一部分。 因此,当客户端从此布局更新时,客户端将获取此布局包含和提供的最新安装程序。 好处是,在客户端上安装最新安装程序后,客户端安装将能够利用我们继续添加到安装程序中的 bug 修复和新功能。
提示
如果要 更改客户端的 Visual Studio 2019 安装查找更新的位置,或者如果要删除所有不支持的组件,则 必须在客户端计算机上 获取最新的 Visual Studio 2022 安装程序。 执行此操作的一种方法是使用下面所述的参数在 Visual Studio 2019 布局中包含 Visual Studio 2022 安装程序。 使用最新安装程序的功能仅适用于最初在 Visual Studio 2022 发布后生成的 Visual Studio 2019 引导程序。 因此,以下示例中的 vs_enterprise.exe 必须是在 2021 年 11 月 10 日 之后发布 的版本。
可通过多种方式让布局包含并提供最新的安装程序:
可以使用在 2023 年 6 月或之后生成的 Visual Studio 版本。
创建或更新布局时,可以将
--useLatestInstaller
参数传递给引导程序。 这将导致在layout.json
文件中设置一项配置,该文件位于布局的根目录中。 下面是有关如何更新布局并将其配置为使用最新和最出色的安装程序的示例。vs_enterprise.exe --layout C:\VSLayout --useLatestInstaller
可以直接编辑
layout.json
文件以添加此设置。{ "installChannelUri": ".\\ChannelManifest.json", "channelUri": "\\\\server\\share\\layoutdirectory\\ChannelManifest.json", "installCatalogUri": ".\\Catalog.json", "channelId": "VisualStudio.16.Release", "productId": "Microsoft.VisualStudio.Product.Enterprise", "useLatestInstaller": true, "removeOos": true }
无法以编程方式在 layout.json
文件中删除此设置,因此,如果希望布局停止使用 Microsoft 提供的最新安装程序,并改为使用与引导程序(很可能比最新安装程序版本旧)对应的安装程序版本,则编辑 layout.json
文件并删除 "UseLatestInstaller": true
设置即可。
请注意,在布局的 response.json
文件中也可能会发现此 "UseLatestInstaller": true
设置,但出于确保布局始终具有最新安装程序的目的,将忽略该设置。 当客户端从布局 安装或更新时,response.json 文件用于在 客户端 上设置默认配置选项。 layout.json
文件中的此特定 "useLatestInstaller": true
设置用于确保 布局的内容 包含最新的安装程序,以便客户端计算机随后可以从布局中获取最新安装程序。
错误代码
如果使用 --wait
参数,则根据操作的结果,%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) |
出现故障情况 - 请检查日志以获取更多信息 |
获取对网络布局的支持
如果您遇到网络架构问题,请告诉我们。 告诉我们的最佳方法是使用 报告问题 工具,该工具会出现在 Visual Studio 安装程序和 Visual Studio IDE 中。 如果你是 IT 管理员且未安装 Visual Studio,则可以在此处提交 IT 管理员反馈。 使用此工具时,如果可以通过 Visual Studio Collect 工具发送日志, 这将非常有用,这有助于我们诊断和解决问题。
我们还为与安装相关的问题提供 安装聊天(仅限英语)支持选项。
我们还提供其他支持选项。 请参阅 Visual Studio 开发人员社区。