应用程序和桌面探测

Last published : Nov 13, 2026
应用程序和桌面探测通过使用 StoreFront 串行测试启动站点中发布的应用程序和桌面，自动检查其运行状况。探测结果可在 Director 中查看。
Related information
导向器

要求

  • Delivery Controller 运行版本 7.18 或更高版本用于应用程序探测，运行版本 1906 或更高版本用于桌面探测。
  • 运行探测代理的端点计算机是 Windows 计算机，其中安装了适用于应用程序探测的 Citrix Workspace™ app for Windows 1808 或更高版本，以及适用于桌面探测的 1906 或更高版本。不支持适用于统一 Windows 平台 (UWP) 的 Workspace 应用程序。
  • Citrix Probe Agent 支持通过 StoreFront 和 Citrix Workspace 使用 Active Directory 凭据进行身份验证。如果端点设备通过 Citrix Gateway 连接到 StoreFront / Workspace，则可以使用 Citrix Gateway 域凭据或多重身份验证 (MFA) 进行身份验证。Citrix Probe Agent 不支持其他身份验证方法，例如单点登录 (SSO)。
    注意：
    • 如果用户在 Citrix Cloud™ 上启用了登录策略或条件身份验证，探测代理将无法登录 Storefront 或 Citrix Workspace 应用程序。
    • 探测代理仅支持 Active Directory 身份验证来对 Citrix Workspace app 进行身份验证。
  • Citrix Probe Agent 仅在未部署代理服务器或负载平衡器（如 Citrix Gateway 或 Citrix ADC）时才起作用。
  • 确保要在安装探测代理的端点计算机上安装 Microsoft .NET Framework 4.7.2 或更高版本。
运行探测所需的用户帐户或权限：
  • 在每台端点计算机上使用唯一的 StoreFront 用户进行探测。StoreFront 用户无需是管理员；探测可以在非管理员上下文中运行。
  • 具有 Windows 管理员权限的用户帐户，用于在端点计算机上安装和配置 Citrix Probe Agent。
  • 用户必须是与用于应用程序或桌面启动的 VDA 相同的域的成员。探测代理目前不支持多个域。
  • 重新使用现有用户帐户进行探测可能会导致用户从其活动会话中注销。具有以下权限的完整管理员用户帐户或自定义角色：
    • 交付组权限：
      • 只读
    • Director 权限：
      • 创建\\编辑\\删除警报电子邮件服务器配置 - 如果电子邮件服务器尚未配置
      • 创建\\编辑\\删除探测配置
      • 查看配置页面
      • 查看趋势页面

配置

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

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

Citrix Probe Agent 是一个 Windows 可执行文件，它模拟用户通过 StoreFront 实际启动应用程序或桌面的过程。它根据 Director 中的配置测试启动，并将结果报告回 Director。
  1. 确定要运行探测的端点计算机。
  2. 具有管理权限的用户可以在端点计算机上安装和配置 Citrix Probe Agent。从Citrix 下载页面下载 Citrix Probe Agent 可执行文件。下载链接也可在 Director 的探测选项卡中找到。
    探测配置。
  3. 如果您有聚合站点，请选择“启用 Workspace (StoreFront) 站点聚合”选项以启用聚合站点中的应用程序和桌面枚举。
  4. 选择身份验证方法并输入相关凭据。凭据经过加密并安全存储。
  5. 使用您的 StoreFront Active Directory 凭据进行配置。在每台端点计算机上配置一个唯一的 Workspace (StoreFront) 用户。 探测代理
  6. 如果您的端点通过 Citrix Gateway 连接到 StoreFront，请选择 Citrix Gateway 选项并使用您的 Citrix Gateway 域凭据进行配置。
    探测代理
  7. 如果您的网关支持多重身份验证选项，请选择该选项并输入 16 位身份验证密钥。此选项仅适用于使用单一登录方案配置了 LDAP 和原生 OTP 的 Citrix Gateway。
  8. 在“配置以显示探测结果”选项卡中，输入您的 Director 凭据，然后单击“验证”。
    探测代理
  9. 选择您的站点，然后单击下一步。
  10. 在查看摘要选项卡中，确保配置的详细信息准确无误。如果需要进行更改，请转到相应的选项卡并进行更新。
注意：
您可以使用 Automating Citrix Probe Agent Installation and Configuration 中包含的 PowerShell 脚本来自动安装和配置 Citrix Probe Agent。

步骤 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. 在“创建探测”页面中，输入探测的名称。
  3. 选择计划：
    1. 选择您希望探测运行的星期几。
    2. 输入您希望探测运行的开始时间。
    3. 此外，您可以选择“一天内重复”选项。输入结束时间以及您希望探测在一天内重复的间隔。例如，以下配置有助于在每周一、周三、周四和周日，从 12:08 到 16:34 之间每 30 分钟运行一次应用程序探测。
  4. 根据间隔选择建议的要探测的应用程序或桌面数量。
  5. 选择必须运行探测的端点计算机。
  6. 输入管理员的电子邮件地址以发送失败探测的结果。在警报 > 电子邮件服务器配置中配置您的电子邮件服务器。
Director 配置
在此配置中，应用程序会话将在每周一、周三、周四和周日的 12:08、12:38、13:08 等时间启动，直到 16:08。
注意：
  • 配置后，代理将在下一个小时开始运行配置的探测。
  • 在引入“一天内重复”选项之前设置的探测将继续按其计划时间运行。默认情况下，这些探测的“一天内重复”选项处于禁用状态。
  • 建议您配置探测，使每次运行间隔 5 分钟，以防止重叠。

步骤 3：探测执行

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

步骤 4：查看探测结果

您可以在“探测”中查看探测结果。“探测”视图全面概述了探测结果。这些结果有助于主动分析和解决问题，从而为用户提供更流畅的会话启动体验。
“概述”选项卡在一个视图中提供了所有已配置探测的摘要。
Director 探测运行(/en-us/citrix-virtual-apps-desktops/current-release/media/dir-probe-metrics-chart.png)
您可以根据时间段、探测类型、端点名称、应用程序名称、桌面名称和探测结果类型筛选探测。符合筛选条件的探测将显示每个探测、应用程序/桌面和端点的以下详细信息。
“探测指标”显示了已安排、已计划、已跳过、成功和失败运行的计数。
  • 已完成运行 – 已完成的探测运行次数。
  • 失败运行 – 失败的探测运行次数。
  • 跳过的运行 – 由于端点不活动或服务不可用而未能完成的运行次数。
  • 成功运行 – 在应用程序/桌面启动期间，在任何阶段都没有失败并成功完成的探测数量。
还会显示端点计算机的总数，以及活动和非活动计算机的数量。
探测失败阶段以可视化方式显示每个失败组的失败分布。通过分析大多数失败发生的阶段，可以更容易地解释探测结果并排除故障。图形表示显示了应用程序/桌面启动、ICA 文件下载、Storefront/Workspace 枚举、Storefront/Workspace 可达性和 Storefront/Workspace 身份验证的失败探测运行次数。
它有助于分析大多数失败发生的阶段。此信息有助于快速理解探测结果并排除故障。
某些探测运行可能无法完成，原因可能是端点处于非活动状态，或者服务不可用。
“探测运行”选项卡详细显示已完成的探测运行结果。您可以深入查看所选探测的每次单独运行的详细信息。您可以根据重要的关键点进行进一步筛选和分析。
Director 探测运行(/en-us/citrix-virtual-apps-desktops/current-release/media/dir-probe-runs.png)
您可以根据时间段、探测类型、端点名称、应用程序名称、桌面名称和探测失败阶段筛选探测运行。探测失败阶段显示探测失败的阶段。单击探测名称、计划运行、失败运行、应用程序/桌面名称链接也会将您带到“探测运行”页面，其中包含符合筛选条件的探测运行列表。