使用最小化的脱机布局更新 Visual Studio

项目
2025-02-10

对于未连接到 Internet 的计算机，创建最小布局是更新脱机 Visual Studio 实例的最简单、最快的方法。

最小的布局工具生成专为团队需求定制的布局。企业管理员可以使用此工具为大多数版本的 Visual Studio（包括 Visual Studio 2017）创建更新布局。与完整的 Visual Studio 布局不同，最小布局仅包含更新的包，因此生成和部署速度始终更小、更快。通过仅指定所需的语言、工作负载和组件，可以进一步减小更新布局的大小。

如何生成最小布局

重要

这些说明假定之前已创建和使用布局。要详细了解如何执行此操作，请参阅更新基于网络的 Visual Studio 安装页面。

若要更好地了解 Visual Studio 生命周期，请参阅 Visual Studio 产品生命周期和服务页。

此工具为 Visual Studio 2017（15.9）及更高版本创建更新布局。布局可以部署到网络/脱机计算机以更新 Visual Studio 实例。在普通布局创建期间，将下载该特定版本的所有包。在 Visual Studio 实例上修复、卸载和其他标准操作时，需要创建普通布局。精简布局仅下载更新的程序包，因此它体积更小，更容易复制到脱机计算机上。

安装最小布局工具

首先，下载此处的最小布局工具。请确保在出现提示时选择保存，然后选择运行。
接下来，单击“是”以接受用户帐户控制提示。
最小布局工具将安装到 C:\Program Files (x86)\Microsoft Visual Studio\MinimalLayout。

如何使用最小布局工具

MinimalLayout.exe 使用以下命令和选项生成布局。运行该工具至少需要一个命令。下面介绍了如何运行该工具：

MinimalLayout.exe [command] <options>...

命令

预览版：使用此命令预览要下载的包数，以及用于创建此布局的总空间。
生成：使用此命令生成用于更新 Visual Studio 的最小布局。
重新生成：使用此命令可使用现有的最小布局响应文件再生成布局。每个最小布局都会生成一个 MinimalLayout.json 响应文件，其中包含原始最小布局输入参数。你可使用 Regenerate 命令和 MinimalLayout.json 响应文件来再生成最小布局。如果要基于以前的最小布局的响应文件为新的 Visual Studio 更新创建最小布局，这非常有用。

对于此命令，需要一个已有布局中的 MinimalLayout.json 文件路径。
```
MinimalLayout.exe regenerate --filePath C:\MinimalLayout\MinimalLayout.json
```
验证：使用此命令确定布局文件夹是否已损坏。
修复：使用此命令修复损坏的布局文件夹，包括替换布局文件夹中缺少的包。

选项

选项	描述	必需/可选	例
--targetLocation <dir>	指定要在其中创建最小脱机布局的目录。	必需	--targetLocation c:\VSLayout\
--baseVersion <version>	从此版本开始，将生成最小脱机布局。	必需	--baseVersion 16.4.0
--targetVersion <version>	此版本及以下版本，将生成最小脱机布局。	必需	--targetVersion 16.4.4
--语言	指定要包含在最小脱机布局中的语言。可以指定多个值，用空格分隔。	必需	--languages en-US fr-FR
--productIds <一个或多个产品 ID>	将从其中生成最小脱机布局的产品 ID，用逗号分隔。 Microsoft.VisualStudio.Product.Enterprise Microsoft.VisualStudio.Product.Professional Microsoft.VisualStudio.Product.BuildTools Microsoft.VisualStudio.Product.TestAgent Microsoft.VisualStudio.Product.TestController Microsoft.VisualStudio.Product.TeamExplorer	必需	--productIds Microsoft.VisualStudio.Product.Enterprise,Microsoft.VisualStudio.Product.Professional
--filePath	已创建的布局中的 MinimalLayout.json 文件的文件路径。此选项仅用于“重新生成”命令。	Regenerate 命令所需内容	--filePath C:\VSLayout\minimalLayout.json 请注意，Regenerate 命令仅采用 --filePath 作为选项。
--add <一个或多个工作负载或组件 ID>	指定要添加的一个或多个工作负载或组件 ID。可以使用 --includeRecommended 和/或 –-includeOptional 全局添加额外的组件。可以指定多个工作负荷或组件 ID，用空格分隔。	自选	--add Microsoft.VisualStudio.Workload.ManagedDesktop Microsoft.VisualStudio.Workload.NetWeb Component.GitHub.VisualStudio
--includeRecommended	包括已安装的任何工作负载的推荐组件，但不包括可选组件。	自选	对于特定工作负荷： --add Microsoft.VisualStudio.Workload. ManagedDesktop;includeRecommended 应用于所有工作负载：--includeRecommended
--includeOptional	包括适用于已安装的任何工作负载的可选组件，还包括建议的组件。	自选	对于特定工作负荷： --add Microsoft.VisualStudio.Workload. ManagedDesktop;includeOptional 应用于所有工作负载：--includeOptional

生成最小布局

重要

这些说明假定之前已创建网络安装布局。有关如何执行此操作的详细信息，请参阅创建 Visual Studio 页面的网络安装。

使用 generate 命令为指定的版本范围创建最小布局。您还需要了解产品ID、语言类别以及任何所需的特定工作负载。此最小布局将更新任何 Visual Studio 实例，从基本版本开始，一直到并包括目标版本。

在创建布局之前，可以使用 预览版 命令了解下载的总大小和包含的包数。此命令采用与生成命令相同的选项，并将详细信息写入控制台。

让我们逐步讲解如何预览、生成和重新生成最小布局的几个示例：

首先，以下示例演示了如何仅针对英文预览 Visual Studio Enterprise 版本 16.4.0 到 16.4.4 的布局。

MinimalLayout.exe preview --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --languages en-US

下面介绍如何使用一个工作负荷生成相同的布局。

MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop;includeOptional --languages en-US

下面介绍如何使用现有响应文件重新生成最小脱机布局。
```
MinimalLayout.exe regenerate --filepath c:\VSLayout\MinimalLayout.json
```

使用生成命令的其他几个示例：

下面介绍如何添加附加工作负载，并仅包含推荐的包。

MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Professional --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop Microsoft.VisualStudio.Workload.NetWeb;includeRecommended --languages en-US

您还可以生成支持多个产品的简约离线布局。

MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise,Microsoft.VisualStudio.Product.Professional --baseVersion 16.4.0 --targetVersion 16.4.4 --languages en-US

最后，下面介绍了如何在最小的布局中包含多种语言。

MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop;includeOptional --languages en-US fr-FR

如何保持最小布局

使用 verify 和 fix 命令，在创建最小布局后维护它。验证命令确定是否在最小布局中有任何损坏或缺少的包。如果在运行验证命令后遇到任何问题，请使用修复命令更正丢失或损坏的包。

下面介绍如何验证布局是否已损坏或缺少包：

MinimalLayout.exe Verify --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop --includeRecommended --languages en-US

下面介绍如何修复该布局：

MinimalLayout.exe fix --targetLocation C:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop;includeRecommended --languages en-US

注意

此布局不能用于修复 Visual Studio 安装。若要修复 Visual Studio 的现有实例，请参阅修复 Visual Studio。

如何使用最少的脱机布局更新 Visual Studio 的现有安装

生成最小布局后，可以将整个最小布局文件夹复制到客户端计算机。如果计算机无权访问其原始位置中的最小布局文件夹，则需要这样做。

导航到文件夹并标识引导程序应用程序名称。引导程序应用程序的名称取决于生成最小布局时指定的 ProductId 值。有关常见示例，请参阅下表。

产品编号值	应用程序名称
Microsoft.VisualStudio.Product.Enterprise	vs_enterprise.exe
Microsoft.VisualStudio.Product.Professional	vs_professional.exe
Microsoft.VisualStudio.Product.BuildTools	vs_buildtools.exe

该更新在两个步骤中应用于 Visual Studio 实例。首先更新 Visual Studio 安装程序，然后更新 Visual Studio。

更新 Visual Studio 安装程序

运行以下命令，根据需要用正确的引导程序应用程序名称替换 vs_enterprise.exe。
```
vs_enterprise.exe --quiet --update --offline C:\VSLayout\vs_installer.opc
```
更新 Visual Studio 应用程序

若要更新 Visual Studio，需要指定要更新的 Visual Studio 实例的 installPath。如果安装了 Visual Studio 的多个实例，则需要单独更新每个实例。强烈建议使用 update 命令指定 –noWeb 选项，以防止安装未在最小布局中的组件。这可以防止你使 Visual Studio 处于不可用状态。

运行以下命令，适当地替换 installPath 命令行参数。请确保也使用正确的引导程序应用程序名称。
```
vs_enterprise.exe update --noWeb --quiet --installpath "C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise"
```

更新 Visual Studio 安装程序

运行以下命令，根据需要用正确的引导程序应用程序名称替换 vs_enterprise.exe。
```
vs_enterprise.exe --quiet --update --offline C:\VSLayout\vs_installer.opc
```
更新 Visual Studio 应用程序

若要更新 Visual Studio，需要指定要更新的 Visual Studio 实例的 installPath。如果安装了 Visual Studio 的多个实例，则需要单独更新每个实例。强烈建议使用 update 命令指定 –noWeb 选项，以防止安装未在最小布局中的组件。这可以防止你使 Visual Studio 处于不可用状态。

运行以下命令，适当地替换 installPath 命令行参数。请确保也使用正确的引导程序应用程序名称。
```
vs_enterprise.exe update --noWeb --quiet --installpath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise"
```

支持或故障排除

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

下面是更多支持选项：

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

通过