管理

Last published : Nov 13, 2026
允许您查看用户和代理统计信息以及管理活动。
Related information
监控

用户统计信息

显示有关您的 Workspace Environment Management™ (WEM) 部署的用户统计信息。每次用户登录其代理计算机时，都会收集相关信息，然后在此处显示为表格记录。
注意：
受限管理员只能查看其分配范围内配置集中的用户的统计信息。
此页面包含以下信息：
  • 用户摘要。显示已登录其代理计算机的所有用户的计数，适用于所有配置集。
  • 用户历史记录。显示与所有配置集关联的所有用户的连接信息，包括上次连接时间（世界协调时间，UTC）、上次连接的计算机名称以及会话代理类型（UI 或 CMD）和版本。
提示：
您可以使用“筛选”来筛选列表。例如，显示特定配置集的所有用户计数以及指定日期范围内的用户计数。
您可以执行以下操作：
  • 刷新。更新用户统计信息列表。
  • 刷新图标。更新用户显示名称。当您将鼠标悬停在每条记录或任何用户显示名称上时，此图标会显示。
  • 清除过期记录。允许您从 WEM 服务数据库中删除过期记录。如果用户的上次登录时间超过 24 小时，则相应记录将过期。当您没有任何过期记录时，此选项不可用。注意：对于用户 ID 为本地系统的记录，此选项不可用。
  • 删除记录。从 WEM 服务数据库中删除记录。当您只选择一个代理且其相应记录已过期时可用。注意：对于用户 ID 为“本地系统”、“网络服务”或“NT Authority (本地服务)”的记录，此选项不可用。
  • 导出。允许您以 CSV 或 JSON 格式导出每条记录中的数据，这些数据可以在 Microsoft Excel 等程序中打开。
注意：
  • 受限管理员无法清除过期记录或删除记录。
  • 导出时，您必须应用包含配置集条件的筛选器。
要导出数据，请执行以下步骤：
  1. 单击“导出”。导出向导随即出现。
  2. 选择导出格式。可用选项：CSV 和 JSON。
  3. （可选）选择“将导出的副本保存到本地计算机”。导出文件将保存到浏览器的默认下载位置。
  4. 单击“导出”以开始导出过程。
重要提示：
  • 您最多可以导出 50,000 条记录。当要导出的记录数超过限制时，将仅导出前 50,000 条记录。建议您使用筛选器将记录数减少到 50,000 条或更少。
  • 导出正在进行时，您无法执行其他导出操作。
  • 如果导出未在 30 分钟内完成，您将不再收到相关通知。请转到“文件”以稍后查看导出结果。
  • 导出用户统计信息时，导出文件将保存到云存储。云存储具有存储限制。当达到限制时，您无法继续导出。在这种情况下，请转到“文件”并删除不必要的文件以释放空间。请参阅文件。

代理

此页面允许您查看代理信息并执行管理任务，例如刷新缓存、重置设置和检索代理信息。代理缓存同步由 WEM 云服务集中管理。缓存同步间隔默认为 30 分钟，不可配置。更改“高级设置”中的“代理缓存刷新延迟”设置将不起作用。

统计信息

列表视图

代理以表格形式列出，每行对应一个代理的详细信息。
此选项卡显示有关 WEM 部署中代理的统计信息。您可以查看 WEM 部署中代理的以下统计信息。
  • 所有配置集中用户已登录的代理总数。
    提示：
    • 如果您在筛选条件中指定了配置集，则会显示该配置集的注册代理总数，以及过去 24 小时和过去 30 天内注册的代理数。
    • 当您使用 CEM (Citrix Endpoint Management™) 托管配置集时，不允许回调任务，因为这些代理是只读记录。
  • 所有已注册配置集的代理的连接信息，包括上次连接时间、上次连接的计算机名称以及代理版本。
  • 同步状态列提供有关代理缓存与 WEM 服务上次同步结果的信息。
    • 成功（复选标记图标）。表示上次同步成功，同步结果已报告给管理控制台。
    • 未知（感叹号图标）。表示同步正在进行中、尚未开始，或者结果未报告给管理控制台。
    • 失败（错误图标）。表示上次同步失败。
  • 最近连接列提供以下信息：
    • 联机（复选标记图标）。表示代理处于联机状态。代理已在特定时间间隔内将统计信息上传到 WEM 服务。
    • 空白列字段表示代理处于脱机状态。
  • 配置文件管理运行状况列提供有关环境中配置文件管理运行状况状态的信息。
    配置文件管理运行状况状态对代理主机执行自动化状态检查，以确定配置文件管理是否已优化配置。您可以从每台代理计算机上的输出文件 (%systemroot%\temp\UpmConfigCheckOutput.json) 中查看这些检查的结果，以识别特定问题。此功能每天或每次 WEM 代理主机服务启动时执行状态检查。要手动执行状态检查，请选择代理，然后从操作栏中选择运行配置文件管理运行状况检查。每个状态检查都会返回一个状态。要查看最新状态，请单击刷新。配置文件管理运行状况列中的图标提供有关配置文件管理运行状况状态的常规信息：
    • 良好（复选标记图标）。表示配置文件管理状况良好。
    • 通知（右上角带有蓝色圆点的对勾图标）。表示配置文件管理处于可接受状态。
    • 警告（右上角带有橙色圆点的对勾图标）。通知配置文件管理处于次优状态。次优状态可能会影响用户在部署中使用配置文件管理的体验。此状态不一定需要您采取措施。要查看详细报告，请使用更多中的查看配置文件管理运行状况检查报告选项。
    • 错误（错误图标）。表示配置文件管理配置不正确，导致其无法正常运行。
    • 无效（禁用图标）。当找不到或未启用配置文件管理时显示。
    如果状态检查未反映您的体验，或者未检测到您遇到的问题，请联系Citrix 技术支持。
您可以执行以下操作：
  • 任务历史记录。列出过去 24 小时内启动的代理任务。单击代理页面上的任务历史记录会将您定向到任务历史记录页面，以检查已启动任务的进度和结果。
  • 要显示的列。允许您通过选择要显示的列来自定义表格。
  • 刷新。更新代理列表。
  • 清除过期记录。允许您从 WEM 服务数据库中删除过期记录。如果用户的上次登录时间超过 24 小时，则相应的记录将过期。当您没有任何过期记录时，此选项不可用。
  • 查看详细信息。允许您查看有关代理的详细信息。
  • 设置为集线器代理。允许您将选定的代理设置为集线器代理。
  • 配置集线器代理。允许您选择要将代理设置为集线器代理的配置集。
  • 导出。允许您以 CSV 或 JSON 格式导出每条记录中的数据，这些数据可以在 Microsoft Excel 等程序中打开。
注意：
  • 此页面仅显示您至少具有只读权限的配置集中的代理。
  • 只有完全管理员才能清除过期记录、设置为 Hub Agent 和配置 Hub Agent。
  • 导出时，必须应用包含配置集条件的筛选器。
要导出数据，请执行以下步骤：
1.  Click **Export**. The export wizard appears.
1.  Select the export format. Available options: CSV and JSON.
1.  Optionally, select **Save a copy of the export to your local machine**. The export is saved to the default download location of your browser.
1.  Click **Export** to start the export process.

> **Important:**
>
  • 您最多可以导出 50,000 条记录。当要导出的记录数超过限制时，将只导出前 50,000 条。建议您使用筛选器将记录数减少到 50,000 条或更少。
  • 导出正在进行时，您无法执行其他导出。
  • 如果导出未在 30 分钟内完成，您将不再收到有关它的通知。请转至 Files 以稍后查看导出结果。
  • 导出代理统计信息时，导出将保存到云存储。云存储有存储限制。达到限制时，您无法继续导出。在这种情况下，请转至 Files 并删除不必要的文件以释放空间。请参阅 Files。
More 菜单中提供了以下选项。将这些选项应用于未加入域和已注册的代理时，请考虑以下事项：
  • 代理版本必须为 2207.1.0.1 或更高版本。
  • 目标代理不会立即收到执行这些任务的通知。当目标代理或同一子网上的另一个代理连接到 Citrix Cloud™ 以刷新设置时，会发送通知。因此，在代理端执行任务之前可能会有延迟。同一子网上的代理越多，延迟就越短。
  • 最大延迟是 SQL Settings Refresh Delay 值的 1.5 倍。默认情况下，SQL Settings Refresh Delay 值为 15 分钟。请参阅 Service options。因此，在这种情况下，最大延迟为 22.5 (1.5 x 15) 分钟。
注意：
仅当您选择的代理不超过 50 个时，More 菜单才可用。
代理：
  • 刷新缓存。触发本地代理缓存（WEM 配置数据库的代理端副本）的刷新。刷新缓存会将本地代理缓存与基础结构服务同步。此选项仅适用于版本低于 2401.1.0.1 的 WEM 代理。
  • 刷新代理主机设置。触发用户环境中代理服务设置的刷新。这些设置包括高级、优化、转换器和非用户分配的设置。版本为 2401.1.0.1 或更高版本的最新 WEM 代理会在代理主机设置刷新过程中自动同步代理缓存。由于 WEM 云服务内部工作流，代理缓存同步的最大延迟可能为（代理主机设置刷新延迟 x 1.5）+ 40 分钟。例如，如果默认代理主机设置刷新延迟（也称为 SQL 设置刷新延迟）为 15 分钟，则最大代理缓存同步延迟为 15 分钟 x (1.5 + 40 分钟) = 62.5 分钟。
  • 刷新 UI 模式代理。将用户分配的操作应用于 WEM 代理。这些操作包括网络驱动器、打印机、应用程序等。刷新代理时，它会与基础架构服务通信。基础架构服务会使用 WEM 数据库验证代理主机身份。
    重要提示：
    • “刷新 UI 模式代理”选项仅适用于自动启动（非最终用户或使用脚本启动）的 UI 模式代理。此选项不适用于 CMD 模式代理。
    • 并非所有设置都可以刷新。某些设置（例如，环境和组策略设置）仅在启动或登录时应用。
  • 从代理检索统计信息。使代理能够将统计信息上传到基础架构服务。
您也可以在代理端执行刷新操作。但是，这些操作的行为会因实际情况而异。有关详细信息，请参阅代理端刷新操作。
配置文件：
  • 重置配置文件管理设置。清除注册表缓存并更新关联的配置设置。如果配置文件管理设置未应用于您的代理，请单击重置配置文件管理设置。您可能需要单击刷新才能使此选项可用。
    注意：
    如果在 WEM 管理控制台中配置重置配置文件管理设置后设置未应用于代理，请参阅 CTX219086 以获取解决方法。
  • 运行配置文件管理运行状况检查。对目标代理计算机执行状态检查，以确定配置文件管理是否已优化配置。选择此选项后，将显示运行配置文件管理运行状况检查向导。选择要在运行状况检查报告中涵盖的配置文件管理设置，然后单击运行。请注意以下事项：
    • 默认情况下，运行状况报告涵盖所有设置。对于早于 2205.1.0.1 版本的代理，您对报告中涵盖的设置范围所做的更改不会生效。
    • 您可能需要一段时间才能看到运行状况报告。在报告中，如有必要，请刷新视图。
    • 单击查看报告可直接访问报告。
    发送给代理的通知
  • 查看配置文件管理运行状况检查报告。提供对与目标代理计算机相关的配置文件管理运行状况报告的快速访问。有关配置文件管理运行状况报告的详细信息，请参阅报告。
  • 重置 Microsoft USV 设置。清除注册表缓存并更新关联的配置设置。如果 Microsoft USV 设置未应用于您的代理，请单击重置 Microsoft USV 设置。您可能需要单击刷新才能使此选项可用。
电源管理：
  • 关机。允许您关闭选定的代理。
  • 重新启动。允许您重新启动选定的代理。
  • 睡眠。允许您将选定的代理置于睡眠模式。此选项仅在目标计算机支持睡眠模式时有效。
  • 休眠。允许您将选定的代理置于休眠模式。此选项仅在目标计算机支持休眠模式时有效。
  • 唤醒。允许您唤醒选定的代理。要使此选项生效，请转到 Legacy Console > Advanced Settings > Configuration > Wake on LAN 并选择 Enable Wake on LAN for Agents。此外，请确保目标计算机满足硬件要求并配置了相关的 BIOS 设置。有关详细信息，请参阅 Wake on LAN。
    提示：
    • 关闭或重新启动代理时，您可以指定在关闭或重新启动开始前的延迟时间（以秒为单位）。用户会收到提示，告知计算机将在您指定的时间内关闭或重新启动。关机提示示例：Your administrator has initiated the shutdown of your machine from the Workspace Environment Management console. The machine shuts down in 60 seconds.。重新启动提示示例：Your administrator has initiated the restart of your machine from the Workspace Environment Management console. The machine restarts in 60 seconds.。
    • 请考虑睡眠和休眠之间的区别。在睡眠模式下，计算机上的所有操作都将停止，所有打开的文档和应用程序都将放入内存中。计算机进入低功耗状态。在休眠模式下，打开的文档和正在运行的应用程序将保存到硬盘。计算机完全关闭，不消耗任何电量。
    • 要验证目标计算机是否支持睡眠和休眠模式，请转到该计算机并运行以下 PowerShell 命令：powercfg /a。
处理 Citrix Optimizer。将设置应用于代理，以便 Citrix Optimizer 设置的更改立即生效。
运行脚本化任务。允许您在目标代理计算机上运行脚本化任务。选择此选项后，将显示运行脚本化任务向导。配置以下设置，然后单击运行。有关每个设置的详细信息，请参阅脚本化任务设置。
注意：
此选项不适用于未加入域的代理。
  • 任务。选择要运行的脚本化任务。
  • 将参数传递给脚本化任务。选择是否将参数传递给脚本化任务。启用后，您可以在运行时将输入作为参数变量提供给脚本化任务。
  • 输出文件。选择是否要收集任务输出的文件。如果选中，则在为任务生成的报告中包含输出文件内容。然后，您可以在报告中查看输出文件内容，而无需访问用户环境中的文件。
  • 突出显示关键字。指定您希望报告突出显示的关键字。您可以输入多个关键字。输入关键字后，按 Enter 键添加另一个。如果指定，生成的报告中与您的关键字匹配的报告内容将在“输出文件内容”和“控制台输出”部分中突出显示。
  • 突出显示正则表达式匹配项。输入一个描述您要突出显示内容的正则表达式。正则表达式必须符合 .NET 正则表达式库语法，该语法与 PCRE 兼容。有关详细信息，请参阅 脚本化任务设置。
运行交付任务。要启用此选项，请选择绑定到同一配置集的代理。要快速运行交付任务，您可以选择从此页面运行交付任务。单击“运行交付任务”，然后从下拉列表中选择交付任务，以在代理上运行所选的交付任务。如果您在任务中配置规则以确定哪些代理必须运行该任务，则当您选择特定代理来运行按需任务时，这些规则将被忽略。
重置操作。允许您通过清除适用代理计算机上所有与操作相关的注册表项来重置您分配的所有操作。
删除记录。从 WEM 服务数据库中删除记录。如果代理仍处于活动状态，则此选项不可用。当您只选择一个代理且其相应记录已过期时可用。

摘要视图

代理统计信息页面上的摘要视图显示了四个图表，这些图表根据连接状态、配置文件管理运行状况、代理版本和上次配置集提供代理的统计结果。“摘要”视图中显示了四个图表。单击“刷新”将使用最新结果重新加载所有四个图表。

注册

此选项卡显示数据库中记录的代理的注册状态。
重要提示：
WEM 代理必须向 WEM 服务注册，以便可以对其应用设置。一个代理只能绑定到一个配置集。
您可以查看以下信息：
  • 设备名称。运行代理的计算机名称。
  • 注册状态。代理的注册状态：已注册或未注册。
  • 描述。提供有关注册成功或失败的更多信息：
    • 代理 <agent name> 绑定到配置集 <configuration set name>。表示 WEM 服务正在将必要的计算机相关设置发送到代理以用于配置集。
    • 代理 <agent name> 未绑定到任何配置集。表示 WEM 服务无法为代理解析任何配置集。如果启用了将设置应用于未绑定代理，则“未绑定代理”配置集的设置将应用于该代理。有关将设置应用于未绑定代理的详细信息，请参阅目录对象。
    • 代理 <agent name> 多次绑定到配置集 <configuration set name>。这不会阻止 WEM 服务将设置应用于代理。
    • 代理 <agent name> 已向 WEM 服务注册，用于通过 Citrix Endpoint Management 进行管理。仅显示用于 Endpoint Management 管理的代理。
    • 代理 <agent name> 绑定到多个配置集。表示 WEM 服务无法为代理解析配置集，因为代理绑定到多个配置集。
如有必要，使用搜索优化结果。搜索仅针对设备名称和描述运行。默认情况下，搜索仅限于未注册的代理。要取消限制，请启用仅显示未注册的代理。
要解决注册错误，请执行以下任一操作：
  • 编辑 Active Directory 层次结构（计算机、计算机组和 OU 之间的关系），以便代理不会多次绑定到相同的配置集。
  • 在目录对象中编辑 WEM 层次结构，以便代理仅绑定到一个配置集。
  • 将设置应用于未绑定代理（如果尚未完成），以便将“未绑定代理”配置集的设置应用于未绑定代理（尚未在目录对象中添加的代理）。
进行这些更改后，使用刷新 UI 模式代理选项刷新代理。

中心代理

中心代理充当 WEM 服务与您的本地资源（例如 SMB 共享）之间的桥梁。指定中心代理后，WEM 服务即可访问本地源。

将代理指定为中心代理

为了使 WEM 能够访问您的本地资源，请为您的配置集指定中心代理。
请按照以下步骤将代理指定为多个配置集的中心代理：
  1. 转到 监控 > 管理 > 代理。
  2. 在 统计信息 选项卡上，根据需要选择一个代理，然后单击 设置为中心代理。
  3. 在出现的 设置为中心代理 页面上，选择要将此代理设置为中心代理的配置集。
  4. 点击 完成。
    该代理将显示在 中心代理 选项卡上。
注意：
为确保正常运行，中心代理必须连接到可以访问本地资源和所选配置集中代理的网络。

查看和管理中心代理

中心代理选项卡显示部署中的所有中心代理及其详细信息：
  • 状态： 在线、离线、找不到代理或其他连接更新。
  • 关联配置集的列表。
您可以根据需要管理中心代理：
  • 要刷新中心代理的状态，请单击状态旁边的刷新图标。
  • 要更改与中心关联的配置集列表，请单击代理记录末尾的 配置 图标。
  • 要将中心代理降级为普通代理，请单击代理记录末尾的 删除 图标。

设置

默认情况下，代理通过其 MAC 地址进行识别。如果您的代理计算机没有唯一的 MAC 地址，请启用“使用备用代理标识符”选项以使用确保唯一性的备用标识符。
注意：
  • 切换状态更改：当切换状态更改时，WEM 代理需要重新启动服务才能根据新的切换状态运行。代理在服务启动期间读取切换状态。
  • 记录重复：切换到使用唯一代理身份后，会出现代理信息和统计记录重复的情况。24 小时后单击“清除过期记录”按钮以解决重复问题。
  • 报告聚合：切换到使用唯一代理身份后，由于新的代理身份，新报告将不会与在切换激活之前生成的旧报告聚合。 Hub 代理：必须重新配置 Hub 代理。

配置配置文件管理运行状况检查

WEM 可以检查 Citrix Profile Management 是否在您的代理计算机上进行了优化配置。有关详细信息，请参阅配置配置文件管理运行状况检查。