Citrix Director 故障原因和故障排除

连接失败错误

类别	原因	问题	操作
不适用	`[0] 未知。此错误代码未映射。`	监控服务无法根据 Brokering 服务共享的信息确定报告的启动或连接失败的原因。	在控制器上收集 CDF 日志并联系 Citrix 支持。
`[0] 无`	`[1] 无`	无	不适用
`[2] 计算机故障`	`[2] 会话准备`	从交付控制器到 VDA 的会话准备请求失败。可能的原因：控制器与 VDA 之间的通信问题、Broker 服务在创建准备请求时遇到的问题，或导致 VDA 不接受请求的网络问题。	请参阅知识中心文章《Citrix Virtual Apps and Desktops 中虚拟投递代理与交付控制器注册故障排除》中列出的故障排除步骤，了解导致控制器与 VDA 之间通信问题的常见问题。
`[2] 计算机故障`	`[3] 注册超时`	VDA 已开机，但在尝试向交付控制器注册时发生超时。	验证 Citrix Broker Service 是否在交付控制器上运行，以及 Desktop 服务是否在 VDA 上运行。如果已停止，请启动它们。
`[1] 客户端连接失败`	`[4] 连接超时`	VDA 准备好启动会话后，客户端未连接到 VDA。会话已成功代理，但在等待客户端连接到 VDA 时发生超时。可能的原因：防火墙设置、网络中断或阻止远程连接的设置。	检查 Director 控制台，查看客户端当前是否有活动连接，这意味着没有用户受到影响。如果不存在会话，请检查客户端和 VDA 上的事件日志以查找任何错误。解决客户端与 VDA 之间的任何网络连接问题。
`[4] 无可用许可证`	`[5] 许可`	许可请求失败。可能的原因：许可证数量不足，或者许可证服务器已停机超过 30 天。	验证许可证服务器是否在线且可访问。解决与许可证服务器的任何网络连接问题，或者如果许可证服务器出现故障，请重新启动它。验证环境中是否有足够的许可证，并在必要时分配更多许可证。
`[1] 客户端连接失败`	`[6] 票证`	在票证处理期间发生故障，表明客户端与 VDA 的连接与代理请求不匹配。启动请求票证由 Broker 准备并在 ICA® 文件中交付。当用户尝试启动会话时，VDA 会使用 Broker 验证 ICA 文件中的启动票证。可能的原因：ICA 文件已损坏或用户正在尝试进行未经授权的连接。	验证用户是否根据交付组中定义的用户组拥有对应用程序或桌面的访问权限。指示用户重新启动应用程序或桌面，以确定这是否是一次性问题。如果问题再次发生，请检查客户端设备事件日志以查找错误。验证用户尝试连接的 VDA 是否已注册。如果未注册，请检查 VDA 上的事件日志并解决任何注册问题。
`[1] 客户端连接失败`	`[7] 其他`	在客户端最初联系 VDA 但在完成连接序列之前，VDA 报告会话已终止。	验证会话是否在启动前未被用户终止。尝试重新启动会话，如果问题仍然存在，请收集 CDF 日志并联系 Citrix 支持。
`[1] 客户端连接失败`	`[8] 一般故障`	会话启动失败。可能的原因：在 Broker 仍在启动或初始化时请求了代理启动，或在启动的代理阶段发生内部错误。	验证 Citrix Broker Service 是否正在运行并重试启动会话。
`[5] 配置`	`[9] 维护模式`	VDA 或 VDA 所属的交付组处于维护模式。	确定是否需要维护模式。如果不需要，请在相关交付组或计算机上禁用维护模式，并指示用户尝试重新连接。
`[5] 配置`	`[10] 应用程序已禁用`	最终用户无法访问该应用程序，因为它已被管理员禁用。	如果应用程序旨在用于生产环境，请启用该应用程序并指示用户重新连接。
`[4] 无可用许可证`	`[11] 许可证功能被拒绝`	正在使用的功能不在现有许可证的涵盖范围内。	请联系 Citrix 销售代表，确认现有 Citrix Virtual Apps and Desktops™ 许可证版本和类型涵盖的功能。
`[3] 无可用容量`	`[13] 会话限制已达`	所有 VDA 都在使用中，没有容量来托管更多会话。可能的原因：所有 VDA 都在使用中（对于单会话操作系统 VDA），或者所有 VDA 都已达到配置的最大并发会话数（对于多会话操作系统 VDA）。	验证是否有任何 VDA 处于维护模式。如果不需要，请禁用维护模式以释放更多容量。考虑增加 Citrix 策略设置中最大会话数的值，以允许每个服务器 VDA 承载更多会话。考虑添加更多多会话操作系统 VDA。考虑添加更多单会话操作系统 VDA。
`[5] 配置`	`[14] 不允许的协议`	不允许使用 ICA 和 RDP 协议。	在交付控制器上运行 Get-BrokerAccessPolicyRule PowerShell 命令，并验证 AllowedProtocols 值是否列出了所有所需的协议。此问题仅在配置错误时发生。
`[5] 配置`	`[15] 资源不可用`	用户尝试连接的应用程序或桌面不可用。此应用程序或桌面可能不存在，或者没有可用的 VDA 来运行它。可能的原因：应用程序或桌面已取消发布，或者托管应用程序或桌面的 VDA 已达到最大负载，或者应用程序或桌面处于维护模式。	验证应用程序或桌面是否仍已发布，并且 VDA 未处于维护模式。确定多会话操作系统 VDA 是否已满载。如果是，请预配更多多会话操作系统 VDA。验证是否有可用于连接的单会话操作系统 VDA。如有必要，请预配更多单会话操作系统 VDA。
`[5] 配置`	`[16] 活动会话重新连接已禁用`	ICA 会话处于活动状态并连接到不同的端点。但是，由于活动会话重新连接已禁用，客户端无法连接到活动会话。	在交付控制器上，验证是否已启用活动会话重新连接。验证注册表路径 HKEY_LOCAL_MACHINE\Software\Citrix\Desktop\Server 下的 DisableActiveSessionReconnect 值是否设置为 0。
`[2] 计算机故障`	`[17] 无会话可重新连接`	客户端尝试重新连接到特定会话，但会话已终止。	重试工作区控制重新连接。
`[2] 计算机故障`	`[18] 启动失败`	VDA 无法开机以启动会话。这是虚拟机管理程序报告的问题。	如果计算机仍处于关机状态，请尝试从 Citrix Studio 启动计算机。如果失败，请检查虚拟机管理程序连接和权限。如果 VDA 是 PVS 预配的计算机，请在 PVS 控制台中验证计算机是否正在运行。如果不是，请验证是否为计算机分配了 Personal vDisk，登录到虚拟机管理程序以重置 VM。
`[2] 计算机故障`	`[19] 拒绝`	交付控制器向 VDA 发送请求以准备来自最终用户的连接，但 VDA 主动拒绝此请求。	通过 ping 验证交付控制器和 VDA 是否可以成功通信。如果不能，请解决任何防火墙或网络路由问题。
`[2] 计算机故障`	`[20] 配置集失败`	交付控制器在会话启动期间未将所需的配置数据（例如策略设置和会话信息）发送到 VDA。可能的原因：控制器与 VDA 之间的通信问题、Broker 服务在创建配置集请求时遇到的问题，或导致 VDA 不接受请求的网络问题。	-
`[3] 无可用容量`	`[21] 超出最大总实例数`	已达到应用程序的最大实例数。无法在 VDA 上打开更多应用程序实例。此问题与应用程序限制功能有关。	如果许可允许，请考虑将应用程序设置同时运行的实例数限制增加到更高的值。
`[3] 无可用容量`	`[22] 超出每个用户的最大实例数`	用户尝试打开多个应用程序实例，但应用程序配置为每个用户只允许一个应用程序实例。此问题与应用程序限制功能有关。	默认情况下，每个用户只允许一个应用程序实例。如果需要每个用户多个实例，请考虑清除应用程序设置中的限制每个用户一个实例设置。
`[1] 客户端连接失败`	`[23] 通信错误`	交付控制器尝试向 VDA 发送信息（例如准备连接的请求），但在通信尝试期间发生错误。这可能是由网络中断引起的。	如果已启动，请重新启动 VDA 上的 Desktop 服务以重新启动注册过程，并验证 VDA 是否成功注册。通过应用程序事件日志中的详细信息，确认为 VDA 配置的交付控制器是否准确。
`[3] 无可用容量`	`[100] 无可用计算机监控服务将 [12] 无可用桌面转换为此错误代码。`	分配用于启动会话的 VDA 处于无效状态或不可用。可能的原因：VDA 的电源状态未知或不可用，VDA 自上次用户会话以来未重新启动，当前会话需要启用会话共享但会话共享已禁用，或者 VDA 已从交付组或站点中移除。	验证 VDA 是否在交付组中。如果不在，请将其添加到相应的交付组。验证是否有足够的 VDA 已注册并处于就绪状态，以便能够启动用户请求的已发布共享桌面或应用程序。验证托管 VDA 的虚拟机管理程序是否未处于维护模式。
`[2] 计算机故障`	`[101] 计算机无法运行。监控服务将 [12] 无可用桌面转换为此错误代码。`	VDA 无法运行。可能的原因：VDA 已从交付组中移除，VDA 未注册，VDA 电源状态不可用，或者 VDA 遇到内部问题。	验证 VDA 是否在交付组中。如果不在，请将其添加到相应的交付组。验证 VDA 在 Citrix Studio 中是否显示为已开机。如果多台计算机的电源状态未知，请解决与虚拟机管理程序连接或主机故障的任何问题。验证托管 VDA 的虚拟机管理程序是否未处于维护模式。解决这些问题后，重新启动 VDA。

类别

原因

问题

操作

不适用

[0] 未知。此错误代码未映射。

监控服务无法根据 Brokering 服务共享的信息确定报告的启动或连接失败的原因。

在控制器上收集 CDF 日志并联系 Citrix 支持。

[0] 无

[1] 无

无

不适用

[2] 计算机故障

[2] 会话准备

从交付控制器到 VDA 的会话准备请求失败。可能的原因：控制器与 VDA 之间的通信问题、Broker 服务在创建准备请求时遇到的问题，或导致 VDA 不接受请求的网络问题。

请参阅知识中心文章《Citrix Virtual Apps and Desktops 中虚拟投递代理与交付控制器注册故障排除》中列出的故障排除步骤，了解导致控制器与 VDA 之间通信问题的常见问题。

[2] 计算机故障

[3] 注册超时

VDA 已开机，但在尝试向交付控制器注册时发生超时。

验证 Citrix Broker Service 是否在交付控制器上运行，以及 Desktop 服务是否在 VDA 上运行。如果已停止，请启动它们。

[1] 客户端连接失败

[4] 连接超时

VDA 准备好启动会话后，客户端未连接到 VDA。会话已成功代理，但在等待客户端连接到 VDA 时发生超时。可能的原因：防火墙设置、网络中断或阻止远程连接的设置。

检查 Director 控制台，查看客户端当前是否有活动连接，这意味着没有用户受到影响。如果不存在会话，请检查客户端和 VDA 上的事件日志以查找任何错误。解决客户端与 VDA 之间的任何网络连接问题。

[4] 无可用许可证

[5] 许可

许可请求失败。可能的原因：许可证数量不足，或者许可证服务器已停机超过 30 天。

验证许可证服务器是否在线且可访问。解决与许可证服务器的任何网络连接问题，或者如果许可证服务器出现故障，请重新启动它。验证环境中是否有足够的许可证，并在必要时分配更多许可证。

[1] 客户端连接失败

[6] 票证

在票证处理期间发生故障，表明客户端与 VDA 的连接与代理请求不匹配。启动请求票证由 Broker 准备并在 ICA® 文件中交付。当用户尝试启动会话时，VDA 会使用 Broker 验证 ICA 文件中的启动票证。可能的原因：ICA 文件已损坏或用户正在尝试进行未经授权的连接。

验证用户是否根据交付组中定义的用户组拥有对应用程序或桌面的访问权限。指示用户重新启动应用程序或桌面，以确定这是否是一次性问题。如果问题再次发生，请检查客户端设备事件日志以查找错误。验证用户尝试连接的 VDA 是否已注册。如果未注册，请检查 VDA 上的事件日志并解决任何注册问题。

[1] 客户端连接失败

[7] 其他

在客户端最初联系 VDA 但在完成连接序列之前，VDA 报告会话已终止。

验证会话是否在启动前未被用户终止。尝试重新启动会话，如果问题仍然存在，请收集 CDF 日志并联系 Citrix 支持。

[1] 客户端连接失败

[8] 一般故障

会话启动失败。可能的原因：在 Broker 仍在启动或初始化时请求了代理启动，或在启动的代理阶段发生内部错误。

验证 Citrix Broker Service 是否正在运行并重试启动会话。

[5] 配置

[9] 维护模式

VDA 或 VDA 所属的交付组处于维护模式。

确定是否需要维护模式。如果不需要，请在相关交付组或计算机上禁用维护模式，并指示用户尝试重新连接。

[5] 配置

[10] 应用程序已禁用

最终用户无法访问该应用程序，因为它已被管理员禁用。

如果应用程序旨在用于生产环境，请启用该应用程序并指示用户重新连接。

[4] 无可用许可证

[11] 许可证功能被拒绝

正在使用的功能不在现有许可证的涵盖范围内。

请联系 Citrix 销售代表，确认现有 Citrix Virtual Apps and Desktops™ 许可证版本和类型涵盖的功能。

[3] 无可用容量

[13] 会话限制已达

所有 VDA 都在使用中，没有容量来托管更多会话。可能的原因：所有 VDA 都在使用中（对于单会话操作系统 VDA），或者所有 VDA 都已达到配置的最大并发会话数（对于多会话操作系统 VDA）。

验证是否有任何 VDA 处于维护模式。如果不需要，请禁用维护模式以释放更多容量。考虑增加 Citrix 策略设置中最大会话数的值，以允许每个服务器 VDA 承载更多会话。考虑添加更多多会话操作系统 VDA。考虑添加更多单会话操作系统 VDA。

[5] 配置

[14] 不允许的协议

不允许使用 ICA 和 RDP 协议。

在交付控制器上运行 Get-BrokerAccessPolicyRule PowerShell 命令，并验证 AllowedProtocols 值是否列出了所有所需的协议。此问题仅在配置错误时发生。

[5] 配置

[15] 资源不可用

用户尝试连接的应用程序或桌面不可用。此应用程序或桌面可能不存在，或者没有可用的 VDA 来运行它。可能的原因：应用程序或桌面已取消发布，或者托管应用程序或桌面的 VDA 已达到最大负载，或者应用程序或桌面处于维护模式。

验证应用程序或桌面是否仍已发布，并且 VDA 未处于维护模式。确定多会话操作系统 VDA 是否已满载。如果是，请预配更多多会话操作系统 VDA。验证是否有可用于连接的单会话操作系统 VDA。如有必要，请预配更多单会话操作系统 VDA。

[5] 配置

[16] 活动会话重新连接已禁用

ICA 会话处于活动状态并连接到不同的端点。但是，由于活动会话重新连接已禁用，客户端无法连接到活动会话。

在交付控制器上，验证是否已启用活动会话重新连接。验证注册表路径 HKEY_LOCAL_MACHINE\Software\Citrix\Desktop\Server 下的 DisableActiveSessionReconnect 值是否设置为 0。

[2] 计算机故障

[17] 无会话可重新连接

客户端尝试重新连接到特定会话，但会话已终止。

重试工作区控制重新连接。

[2] 计算机故障

[18] 启动失败

VDA 无法开机以启动会话。这是虚拟机管理程序报告的问题。

如果计算机仍处于关机状态，请尝试从 Citrix Studio 启动计算机。如果失败，请检查虚拟机管理程序连接和权限。如果 VDA 是 PVS 预配的计算机，请在 PVS 控制台中验证计算机是否正在运行。如果不是，请验证是否为计算机分配了 Personal vDisk，登录到虚拟机管理程序以重置 VM。

[2] 计算机故障

[19] 拒绝

交付控制器向 VDA 发送请求以准备来自最终用户的连接，但 VDA 主动拒绝此请求。

通过 ping 验证交付控制器和 VDA 是否可以成功通信。如果不能，请解决任何防火墙或网络路由问题。

[2] 计算机故障

[20] 配置集失败

交付控制器在会话启动期间未将所需的配置数据（例如策略设置和会话信息）发送到 VDA。可能的原因：控制器与 VDA 之间的通信问题、Broker 服务在创建配置集请求时遇到的问题，或导致 VDA 不接受请求的网络问题。

[3] 无可用容量

[21] 超出最大总实例数

已达到应用程序的最大实例数。无法在 VDA 上打开更多应用程序实例。此问题与应用程序限制功能有关。

如果许可允许，请考虑将应用程序设置同时运行的实例数限制增加到更高的值。

[3] 无可用容量

[22] 超出每个用户的最大实例数

用户尝试打开多个应用程序实例，但应用程序配置为每个用户只允许一个应用程序实例。此问题与应用程序限制功能有关。

默认情况下，每个用户只允许一个应用程序实例。如果需要每个用户多个实例，请考虑清除应用程序设置中的限制每个用户一个实例设置。

[1] 客户端连接失败

[23] 通信错误

交付控制器尝试向 VDA 发送信息（例如准备连接的请求），但在通信尝试期间发生错误。这可能是由网络中断引起的。

如果已启动，请重新启动 VDA 上的 Desktop 服务以重新启动注册过程，并验证 VDA 是否成功注册。通过应用程序事件日志中的详细信息，确认为 VDA 配置的交付控制器是否准确。

[3] 无可用容量

[100] 无可用计算机监控服务将 [12] 无可用桌面转换为此错误代码。

分配用于启动会话的 VDA 处于无效状态或不可用。可能的原因：VDA 的电源状态未知或不可用，VDA 自上次用户会话以来未重新启动，当前会话需要启用会话共享但会话共享已禁用，或者 VDA 已从交付组或站点中移除。

验证 VDA 是否在交付组中。如果不在，请将其添加到相应的交付组。验证是否有足够的 VDA 已注册并处于就绪状态，以便能够启动用户请求的已发布共享桌面或应用程序。验证托管 VDA 的虚拟机管理程序是否未处于维护模式。

[2] 计算机故障

[101] 计算机无法运行。监控服务将 [12] 无可用桌面转换为此错误代码。

VDA 无法运行。可能的原因：VDA 已从交付组中移除，VDA 未注册，VDA 电源状态不可用，或者 VDA 遇到内部问题。

验证 VDA 是否在交付组中。如果不在，请将其添加到相应的交付组。验证 VDA 在 Citrix Studio 中是否显示为已开机。如果多台计算机的电源状态未知，请解决与虚拟机管理程序连接或主机故障的任何问题。验证托管 VDA 的虚拟机管理程序是否未处于维护模式。解决这些问题后，重新启动 VDA。

计算机故障类型

错误代码	错误代码 ID	问题	操作
Unknown	-	-	-
Unregistered	3	-	-
MaxCapacity（在 Director 中显示为“最大负载”）	4	计算机报告其已达到最大容量，即最大负载指数	确保所有虚拟机管理程序均已开机。通过增加虚拟机管理程序的容量或添加更多虚拟机管理程序，向受影响的交付组添加更多计算机。
StuckOnBoot	2	VM 未完成其启动序列，并且未与虚拟机管理程序通信。	确保 VM 在虚拟机管理程序上成功启动。检查 VM 上的其他消息，例如操作系统问题。确保虚拟机管理程序工具已安装在 VM 上。确保 VDA 已安装在 VM 上。
FailedToStart	1	VM 在尝试在虚拟机管理程序上启动时遇到问题。	检查虚拟机管理程序日志。
None	0	-	-

错误代码

错误代码 ID

问题

操作

Unknown

Unregistered

MaxCapacity（在 Director 中显示为“最大负载”）

计算机报告其已达到最大容量，即最大负载指数

确保所有虚拟机管理程序均已开机。通过增加虚拟机管理程序的容量或添加更多虚拟机管理程序，向受影响的交付组添加更多计算机。

StuckOnBoot

VM 未完成其启动序列，并且未与虚拟机管理程序通信。

确保 VM 在虚拟机管理程序上成功启动。检查 VM 上的其他消息，例如操作系统问题。确保虚拟机管理程序工具已安装在 VM 上。确保 VDA 已安装在 VM 上。

FailedToStart

VM 在尝试在虚拟机管理程序上启动时遇到问题。

检查虚拟机管理程序日志。

None

计算机注销原因（适用于故障类型为“未注册”或“未知”的情况）

错误代码	错误代码 ID	问题	操作
AgentShutdown	0	VDA 经历了正常关机。	如果根据现有电源管理策略，VDA 不应处于关闭状态，请将其开机。检查事件日志中的任何错误。
AgentSuspended	1	VDA 处于休眠或睡眠模式。	使 VDA 脱离休眠模式。考虑通过电源设置禁用 Citrix Virtual Apps™ and Desktops VDA 的休眠功能。
IncompatibleVersion	100	由于 Citrix 协议版本不匹配，VDA 无法与交付控制器通信。	使 VDA 和交付控制器版本保持一致。
AgentAddressResolutionFailed	101	交付控制器无法解析 VDA 的 IP 地址。	验证 VDA 计算机帐户是否存在于 AD 中。如果不存在，请创建它。验证 VDA 在 DNS 中的名称和 IP 地址是否准确。如果不是，请更正它们。如果问题普遍存在，请验证交付控制器上的 DNS 设置。通过运行 `nslookup` 命令验证控制器的 DNS 解析。
	101	交付控制器无法解析 VDA 的 IP 地址。	验证 VDA 计算机帐户是否存在于 AD 中。如果不存在，请创建它。验证 VDA 在 DNS 中的名称和 IP 地址是否准确。如果不是，请更正它们。
AgentNotContactable	102	交付控制器与 VDA 之间发生通信问题。	使用 ping 验证交付控制器和 VDA 是否可以成功通信。如果不能，请解决任何防火墙或网络问题。有关导致控制器与 VDA 之间通信问题的常见问题，请参阅知识中心文章 Troubleshooting Virtual Delivery Agent Registration with delivery controllers in Citrix Virtual Apps and Desktops (CTX136668) 中列出的故障排除步骤。
	102	交付控制器与 VDA 之间发生通信问题。	有关导致控制器与 VDA 之间通信问题的常见问题，请参阅知识中心文章 Troubleshooting Virtual Delivery Agent Registration with delivery controllers in Citrix Virtual Apps and Desktops (CTX136668) 中列出的故障排除步骤。联系 Citrix 支持。
AgentWrongActiveDirectoryOU	103	发生 Active Directory 发现配置错误。VDA 注册表中配置的站点特定 OU（其中站点控制器信息存储在 AD 中）适用于不同的站点。	确保 Active Directory 配置正确，或检查注册表设置。
EmptyRegistrationRequest	104	从 VDA 发送到交付控制器的注册请求为空。这可能是由于 VDA 软件安装损坏造成的。	重新启动 VDA 上的 Desktop 服务以重新启动注册过程，并通过应用程序事件日志验证 VDA 是否正确注册。
MissingRegistrationCapabilities	105	VDA 版本与交付控制器不兼容。	升级 VDA，或删除 VDA 然后重新安装。
MissingAgentVersion	106	VDA 版本与交付控制器不兼容。	如果问题影响所有计算机，请重新安装 VDA 软件。
InconsistentRegistrationCapabilities	107	VDA 无法将其功能告知 Broker。这可能是由于 VDA 和交付控制器版本不兼容造成的。注册功能随每个版本而变化，其表达形式与注册请求不匹配。	使 VDA 和交付控制器版本保持一致。
NotLicensedForFeature	108	您尝试使用的功能未获得许可。	检查您的 Citrix 许可版本，或删除 VDA 然后重新安装。
	108	您尝试使用的功能未获得许可。	联系 Citrix 支持。
UnsupportedCredentialSecurity version	109	VDA 和交付控制器未采用相同的加密机制。	使 VDA 和交付控制器版本保持一致。
InvalidRegistrationRequest	110	VDA 向 Broker 发出了注册请求，但请求内容已损坏或无效。	有关导致控制器与 VDA 之间通信问题的常见问题，请参阅知识中心文章 Troubleshooting Virtual Delivery Agent Registration with delivery controllers in Citrix Virtual Apps and Desktops (CTX136668) 中列出的故障排除步骤。
SingleMultiSessionMismatch	111	VDA 的操作系统类型与计算机目录或交付组不兼容。	将 VDA 添加到正确的计算机目录类型或包含相同操作系统计算机的交付组。
FunctionalLevelTooLowForCatalog	112	计算机目录设置为高于已安装 VDA 版本的 VDA 功能级别。	验证 VDA 的计算机目录功能级别是否与 VDA 的功能级别匹配。升级或降级计算机目录以与 VDA 的功能级别匹配。
FunctionalLevelTooLowForDesktopGroup	113	交付组设置为高于已安装 VDA 版本的 VDA 功能级别。	验证 VDA 的交付组功能级别是否与 VDA 的功能级别匹配。升级或降级计算机目录以与 VDA 的功能级别匹配。
PowerOff	200	VDA 未正常关机。	如果 VDA 应该处于开机状态，请尝试从 Citrix Studio 启动 VDA 并验证其是否正确启动和注册。解决任何启动或注册问题。VDA 重新启动后，检查其上的事件日志以帮助确定关机的根本原因。
AgentRejectedSettingsUpdate	203	Citrix 策略等设置已更改或更新，但在将更新发送到 VDA 时出错。如果更新与已安装的 VDA 版本不兼容，则可能会发生这种情况。	如有必要，请升级 VDA。检查所应用的更新是否受 VDA 版本支持。
SessionPrepareFailure	206	Broker 未完成对 VDA 上运行的会话的审核。	如果问题普遍存在，请重新启动交付控制器上的 Citrix Broker Service。
	206	Broker 未完成对 VDA 上运行的会话的审核。	联系 Citrix 支持。
ContactLost	207	交付控制器与 VDA 失去连接。这可能是由网络中断引起的。	验证 Citrix Broker Service 是否在交付控制器上运行，以及 Desktop 服务是否在 VDA 上运行。如果已停止，请启动它们。如果已启动，请重新启动 VDA 上的 Desktop 服务以重新启动注册过程，并验证 VDA 是否成功注册。通过应用程序事件日志中的详细信息确认 VDA 配置的交付控制器是否准确。使用 ping 验证交付控制器和 VDA 是否可以成功通信。如果不能，请解决任何防火墙或网络问题。
	207	交付控制器与 VDA 失去连接。这可能是由网络中断引起的。	验证 Desktop 服务是否在 VDA 上运行。如果已停止，请启动它。
BrokerRegistrationLimitReached	301	交付控制器已达到允许同时注册的最大 VDA 数量。默认情况下，交付控制器允许 10,000 个并发 VDA 注册。	考虑向站点添加交付控制器或创建站点。还可以通过 HKEY_LOCAL_MACHINE\Software\Citrix\DesktopServer\MaxWorkers 注册表项增加允许同时注册到交付控制器的 VDA 数量。有关详细信息，请参阅知识中心文章 Registry Key Entries Used by Citrix Virtual Apps and Desktops (CTX117446)。增加此数量可能需要控制器更多的 CPU 和内存资源。
SettingsCreationFailure	208	Broker 未构建要发送到 VDA 的一组设置和配置。如果 Broker 无法收集数据，则注册失败，VDA 将变为未注册状态。	检查交付控制器上的事件日志中是否存在任何错误。如果日志中没有明显的特定问题，请重新启动 Broker Service。Broker Service 重新启动后，重新启动受影响 VDA 上的 Desktop 服务，并验证它们是否成功注册。
	208	Broker 未构建要发送到 VDA 的一组设置和配置。如果 Broker 无法收集数据，则注册失败，VDA 将变为未注册状态。	重新启动受影响 VDA 上的 Desktop 服务，并验证它们是否成功注册。联系 Citrix 支持。
SendSettingsFailure	204	Broker 未将设置和配置数据发送到 VDA。如果 Broker 可以收集数据但无法发送，则注册失败。	如果仅限于单个 VDA，请重新启动 VDA 上的 Desktop 服务以强制重新注册，并通过应用程序事件日志验证 VDA 是否成功注册。解决任何出现的错误。有关导致控制器与 VDA 之间通信问题的常见问题，请参阅知识中心文章 Troubleshooting Virtual Delivery Agent Registration with delivery controllers in Citrix Virtual Apps and Desktops (CTX136668) 中列出的故障排除步骤。
AgentRequested	2	发生未知错误。	联系 Citrix 支持。
DesktopRestart	201	发生未知错误。	联系 Citrix 支持。
DesktopRemoved	202	发生未知错误。	联系 Citrix 支持。
SessionAuditFailure	205	发生未知错误。	联系 Citrix 支持。
UnknownError	300	发生未知错误。	联系 Citrix 支持。
RegistrationStateMismatch	302	发生未知错误。	联系 Citrix 支持。
Unknown	-	发生未知错误。	联系 Citrix 支持。

错误代码

错误代码 ID

问题

操作

AgentShutdown

VDA 经历了正常关机。

如果根据现有电源管理策略，VDA 不应处于关闭状态，请将其开机。检查事件日志中的任何错误。

AgentSuspended

VDA 处于休眠或睡眠模式。

使 VDA 脱离休眠模式。考虑通过电源设置禁用 Citrix Virtual Apps™ and Desktops VDA 的休眠功能。

IncompatibleVersion

100

由于 Citrix 协议版本不匹配，VDA 无法与交付控制器通信。

使 VDA 和交付控制器版本保持一致。

AgentAddressResolutionFailed

101

交付控制器无法解析 VDA 的 IP 地址。

验证 VDA 计算机帐户是否存在于 AD 中。如果不存在，请创建它。验证 VDA 在 DNS 中的名称和 IP 地址是否准确。如果不是，请更正它们。如果问题普遍存在，请验证交付控制器上的 DNS 设置。通过运行 nslookup 命令验证控制器的 DNS 解析。

101

交付控制器无法解析 VDA 的 IP 地址。

验证 VDA 计算机帐户是否存在于 AD 中。如果不存在，请创建它。验证 VDA 在 DNS 中的名称和 IP 地址是否准确。如果不是，请更正它们。

AgentNotContactable

102

交付控制器与 VDA 之间发生通信问题。

使用 ping 验证交付控制器和 VDA 是否可以成功通信。如果不能，请解决任何防火墙或网络问题。有关导致控制器与 VDA 之间通信问题的常见问题，请参阅知识中心文章 Troubleshooting Virtual Delivery Agent Registration with delivery controllers in Citrix Virtual Apps and Desktops (CTX136668) 中列出的故障排除步骤。

102

交付控制器与 VDA 之间发生通信问题。

有关导致控制器与 VDA 之间通信问题的常见问题，请参阅知识中心文章 Troubleshooting Virtual Delivery Agent Registration with delivery controllers in Citrix Virtual Apps and Desktops (CTX136668) 中列出的故障排除步骤。联系 Citrix 支持。

AgentWrongActiveDirectoryOU

103

发生 Active Directory 发现配置错误。VDA 注册表中配置的站点特定 OU（其中站点控制器信息存储在 AD 中）适用于不同的站点。

确保 Active Directory 配置正确，或检查注册表设置。

EmptyRegistrationRequest

104

从 VDA 发送到交付控制器的注册请求为空。这可能是由于 VDA 软件安装损坏造成的。

重新启动 VDA 上的 Desktop 服务以重新启动注册过程，并通过应用程序事件日志验证 VDA 是否正确注册。

MissingRegistrationCapabilities

105

VDA 版本与交付控制器不兼容。

升级 VDA，或删除 VDA 然后重新安装。

MissingAgentVersion

106

VDA 版本与交付控制器不兼容。

如果问题影响所有计算机，请重新安装 VDA 软件。

InconsistentRegistrationCapabilities

107

VDA 无法将其功能告知 Broker。这可能是由于 VDA 和交付控制器版本不兼容造成的。注册功能随每个版本而变化，其表达形式与注册请求不匹配。

使 VDA 和交付控制器版本保持一致。

NotLicensedForFeature

108

您尝试使用的功能未获得许可。

检查您的 Citrix 许可版本，或删除 VDA 然后重新安装。

108

您尝试使用的功能未获得许可。

联系 Citrix 支持。

UnsupportedCredentialSecurity version

109

VDA 和交付控制器未采用相同的加密机制。

使 VDA 和交付控制器版本保持一致。

InvalidRegistrationRequest

110

VDA 向 Broker 发出了注册请求，但请求内容已损坏或无效。

SingleMultiSessionMismatch

111

VDA 的操作系统类型与计算机目录或交付组不兼容。

将 VDA 添加到正确的计算机目录类型或包含相同操作系统计算机的交付组。

FunctionalLevelTooLowForCatalog

112

计算机目录设置为高于已安装 VDA 版本的 VDA 功能级别。

验证 VDA 的计算机目录功能级别是否与 VDA 的功能级别匹配。升级或降级计算机目录以与 VDA 的功能级别匹配。

FunctionalLevelTooLowForDesktopGroup

113

交付组设置为高于已安装 VDA 版本的 VDA 功能级别。

验证 VDA 的交付组功能级别是否与 VDA 的功能级别匹配。升级或降级计算机目录以与 VDA 的功能级别匹配。

PowerOff

200

VDA 未正常关机。

如果 VDA 应该处于开机状态，请尝试从 Citrix Studio 启动 VDA 并验证其是否正确启动和注册。解决任何启动或注册问题。VDA 重新启动后，检查其上的事件日志以帮助确定关机的根本原因。

AgentRejectedSettingsUpdate

203

Citrix 策略等设置已更改或更新，但在将更新发送到 VDA 时出错。如果更新与已安装的 VDA 版本不兼容，则可能会发生这种情况。

如有必要，请升级 VDA。检查所应用的更新是否受 VDA 版本支持。

SessionPrepareFailure

206

Broker 未完成对 VDA 上运行的会话的审核。

如果问题普遍存在，请重新启动交付控制器上的 Citrix Broker Service。

206

Broker 未完成对 VDA 上运行的会话的审核。

联系 Citrix 支持。

ContactLost

207

交付控制器与 VDA 失去连接。这可能是由网络中断引起的。

验证 Citrix Broker Service 是否在交付控制器上运行，以及 Desktop 服务是否在 VDA 上运行。如果已停止，请启动它们。如果已启动，请重新启动 VDA 上的 Desktop 服务以重新启动注册过程，并验证 VDA 是否成功注册。通过应用程序事件日志中的详细信息确认 VDA 配置的交付控制器是否准确。使用 ping 验证交付控制器和 VDA 是否可以成功通信。如果不能，请解决任何防火墙或网络问题。

207

交付控制器与 VDA 失去连接。这可能是由网络中断引起的。

验证 Desktop 服务是否在 VDA 上运行。如果已停止，请启动它。

BrokerRegistrationLimitReached

301

交付控制器已达到允许同时注册的最大 VDA 数量。默认情况下，交付控制器允许 10,000 个并发 VDA 注册。

考虑向站点添加交付控制器或创建站点。还可以通过 HKEY_LOCAL_MACHINE\Software\Citrix\DesktopServer\MaxWorkers 注册表项增加允许同时注册到交付控制器的 VDA 数量。有关详细信息，请参阅知识中心文章 Registry Key Entries Used by Citrix Virtual Apps and Desktops (CTX117446)。增加此数量可能需要控制器更多的 CPU 和内存资源。

SettingsCreationFailure

208

Broker 未构建要发送到 VDA 的一组设置和配置。如果 Broker 无法收集数据，则注册失败，VDA 将变为未注册状态。

检查交付控制器上的事件日志中是否存在任何错误。如果日志中没有明显的特定问题，请重新启动 Broker Service。Broker Service 重新启动后，重新启动受影响 VDA 上的 Desktop 服务，并验证它们是否成功注册。

208

Broker 未构建要发送到 VDA 的一组设置和配置。如果 Broker 无法收集数据，则注册失败，VDA 将变为未注册状态。

重新启动受影响 VDA 上的 Desktop 服务，并验证它们是否成功注册。联系 Citrix 支持。

SendSettingsFailure

204

Broker 未将设置和配置数据发送到 VDA。如果 Broker 可以收集数据但无法发送，则注册失败。

如果仅限于单个 VDA，请重新启动 VDA 上的 Desktop 服务以强制重新注册，并通过应用程序事件日志验证 VDA 是否成功注册。解决任何出现的错误。有关导致控制器与 VDA 之间通信问题的常见问题，请参阅知识中心文章 Troubleshooting Virtual Delivery Agent Registration with delivery controllers in Citrix Virtual Apps and Desktops (CTX136668) 中列出的故障排除步骤。

AgentRequested

发生未知错误。

联系 Citrix 支持。

DesktopRestart

201

发生未知错误。

联系 Citrix 支持。

DesktopRemoved

202

发生未知错误。

联系 Citrix 支持。

SessionAuditFailure

205

发生未知错误。

联系 Citrix 支持。

UnknownError

300

发生未知错误。

联系 Citrix 支持。

RegistrationStateMismatch

302

发生未知错误。

联系 Citrix 支持。

Unknown

发生未知错误。

联系 Citrix 支持。

这是否有帮助？