更新通过布局安装的 Visual Studio 客户端

项目
02/07/2025

📣我们很乐意听到你的反馈！请花点时间完成此调查，并告诉我们如何改进布局体验。感谢你的支持！

你可以并应该定期更新所有 Visual Studio 安装，以便它们获得最新的安全性和功能修补程序。

如果 Visual Studio 安装在组织中的计算机上，并且最初是从布局安装的，则很可能客户端计算机是“托管环境”的一部分，这意味着它由中央管理团队管理，并且必须遵守组织策略。若要更新托管环境中的客户端计算机，请考虑以下问题，因为答案将告知应如何处理更新过程。

更新来自何处：布局或 Microsoft 托管服务器？如果更新来自布局，布局是否已更新？布局是托管在网络共享上还是托管在内部 Intranet Web 服务器上？
更新将由用户手动启动，还是管理员启动事件，例如通过管理员更新或通过编程命令？请记住，执行更新的人员必须在客户端计算机上具有管理员权限。

准备更新源

如果客户端配置为从 Microsoft 托管服务器获取更新，则它们必须有权访问 Internet。在更新期间，客户端将在其订阅的更新通道下载并安装从 Microsoft 可获取的最新版本。

如果客户端配置为从布局获取更新，则更新客户端之前的第一步是确保布局本身包含 Visual Studio 的更新版本。 IT 管理员应使用最新的产品更新更新来更新现有布局，以便新的客户端安装或客户端更新都可以接收更新的版本，或者他们可以在不同的布局目录中创建全新的布局，你可以使用这些布局来更新客户端计算机。最佳做法是在发布安全更新后的第二个星期二更新布局。

确保运行更新的用户或系统帐户对包含布局的网络共享或内部网站具有适当的访问权限。有关详细信息，请参阅安装或使用 Visual Studio时排查与网络相关的错误。

在客户端计算机上手动启动更新

客户端计算机上拥有足够权限的用户可以自行手动启动 Visual Studio 更新。 Visual Studio 客户端将在其源位置中查找更新，以确定是否有任何更新包可用。这就是保持源布局更新非常重要的原因。

用户可以通过以下方式手动更新 Visual Studio 实例：

启动 Visual Studio 安装程序。如果更新可用，则可以单击“更新”。
启动 Visual Studio IDE 并响应通知标志或消息，或者选择“帮助”>“检查更新”以获取更新。

如果更新启动时正在使用任何文件，例如，如果 Visual Studio 处于打开状态，则在 Visual Studio 关闭之前将阻止更新。有时，更新需要重新启动。

手动配置 Visual Studio 客户端查找更新的位置

在客户端计算机上最初安装 Visual Studio 时，它会记录应检查更新的位置。如果 Visual Studio 是从Microsoft托管的服务器安装的，则默认情况下会查找来自Microsoft托管服务器的更新。如果通过对网络布局调用引导程序来安装或更新 Visual Studio 或通过运行脚本以从 Web 托管布局进行安装，它便会在布局指定的位置中查找更新。

使用默认的 Visual Studio 2019 功能，客户端安装产品后，客户端的更新位置配置将锁定且不可更改。 可靠地 更改更新的源位置的唯一方法是使用正确的配置卸载并重新安装产品。

但是，如果 Visual Studio 客户端使用最新的 Visual Studio 2022 安装程序，则可以更改客户端的更新源位置。如果要从一个布局进行安装，但希望从另一个布局获取更新，这会非常有用。可通过多种方式将 Visual Studio 2022 安装程序安装到客户端计算机上。最简单的方法是使用 2023 年 6 月之后随附的任何 Visual Studio 版本，因为这些版本会自动包含最新的安装程序。另一种方法是安装和使用 Visual Studio 2022 产品。最后，你可以通过 Visual Studio 2019 布局分发 Visual Studio 2022 安装程序。

若要手动查看和配置客户端将从中查找更新的更新位置，请打开更新设置并确保其配置正确。然后，可以从客户端启动更新。

更新通知

如果客户端查找更新的位置有可用的更新，客户端便会弹出一条消息或通知标志。

有关如何控制向用户显示更新通知的时间的详细信息，请参阅控制基于网络的 Visual Studio 部署更新。

使用管理员更新更新客户端计算机

如果你在组织中，建议的最佳做法是将客户端计算机注册到 Visual Studio 管理员更新。 Visual Studio 安全版本通常在“修补程序星期二”上提供，这是本月的第二个星期二。 IT 管理员应该养成每月维护和更新布局的习惯，就像在当月的第二个星期三早上一样，他们使用 Microsoft Endpoint Manager 将 Visual Studio 安全更新部署到整个组织的客户端计算机。管理员更新将触发客户端查看其更新源位置以获取任何新更新，如果布局已更新，则更新将自动应用于客户端计算机（假设 Visual Studio 未在使用中）。

以编程方式更新客户端计算机

管理员可以通过向客户端安装程序发出命令或在网络布局中调用引导程序，以编程方式更新 Visual Studio 的客户端安装。

使用 Visual Studio 安装程序以编程方式更新 Visual Studio

可以通过以编程方式调用客户端的安装程序并发出更新命令来启动对 Visual Studio 的更新。此命令将根据更新的源位置中提供的产品位来更新 Visual Studio。如果要在执行更新时更改客户端上的更新源位置，可以通过将 --channelUri 参数与 update 命令一起以编程方式执行此操作。例如：

可以将通道更改为网络布局，并在客户端上执行 update 命令，如下所示：

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" update --installPath "C:\Program Files\Microsoft Visual Studio\2019\Enterprise" --channelUri "\\\\server\\share\\newlayoutdir\\channelmanifest.json"

或如下所示，它将更新源设置为Microsoft托管位置：

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" update --installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise" --channelUri "https://aka.ms/vs/17/release/channel"

请注意，在前面的两个示例中，无法从安装程序所在的同一目录中以编程方式启动安装程序的执行。

使用启动加载程序以编程方式更新 Visual Studio

可以通过以编程方式从最初安装的相同位置调用引导程序来更新 Visual Studio。如果从 Microsoft 下载了引导程序，则如果客户端有权访问 Internet，则可以下载并使用任何更新的引导程序来更新 Visual Studio 客户端。请注意引导程序通道，因为它可能会导致客户端的更新通道发生更改。

如果引导程序位于网络布局共享上，则管理员应首先更新网络布局以包含 Visual Studio 产品更新，然后客户端才能使用该引导程序进行更新。

以下示例使用原始网络布局中的现有引导程序更新客户端。此方法假定 IT 管理员已更新布局。

\\server\share\originalinstallVSdirectory\vs_enterprise.exe update --installPath "C:\clientmachine\installpath" --quiet

还可以通过编程方式从不同网络布局位置调用引导程序来启动对 Visual Studio 2019 客户端的更新，该位置包含要将客户端更新到的产品版本。为此，需要在客户端上获取 Visual Studio 2022 安装程序。若要实现此目的，最简单的方法是确保新的 Visual Studio 2019 布局使用的是最新安装程序。如果从新的网络托管布局中运行引导程序，客户端上的更新通道将设置为布局中指定的更新位置。例如，可以使用新网络托管布局中的新引导程序在客户端计算机上运行此命令：

还可以通过编程方式从其他网络布局位置（包含要将客户端更新到的产品版本）调用引导程序，从而启动 Visual Studio 客户端的更新。如果通过新的网络托管布局运行引导程序，则客户端上的更新通道将设置为布局中指定的更新位置。例如，可以使用新网络托管布局中的新引导程序在客户端计算机上运行此命令：

   \\server\share\desiredupdatelayoutdir\vs_enterprise.exe update --installPath "C:\clientmachine\installpath" --quiet

无论新布局的 response.json 文件中的 channelUri 值是什么，都将成为客户端查找未来更新的位置。

注意

使用 vswhere.exe 命令标识客户端计算机上现有 Visual Studio 实例的安装路径。

以编程方式更新无法访问 Internet 的客户端

如果客户端计算机无 Internet 访问，则必须通过布局获取更新。请记住，每当更新 Visual Studio 时，都需要更新两个部分。第一个是安装程序，第二个是 Visual Studio 产品本身。对于网络托管布局，可以调用引导程序或安装程序来更新客户端。对于 Intranet Web 服务器托管布局，可以通过调用客户端上的安装程序进行更新。以下示例说明了这两种情况，并且都假定管理员已将布局本身更新为最安全的配置。

此示例指示 Visual Studio 从网络布局中显式查找这两个组件。第一条命令强制要求从布局更新安装程序，第二条命令则阻止在 Internet 上从 Microsoft 托管服务器下载任何包。

   \\server\share\VSlayoutdirectory\vs_enterprise.exe --quiet --update --wait --offline
   \\server\share\VSlayoutdirectory\vs_enterprise.exe update --installPath "C:\clientmachine\installpath" --noWeb --wait --quiet --norestart

此示例指示 Visual Studio 从内部 Intranet Web 服务器托管布局中包含的内容进行自我更新。

   "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" update --installPath "C:\Program Files\Microsoft Visual Studio\2019\Enterprise"

获取对网络布局的支持

如果您的网络布局出现问题，请告诉我们。告知我们的最佳方法是使用报告问题工具，该工具在 Visual Studio 安装程序和 Visual Studio IDE 中都可以找到。如果你是 IT 管理员且未安装 Visual Studio，则可以在此处提交 IT 管理员反馈。使用此工具时，如果您能够通过 VS Collect 工具发送日志，这将非常有助于我们诊断和解决问题。

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

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

通过