桌面探测

Last published : Nov 13, 2026
桌面探测可自动检查在站点中发布的 Citrix Virtual Desktops™ 的运行状况。桌面探测的结果可在 Director 中查看。
在 Director 的“配置”页面中，配置要探测的桌面、运行探测的端点计算机以及探测时间。代理使用 StoreFront™ 测试所选桌面的启动，并将结果报告回 Director。探测结果显示在 Director UI 中——“应用程序”页面上显示最近 24 小时的数据，历史探测数据则显示在 趋势 > 探测结果 > 桌面探测结果 页面上。在此，您可以查看探测失败发生的阶段 - StoreFront 可达性、StoreFront 身份验证、StoreFront 枚举、ICA 下载或桌面启动。故障报告将发送到配置的电子邮件地址。您可以安排桌面探测在非高峰时段跨多个地理区域运行。全面的结果有助于在用户遇到问题之前主动排查与预配桌面、托管计算机或连接相关的问题。桌面探测适用于高级版许可站点。此功能需要 Delivery Controllers 7 1906 或更高版本以及 Probe Agent 1903 或更高版本。
要求：
  • Delivery Controller™ 运行版本 1906 或更高版本。
  • 运行探测代理的端点计算机是安装了 Citrix Receiver for Windows 4.8 或更高版本，或 Citrix Workspace app for Windows（以前称为 Citrix Receiver for Windows）1906 或更高版本的 Windows 计算机。不支持适用于统一 Windows 平台 (UWP) 的 Workspace 应用程序。
  • Director 和 StoreFront 支持默认的基于表单的身份验证。
运行桌面探测所需的用户帐户或权限：
  • 每个端点计算机上用于探测的唯一 StoreFront 用户。StoreFront 用户无需是管理员；探测可以在非管理员上下文中运行。
  • 具有 Windows 管理员权限的用户帐户，用于在端点计算机上安装和配置 Citrix Probe Agent
  • 具有以下权限的完全管理员用户帐户或自定义角色。将普通用户帐户重新用于桌面探测可能会导致用户从其活动会话中注销。
    • 交付组权限：
      • 只读
    • Director 权限：
      • 创建、编辑、删除警报电子邮件服务器配置 - 如果电子邮件服务器尚未配置
      • 创建、编辑、删除探测配置
      • 查看配置页面
      • 查看趋势页面
Related information
排除应用程序故障

配置桌面探测

您可以安排桌面探测在非高峰时段跨多个地理区域运行。全面的探测结果有助于在用户遇到问题之前排查与桌面、托管计算机或连接相关的问题。
Citrix Probe Agent 2103 版支持站点聚合。可以从聚合站点枚举和启动应用程序和桌面。配置探测代理时，选择“Workspace (StoreFront) 站点聚合已启用”选项以启用从聚合站点枚举应用程序和桌面。支持以下站点组合：
  • 具有一个 StoreFront URL 的多个本地站点。
  • 具有 StoreFront 或 Workspace URL 的本地和云站点。
  • 具有一个 Workspace URL 的多个云站点。
注意：
您必须创建单独的管理员或用户来配置只能访问一个站点的探测。

步骤 1：安装和配置 Citrix Probe Agent

Citrix Probe Agent 是一个 Windows 可执行文件，它模拟用户通过 StoreFront 实际启动桌面的过程。它根据 Director 中的配置测试桌面启动，并将结果报告回 Director。
  1. 识别要运行桌面探测的端点计算机。
  2. 具有管理权限的用户可以在端点计算机上安装和配置 Citrix 探测代理。在 <https://www.citrix.com/downloads/citrix-virtual-apps-and-desktops/components/app-probe-agent.html> 下载 Citrix 探测代理可执行文件。
  3. 启动代理并配置您的 StoreFront Receiver for Web 凭据。在每台端点计算机上配置一个唯一的 StoreFront 用户。凭据经过加密并安全存储。
    探测代理
    注意：
    • 要从网络外部访问要探测的站点，请在 StoreFront URL 字段中键入 Citrix Gateway 登录页面 URL。Citrix Gateway 会自动将请求路由到相应的站点 StoreFront URL。此功能适用于 Citrix Gateway 12.1 或更高版本以及 Delivery Controllers 1811 或更高版本。
    • 您必须为配置的唯一 StoreFront 用户启用交互式登录。
  4. 在“配置以显示探测结果”选项卡中，输入您的 Director 凭据，然后单击“验证”。
    探测代理
  5. 选择您的站点，然后单击下一步。

步骤 2：在 Director 中配置桌面探测

限制：
如果从启用了交互式登录消息横幅的 Windows VDA 启动桌面测试，探测将失败。这是因为等待接受交互式登录消息会导致超时。 要在服务器 VDA 上禁用登录消息。转到“计算机配置”>“Windows 设置”>“安全设置”>“本地策略”>“安全选项”。
删除以下字段中的文本并更新 Microsoft 策略。
  • 交互式登录：尝试登录用户的消息文本
  • 交互式登录：尝试登录用户的消息标题
将探测用户分配给此已禁用交互式登录消息横幅的特定服务器 VDA，以确保探测能够通过桌面启动状态。
有关详细信息，请参阅 <https://learn.microsoft.com/zh-cn/windows/security/threat-protection/security-policy-settings/interactive-logon-message-text-for-users-attempting-to-log-on>。
  1. 转到 配置 > 桌面探测配置。
  2. 要创建探测，请输入详细信息并单击 Save。
    Director 配置
注意：
在 Alerts > Email Server Configuration 中配置您的电子邮件服务器。
桌面探测配置完成后，代理需要 10 分钟才能准备好开始探测。然后，它会在下一个小时开始运行配置的探测。

步骤 3：探测执行

代理根据其定期从 Director 获取的探测配置运行桌面探测。它使用 StoreFront 串行启动选定的桌面。代理通过 Monitor 数据库将结果报告回 Director。故障在五个特定阶段报告：
  • StoreFront 可达性 - 配置的 StoreFront URL 不可达。
  • StoreFront 身份验证 - 配置的 StoreFront 凭据无效。
  • StoreFront 枚举 - StoreFront 枚举桌面列表中不包含要探测的桌面。
  • ICA® 下载 - ICA 文件不可用。
  • 桌面启动 – 无法启动桌面。

步骤 4：查看探测结果

您可以在桌面页面中查看最新的探测结果。
Director 桌面分析页面
要进一步进行故障排除，请单击探测结果链接以在趋势 >探测结果 > 桌面探测结果页面上查看更多详细信息。
Director 桌面探测结果
此页面上提供了过去 24 小时或过去 7 天的合并探测结果数据。您可以查看探测失败的阶段。您可以按特定桌面、探测失败阶段或端点计算机筛选表格。