许可证激活服务
许可证激活服务 (LAS) 是一种新型的基于云的许可解决方案,它提供了传统 Citrix® 旧版许可的替代方案。LAS 引入了新的激活模块,确保了无缝且现代的许可证管理方法。
LAS 简化了 Citrix 许可体验。不再需要生成、下载或安装许可证服务器上的许可证访问代码或文件。您只需升级许可证服务器并向 Citrix Cloud 注册。一旦兼容产品指向许可证服务器,它们就可以自动激活。
激活后,许可证服务器会定期与许可证激活服务通信,以保持其激活状态最新。LAS 采用云技术构建,可提高性能并确保零停机时间。如果由于任何原因许可证服务器或 LAS 无法访问,系统将进入许可证缓存模式,该模式旨在保护系统免受未授权状态并避免中断。有关详细信息,请参阅 许可证缓存模式。
有关 LAS 的更多详细信息,请参阅许可文档 许可证激活服务。
先决条件
- 安装或更新许可证服务器到版本 11.17.2 build 53100 或更高版本。
- 许可证服务器需要可靠且持续的互联网连接。
- 桌面组级别许可证设置必须禁用。
注意:
要确认 DG 级别许可是否已禁用,请使用 Get-brokerdesktopgroup 命令,并检查 LicenseModel 属性的值是否为 “None”。
注意事项
- 在 Web Studio 提示激活之前,所有 Delivery Controller 都必须与 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.
主要步骤
- 将 License Server 安装或升级到版本 11.17.2 build 53100 或更高版本,并按照 如何为许可证激活服务配置许可证服务器 中所述的说明配置 LAS。
-
安装 Citrix 虚拟应用和桌面 2411 或更高版本。安装核心组件,例如 Citrix 交付控制器、Citrix 管理控制台、Web Studio 和 Citrix 监控器。
注意:
Citrix 虚拟应用和桌面 站点中的所有 交付控制器 都必须与 LAS 兼容。
-
安装所需组件后,使用 Citrix Site Manager 创建站点。有关创建站点的信息,请参阅 创建站点。如果 License Server 配置为使用 LAS,则 Metainstaller 会显示权利。权利与相应的许可证到期日期一起提供。

注意:
如果 License Server 未升级到最新的 License Server 版本,您将收到错误消息。
- 检查许可详细信息。
- 将旧版许可迁移到 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 站点的许可证版本设置为 思杰虚拟应用和桌面高级版,并且许可证模型配置为并发。
-
从 LAS 回滚到旧版许可
要从 LAS 回滚到旧版许可,请执行以下操作:
-
Run the following PowerShell command.
Set-ConfigSite -UseLicenseActivationService $false <!--NeedCopy--> -
在 Web Studio 中配置旧版许可证。
注意:
这些步骤仅用于临时故障排除。旧版许可证文件即将终止生命周期 (EOL),并且在 2026 年 4 月 15 日之后将无法使用。为确保服务不中断,我们建议迁移到许可证激活服务 (LAS)。有关详细信息,请参阅公告。
升级的重要注意事项
当您从任何早期 Citrix Virtual Apps and Desktops 版本升级到 2411 及更高版本时,请将许可证服务器升级到最新版本(版本 11.2.17 build 53100 或更高版本)。
-
在使用元安装程序 UI 升级时,您会在“许可错误”页面上收到以下错误:
-
如果您未升级到最新许可证服务器版本:

-
如果存在任何不兼容性,例如许可证服务器过时或许可证不可用:

-
-
如果您正在使用命令行进行升级,请运行以下命令以避免升级失败(假设您位于已装载 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 中,导航到 许可 > 已许可的部署 > 许可证服务器。
-
单击思杰虚拟应用和桌面旁边的展开按钮 >,以查看已激活的交付控制器列表。

-
单击激活旁边的 View details(查看详细信息)以查看详细信息。
ID 是用于识别激活的唯一标识符。
提供了以下详细信息:

- 产品和版本:产品配置为在使用 LAS 激活时使用的 Product_Edition_Model 和 Burn In Date。BurnInDate 通常是产品的发布日期。
- BrokerServiceGroupUid: The UID for the Broker Service Group.
- 控制器 UUID:交付控制器的 UUID。
- LasUniqueEnvId:LAS 为激活提供的实例的唯一标识符。
- HA-Broker:指示它是 HA 代理还是主代理的真或假值。
要将已激活的主机详细信息与实际主机进行映射,请在主机上运行以下命令。
-
Get-BrokerSite:将屏幕上显示的 BrokerServiceGroupUid 值与命令的BrokerServiceGroupId输出进行比较。 -
Get-BrokerController:将屏幕上显示的 Controller UUID 值与命令的 UUID 输出进行比较。
与许可事件相关的事件查看器日志
| 事件 ID | 描述信息 |
|---|---|
| 1112 | Citrix Broker Service 未能为用户与资源建立连接。站点的产品和版本许可配置不允许此类型的资源。请检查是否已为此站点选择了正确的许可证。 |
| 1150 | 思杰代理服务成功联系了许可证服务器。 |
| 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 Service 将停止提供桌面和应用程序会话。由于许可证服务器上的许可证不足,此控制器不再处于或无法进入许可证突发模式。使用许可证管理控制台将相关许可证添加到许可证服务器。 |
| 1198 | Citrix Broker Service 正在成功从许可证服务器使用许可证。服务器上有足够的许可证来满足当前需求。此控制器不再处于因许可证耗尽导致的许可证突发模式。 |
| 1199 | Citrix Broker Service 将停止提供桌面和应用程序会话。由于许可证服务器上未安装任何许可证,此控制器不再处于或无法进入许可证缓存模式。使用许可证管理控制台将相关许可证添加到许可证服务器。 |
| 1205 | 您的软件维护已过期。您的 Citrix 环境目前不受支持。检查您的许可证服务器以查找过期许可证并将其删除。在用户开始收到警告消息之前,有 30 天的许可证缓存模式。 |
| 1206 | 许可证证书哈希无效。您的 Citrix 许可证证书哈希无效。 |
| 1300 | Citrix Broker Service 将停止提供桌面和应用程序会话。许可证服务器的系统时钟存在问题。 |
| 1301 | 许可证服务器的系统时钟问题已得到纠正。Citrix Broker Service 将恢复正常运行。 |
| 1302 | 此控制器再次未能签入或签出连接许可证。之前检测到的故障仍然存在。为避免过多的事件日志记录,服务将抑制相关消息(事件 ID 1163、1164、1165),直到问题解决。许可尝试将继续。 |
| 1303 | 此控制器不再抑制相关消息(事件 ID 1163、1164、1165)。 |
| 1304 | 思杰代理服务成功联系了 LAS。 |
| 1305 | Citrix Broker Service 无法联系 LAS。请确保 LAS 正常运行,并且 XenDesktop 配置中标识 LAS 的详细信息正确无误。 |
更多信息
有关检查站点的 LAS 状态或验证站点是否处于许可证缓存模式的信息,请参阅:
有关命令的详细信息,请参阅: