创建和维护 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 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 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 托管功能：

1. 首先，创建和维护网络布局，并确保位在网络共享上存在并定期更新。 此外，如果你希望客户端从 Intranet 布局位置获取更新，请记住在布局的 response.json 中配置 channelUri 值。

2. 接下来，管理员需要准备一个内部网站，并将网站的源绑定到布局的网络文件位置。 他们还需要确保 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

3. 最后，若要在客户端上部署此布局，请在客户端上运行 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 2022 版本历史记录页并下载特定的固定版本引导程序，将其复制到布局中，并使用它将布局更新到引导程序中指定的确切版本。 你将使用与上面完全相同的语法。

可以使用管理员更新将布局更新到产品的特定版本。 要获取管理员更新，请转到 Microsoft Update 目录，搜索要将布局更新到的更新。 将 update.exe 下载到托管布局的计算机，在该计算机上打开提升的命令提示符并运行如下所示的命令：

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

请注意，管理员更新不会启动新布局的创建；它只会更新现有布局。 将需要使用启动程序来创建初始布局。

确保网络布局基于受支持的版本

有时，当通道变得不受支持时，你需要确保网络布局继续基于受支持的通道，以便客户端可以继续接收安全更新通知。 如果布局基于 VisualStudio.17.Release.LTSC.17.0 通道，那么一旦 17.0 LTSC 通道于 2023 年 7 月起不再受支持，我们将不会对该通道发布任何其他安全更新程序，你的布局和客户端将变得不安全。 可在此处找到各种 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 文件的“添加”部分将确定在客户端的安装程序 UI 中默认选择哪些组件。 如果使用上述任一方法修改了布局，则可能需要手动仔细检查，并且可能需要调整 response.json 文件中的“添加”部分，使其与新修改的 layout.json 文件的“添加”部分的内容更匹配。

配置布局以删除客户端计算机上不支持的组件。

一些企业希望利用 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 受支持版本的每次更新提供。 因此，无需显式执行任何操作即可将具有最新功能和 bug 修复的最新版本安装程序获取到你的布局和客户端中。

但是，如果使用的布局是在 2023 年 6 月之前创建的，则还可以显式将布局配置为始终包含并向客户端提供最新的安装程序，即使安装程序被视为较新版本 Visual Studio 的一部分。 因此，当客户端从此布局更新时，客户端将获得此布局包含和提供的最新安装程序。 这样做的好处是，一旦在客户端上安装了最新安装程序，客户端安装将能够利用我们持续添加到安装程序的 bug 修补程序和新功能。

有几种方法可让布局包含并提供最新安装程序：

• 可以使用在 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	引导程序无法下载安装程序
5004	操作已取消
5005	引导程序命令行分析错误
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 收集工具发送日志，这将非常有帮助，因为它可帮助我们诊断和解决问题。

对于安装相关问题，我们还提供安装聊天（仅限英语）支持选项。

我们还提供其他支持选项。 请参阅我们的 Visual Studio 开发者社区。

相关内容

• Visual Studio 管理员指南
• 将 Visual Studio 从布局部署到客户端计算机上
• 更新基于网络的 Visual Studio 安装
• 安装或使用 Visual Studio 时与网络相关错误的疑难解答
• 针对 Visual Studio 的企业部署配置策略
• Visual Studio 产品生命周期和维护
• 使用命令行参数安装 Visual Studio
• Visual Studio 工作负荷和组件 ID
• 安装 Visual Studio 脱机安装所需的证书