Citrix Virtual Apps and Desktops 7 2402 LTSR

许可证激活服务

May 31, 2026

投稿者:

许可证激活服务 (LAS) 是一种新的基于云的许可解决方案，它提供了传统 Citrix® 旧版许可的替代方案。LAS 引入了新的激活模块，确保了许可证管理的无缝和现代化方法。

LAS 简化了 Citrix 许可体验。不再需要生成、下载或安装许可证访问代码或文件到许可证服务器上。您只需升级许可证服务器并向 Citrix Cloud 注册。一旦兼容产品指向许可证服务器，它们就可以自动激活。

激活后，许可证服务器会定期与许可证激活服务通信，以保持其激活状态最新。LAS 采用云技术构建，可提高性能并确保零停机时间。如果许可证服务器或 LAS 因任何原因无法访问，系统将进入许可证缓存模式，该模式旨在保护系统免于未授权并避免中断。有关更多信息，请参阅许可证缓存模式。

有关 LAS 的更多详细信息，请参阅许可文档许可证激活服务。

先决条件

将许可证服务器安装或更新到版本 11.17.2 build 53100 或更高版本。
许可证服务器需要可靠且持续的互联网连接。
必须禁用桌面组级别许可证设置。

注意：

To ensure if DG level licensing is disabled, use Get-brokerdesktopgroup and LicenseModel should be “None”.

注意事项

在 Citrix Studio 或 Citrix Web Studio 提示激活之前，所有交付控制器都必须与 LAS 兼容。单个控制器站点可以使用旧版许可证或 LAS。
您可以有多个许可证服务器注册到同一个 Citrix Cloud ID (CCID) 或 OrgID。但是，一个站点只能配置为指向一个许可证服务器。

局限性

迁移到 LAS 会将产品版本设置为 Premium，并将许可证模型设置为 Concurrent，但这在将来可能会发生变化。请勿使用 PowerShell 修改许可证配置，因为这可能会影响注册和会话启动。
You can migrate your Citrix Virtual Apps and Desktops™ site from the existing legacy license to LAS using only Web Studio.

关键步骤

将许可证服务器安装或升级到版本 11.17.2 build 53100 或更高版本，并按照 (/zh-cn/licensing/current-release/license-activation-service#how-to-configure-license-server-for-license-activation-service) 中所述的说明配置 LAS。
Install Citrix Virtual Apps and Desktops version 2402 LTSR CU3 or later. Install the core components, such as Citrix Delivery Controller, Citrix Studio, Web Studio, and Citrix Director.

注意：

All Delivery Controllers in the Citrix Virtual Apps and Desktops site must be compatible with LAS.
安装所需组件后，使用 Citrix Site Manager 创建站点。有关创建站点的信息，请参阅 (/zh-cn/citrix-virtual-apps-desktops/2402-ltsr/install-configure/site-create)。如果许可证服务器配置为使用 LAS，Metainstaller 将显示授权。授权将随其相应的许可证到期日期一起提供。

注意：

如果许可证服务器未升级到版本 53100 或更高版本，您将遇到许可错误。忽略这些错误并继续进行 CVAD 站点升级将导致站点无法正常运行。
检查许可详细信息。
将旧版许可迁移到 LAS。

检查许可详细信息

创建站点后，使用 Web Studio 检查许可详细信息。

在 Web Studio 中，选择许可节点。
在概述选项卡上，检查 Citrix Virtual Apps and Desktops 站点是否具有适当的许可证，或者在使用 LAS 功能时许可证是否已过期。

如果 LAS 无法访问，您可能会看到一条错误消息：

如果许可证服务器不可用，您可能会看到一条错误消息：

如果您的许可证服务器仍在使用旧的传统许可证，并且 Citrix Virtual Apps and Desktops 站点支持 LAS，则 Web Studio 会提示您将许可证服务器注册到 Citrix Cloud。

将传统许可迁移到 LAS

如果您已将许可证服务器注册到 Citrix Cloud 并拥有必要的权利，则必须按照以下特定顺序将现有 Citrix Virtual Apps and Desktops 站点从传统许可迁移到 LAS，而不会影响用户会话。

升级许可证服务器： 将许可证服务器升级到最低支持版本。
升级交付控制器： 将站点中的所有交付控制器升级到支持 LAS 的版本。
删除交付组许可证分配：
- 在单击迁移到 LAS 之前，请手动删除站点级别以下设置的任何许可证分配（即，删除交付组级别的许可证分配）。
确认分配： 验证 LAS 分配是否准确无误。
单击“迁移到 LAS”：
- 完成上述步骤后，单击“迁移到 LAS”。
- 迁移到 LAS 后，Citrix Virtual Apps and Desktops 站点的许可证版本将设置为 Citrix 虚拟应用和桌面高级版，并且许可证模型将配置为并发。

从 LAS 回滚到旧版许可

要从 LAS 回滚到旧版许可，请执行以下操作：

运行以下 PowerShell 命令行。

Set-ConfigSite -UseLicenseActivationService $false
<!--NeedCopy-->

在 Web Studio 中配置旧版许可证。

注意：

这些步骤仅用于临时故障排除。旧版许可证文件即将终止生命周期 (EOL)，并且在 2026 年 4 月 15 日之后将无法运行。为确保服务不中断，我们建议迁移到许可证激活服务 (LAS)。有关详细信息，请参阅公告。

升级的重要注意事项

当您从任何早期 Citrix Virtual Apps and Desktops 版本升级到 2411 及更高版本时，请将许可证服务器升级到最新版本（版本 11.2.17 build 53100 或更高版本）。

在使用元安装程序 UI 升级时，您会在“许可错误”页面上收到以下错误：
- 如果您未升级到最新许可证服务器版本：
  
  版本错误(/zh-cn/citrix-virtual-apps-desktops/2402-ltsr/media/version-licensing-error.png)
- 如果存在任何不兼容性，例如许可证服务器过时或许可证不可用：
  
  许可证服务器过时或许可证不可用(/zh-cn/citrix-virtual-apps-desktops/2402-ltsr/media/outdated-license-server-error.png)
如果您使用命令行进行升级，请运行以下命令以避免升级失败（假设您位于挂载的 ISO 中的 \x64 文件夹内）：

运行以下命令：

\x64\Licensing\CitrixLicensing.exe /quiet
<!--NeedCopy-->

如果您已将许可二进制文件复制到任何本地驱动器，请运行以下命令：

\x64\Licensing\CitrixLicensing.exe /quiet /l install.log
<!--NeedCopy-->

运行以下命令：

\x64\XenDesktop Setup\XenDesktopServerSetup.exe  /components "CONTROLLER,DESKTOPSTUDIO,DESKTOPDIRECTOR" /CONFIGURE_FIREWALL
<!--NeedCopy-->

核心组件的卸载

在升级期间，如果您首先使用命令 \x64\Licensing\CitrixLicensing.exe /quiet 或 \x64\Licensing\CitrixLicensing.exe /quiet /l install.log 安装了许可证服务器，然后安装了核心组件，请按照相同的顺序进行卸载：

使用命令行卸载许可证服务器：

CitrixLicensing.exe /quiet /uninstall /l uninstall.log
<!--NeedCopy-->

使用 GUI 或命令行卸载组件。有关信息，请参阅移除组件。

如果您使用命令行 XenDesktopServerSetup.exe 或 removeall 卸载许可证服务器和组件，请清理注册表项和剩余文件。

清理注册表项：

搜索注册表项 Citrix Licensing 并删除该条目。通常，您可以在以下位置找到该条目：

"Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\
<!--NeedCopy-->

删除注册表项中 Uninstall String 指向的文件夹。

故障排除

如果许可证服务器在 Citrix Cloud 中的状态显示为非绿色，请执行以下操作以了解可能存在问题的激活的详细信息：

在 Citrix Cloud 中，导航到 许可 > 已许可的部署 > 许可证服务器。
点击 Citrix Virtual Apps and Desktops 旁边的展开按钮 >，以查看已激活的交付控制器列表。
单击激活旁边的 查看详细信息 以查看详细信息。

ID 是用于识别激活的唯一标识符。

提供了以下详细信息：
- 产品和版本：产品在通过 LAS 激活时配置使用的 Product_Edition_Model 和 Burn In Date。BurnInDate 通常是产品的发布日期。
- BrokerServiceGroupUid：此参数表示代理服务组的唯一标识符。
- Controller UUID：交付控制器的通用唯一标识符 (UUID)。
- LasUniqueEnvId：由 LAS 提供用于激活的实例的唯一标识符。
- HA-Broker：真或假，指示其是 HA 代理还是主代理。

要将已激活的主机详细信息与实际主机进行映射，请在该主机上运行以下命令。

Get-BrokerSite：将屏幕上显示的 BrokerServiceGroupUid 值与命令的 BrokerServiceGroupId 输出进行比较。
Get-BrokerController：将屏幕上显示的 Controller UUID 值与命令的 UUID 输出进行比较。

与许可事件相关的事件查看器日志

事件 ID	描述信息
1112	Citrix Broker Service 未能为用户与资源建立连接。站点的产品和版本许可配置不允许此类型的资源。请检查是否已为该站点选择了正确的许可证。
1150	Citrix Broker 服务成功联系了许可证服务器。
1151	Citrix Broker Service 无法联系许可证服务器。请确保许可证服务器正常运行，并且 XenDesktop 配置中标识许可证服务器的详细信息正确无误。
1152	此 XenDesktop 站点在许可证服务器上没有所需的现有产品许可证。请使用许可证管理控制台将相关产品许可证添加到许可证服务器。
1153	此 XenDesktop 站点的许可证已过期。Citrix Broker Service 将从许可证服务器请求新许可证。
1154	此控制器已进入许可证缓存模式，因为它无法联系许可证服务器。在此控制器停止提供桌面和应用程序会话之前，您还有 2 小时。
1155	Citrix Broker Service 现在将停止提供桌面和应用程序会话。由于持续无法与许可证服务器通信，此控制器不再处于或无法进入许可证缓存模式。请确保许可证服务器正常运行，如有必要，请使用许可证管理控制台将相关许可证添加到许可证服务器。
1156	Citrix Broker Service 正在成功与许可证服务器通信。此控制器不再处于许可证缓存模式。
1157	许可证服务器上运行的版本早于 Citrix Broker Service 的版本，因此不兼容。请升级您的许可证服务器，或在 XenDesktop 配置中指定具有正确版本的许可证服务器位置。
1158	Citrix Broker Service 检测到您已超出此版本在此站点许可证服务器上可用的许可证数量。许可证服务器已授予您透支许可证。
1159	Citrix Broker Service 拒绝了桌面连接，因为此站点已超出最大安装许可证数量。此版本安装了三个许可证，但此版本允许的最大许可证数量为两个。请从许可证服务器中删除相关许可证以符合许可证限制。
1160	Citrix Broker Service 在管理许可证时遇到内部错误。请确保许可证服务器正常运行，并且 XenDesktop 配置中标识许可证服务器的详细信息正确无误。重新启动 Citrix Broker Service 也可能解决此问题。如果此问题仍然存在，请重新安装 Citrix XenDesktop Controller。请参阅 Citrix 知识库文章 CTX126990。
1161	许可初始化错误。请检查许可证服务器连接。
1162	许可停止错误。请检查许可证服务器连接。
1163	无可用连接许可证。要解决此问题，请通过关闭不需要的会话来释放许可证，或添加更多许可证。
1164	签出连接许可证时出错。请检查许可证服务器连接。
1165	签入连接许可证时出错。请检查许可证服务器连接。
1166	检查许可证可用性时出错。请检查许可证服务器连接。
1167	启动许可失败。请检查许可证服务器连接。
1168	读取许可用户通知设置时出错。请检查许可证服务器连接。
1169	此控制器已进入开箱即用许可证缓存模式，因为在许可证服务器上未找到合适的许可证。在此控制器停止提供桌面和应用程序会话之前，您还有 2 小时。
1170	Citrix Broker Service 已成功在许可证服务器上检测到合适的许可证。此控制器不再处于开箱即用许可证缓存模式。
1171	未指定许可证服务器。在指定有效的许可证服务器之前，Citrix Broker Service 无法向用户提供桌面和应用程序。您可以在 Citrix Studio 中或使用 Citrix PowerShell SDK cmdlet Set-ConfigSite 指定许可证服务器。
1172	检查许可证服务器适用性时出错。Citrix Broker Service 在检查计算机是否适合用作许可证服务器时收到意外响应。请检查控制器是否可以联系到该计算机，以及该计算机上的任何防火墙是否允许来自控制器的连接。如果计算机上安装了许可证服务器，请检查其配置和运行是否正确。
1173	此 XenDesktop 站点在许可证服务器上没有所需的启动许可证。请使用许可证管理控制台将相关许可证添加到许可证服务器。
1174	此 XenDesktop 站点配置的产品版本不支持应用程序；应用程序资源将不可用。
1176	您当前配置的产品版本不支持多会话计算机的功能。因此，您的注册请求未能通过并已被拒绝。
1177	所配置的产品版本不支持单会话计算机。注册请求已被拒绝。
1178	配置的产品版本不支持 RemotePC。注册被拒绝。
1179	所配置的产品版本不支持预配到云系统中的计算机。注册请求已被拒绝。
1180	此 XenDesktop 站点的配置产品版本不支持单会话（工作站操作系统）计算机上的应用程序。应用程序资源启动被拒绝。
1181	此 XenDesktop 站点的配置产品版本不支持多会话（服务器操作系统）计算机上的应用程序。应用程序资源启动被拒绝。
1182	此 XenDesktop 站点的配置产品版本不支持单会话（工作站操作系统）计算机上的桌面。桌面资源启动被拒绝。
1183	此 XenDesktop 站点的配置产品版本不支持多会话（服务器操作系统）计算机上的桌面。桌面资源启动被拒绝。
1196	此控制器已进入许可证突发模式，因为许可证服务器上的所有可用许可证均已用尽。请添加更多许可证以解决此问题。在此控制器停止提供桌面和应用程序会话之前，您还有 2 小时。
1197	Citrix Broker 服务现在将停止提供桌面和应用程序会话。由于许可证服务器上的许可证不足，此控制器不再处于或无法进入许可证突发模式。使用许可证管理控制台将相关许可证添加到许可证服务器。
1198	Citrix Broker 服务正在成功地从许可证服务器使用许可证。服务器上有足够的许可证来满足当前需求。此控制器不再处于因许可证耗尽导致的许可证突发模式。
1199	Citrix Broker 服务现在将停止提供桌面和应用程序会话。由于许可证服务器上未安装任何许可证，此控制器不再处于或无法进入许可证缓存模式。使用许可证管理控制台将相关许可证添加到许可证服务器。
1205	您的软件维护已过期。您的 Citrix 环境目前不受支持。检查您的许可证服务器以查找过期许可证并将其删除。在用户开始收到警告消息之前，有 30 天的许可证缓存模式。
1206	许可证证书哈希无效。您的 Citrix 许可证证书哈希无效。
1300	Citrix Broker 服务现在将停止提供桌面和应用程序会话。许可证服务器的系统时钟存在问题。
1301	许可证服务器的系统时钟问题已得到纠正。Citrix Broker 服务现在将恢复正常运行。
1302	此控制器再次未能签入或签出连接许可证。以前检测到的故障仍然存在。为避免过多的事件日志记录，服务将抑制相关消息（事件 ID 1163、1164、1165），直到问题解决。许可尝试将继续。
1303	此控制器不再抑制相关消息（事件 ID 1163、1164、1165）。
1304	Citrix 代理服务成功联系了 LAS。
1305	Citrix Broker Service 无法联系 LAS。请确保 LAS 正常运行，并且 XenDesktop 配置中标识 LAS 的详细信息正确无误。