高级设置

Last published : Nov 13, 2026
使用这些设置来控制 Workspace Environment Management™ (WEM) 代理如何以及何时处理操作。

代理设置

此页面允许您配置 WEM 代理行为。

代理选项

配置代理设置。
代理启动行为:
  • 登录时启动代理。控制代理是否在登录时运行。
  • 重新连接时启动代理。控制代理是否在用户重新连接到运行代理的计算机时运行。
  • 为管理员启动代理。控制代理是否在用户是管理员时运行。
  • 启用桌面兼容模式。确保代理与其运行的桌面兼容。此设置对于用户登录会话时启动代理是必需的。
  • 仅在已发布的应用程序中运行 CMD 代理。如果启用,代理将在已发布的应用程序中以 CMD 模式而不是 UI 模式启动。CMD 模式显示命令提示符而不是代理启动画面。有关 CMD 和 UI 模式的更多信息,请参阅CMD 和 UI 模式下的代理。
代理启动排除项:
  • 不为指定组启动代理。如果启用,则不会为属于指定用户组的任何用户启动 Citrix WEM 代理主机。
  • 仅为指定组启动代理。如果启用,则仅为属于指定用户组的用户启动 Citrix WEM 代理主机。
代理日志:
  • 启用代理日志记录。如果启用,代理将输出代理日志文件。
  • 调试模式。控制是否为代理启用详细日志记录。
刷新:
  • 刷新环境设置。如果启用,当代理刷新时,代理将触发用户环境设置的刷新。有关环境设置的信息,请参阅环境设置。
  • 刷新系统设置。如果启用,当代理刷新时,代理将触发 Windows 系统设置(例如,Windows 资源管理器和控制面板)的刷新。
  • 环境设置更改时刷新。如果启用,当任何环境设置更改时,代理将在端点上触发 Windows 刷新。
  • 刷新桌面。如果启用,当代理刷新时,代理将触发桌面设置的刷新。有关桌面设置的信息,请参阅桌面。
  • 刷新外观。如果启用,当代理刷新时,代理将触发 Windows 主题和桌面墙纸的刷新。
自动刷新(仅限 UI 代理):
  • 启用自动刷新。如果启用,Citrix WEM 代理主机将自动刷新。默认情况下,刷新延迟为 30 分钟。
脱机模式:
  • 启用脱机模式。如果禁用,当代理无法连接到 WEM 服务时,它不会回退到其缓存。
  • 即使在线也使用缓存。如果启用,代理始终从其缓存中读取其设置和操作(缓存是在代理服务循环时构建的)。
  • 使用缓存加速操作处理。如果启用,代理将通过从代理本地缓存而不是基础结构服务中检索相关设置来处理操作。这样做可以加快操作的处理速度。默认情况下,此选项处于启用状态。如果要恢复到以前的行为,请禁用此选项。
    重要提示:
    • 代理本地缓存会定期与 WEM 服务同步。因此,操作设置的更改需要一些时间才能生效,具体取决于您为“代理缓存刷新延迟”选项(在“高级设置 > 代理设置 > 代理服务选项”磁贴中)指定的值。
    • 为了减少延迟,请指定一个较低的值。要使更改立即生效,请导航到“监视 > 管理 > 代理 > 统计信息”,选择目标代理,然后在“更多”中选择“代理 > 刷新缓存”。
    • 我们建议您不要禁用此设置。否则,在网络连接不佳的情况下,用户可能会遇到用户体验下降的问题。如果禁用此设置,在 WEM 服务流量很大的情况下,您通过管理控制台配置的操作可能无法应用于代理主机。

代理服务选项

配置代理主机服务的设置。
代理缓存刷新延迟(分钟)。此设置控制 Citrix WEM 代理主机服务等待刷新其缓存的时间。刷新操作使缓存与 WEM 服务数据库保持同步。默认值为 30 分钟。使用此选项时,请记住以下几点:
  • 缓存与 WEM 服务数据库同步的最小间隔为 15 分钟。键入一个等于或大于 15 分钟的整数。
  • 实际同步间隔可能会有所不同。根据指定的值,WEM 代理会计算一个间隔,每次代理缓存刷新延迟超时时,都会从该间隔中选择一个随机值作为实际同步间隔。例如,您将值设置为 30 分钟。代理会从以下间隔中选择一个随机值:。
SQL 设置刷新延迟(分钟)。此设置控制 Citrix WEM 代理主机服务等待刷新其 SQL 连接设置的时间。默认值为 15 分钟。键入一个等于或大于 15 分钟的整数。
代理额外启动延迟(毫秒)。此设置控制 Citrix WEM 代理主机服务等待启动代理主机可执行文件的时间。默认值为 0。
提示:
在您希望代理主机首先完成必要工作的场景中,您可以指定代理应用程序启动器 (VUEMAppCmd.exe) 等待的时间。VUEMAppCmd.exe 确保代理主机在 Citrix DaaS(以前称为 Citrix Virtual Apps and Desktops 服务)和 Citrix Virtual Apps and Desktops 发布应用程序启动之前完成环境处理。要指定等待时间,请配置 VUEMAppCmd 额外同步延迟设置,该设置在“代理主机配置”组策略中可用。有关详细信息,请参阅安装和配置代理。
启用调试模式。控制是否为连接到配置集的所有代理启用详细日志记录。
绕过 ie4uinit 检查。默认情况下,Citrix WEM 代理主机服务会等待 ie4uinit 运行,然后才启动代理主机可执行文件。此设置强制 Citrix WEM 代理主机服务不等待 ie4uinit。

代理升级

为绑定到此配置集的所有代理安排自动升级。
代理升级现在在新功能“应用程序包交付”中完成。要配置和安排代理升级,请转到“应用程序包交付 > 交付任务”并创建“WEM 代理升级”交付任务。以前配置的设置会自动转换为交付任务。

杂项

配置通知、初始环境清理和局域网唤醒等设置。
通知:
  • 启用连接状态更改通知。如果启用,当与基础架构服务的连接丢失或恢复时,代理会在代理主机上显示通知消息。Citrix 建议您不要在质量较差的网络连接上启用此选项。否则,连接状态更改通知可能会在端点(代理主机)上频繁出现。
额外功能:
  • 初始环境清理。如果启用,代理会在首次登录时清理用户环境。具体来说,它会删除以下项目:
    • 用户网络打印机。
      • 如果在“清理操作”选项卡上启用了“保留自动创建的打印机”,则代理不会删除自动创建的打印机。
      • 如果在“清理操作”选项卡上启用了“保留特定打印机”,则代理不会删除列表中指定的任何打印机。
    • 除主驱动器网络驱动器之外的所有网络驱动器。
    • 所有非系统桌面、开始菜单、快速启动和“开始”按钮上下文菜单快捷方式。
    • 所有任务栏和“开始”菜单固定快捷方式。
  • 初始桌面 UI 清理。如果启用,代理会在首次登录时清理会话桌面。具体来说,它会删除以下项目:
    • 所有非系统桌面、开始菜单、快速启动和“开始”按钮上下文菜单快捷方式。
    • 所有任务栏和“开始”菜单固定快捷方式。
  • 启用用户组的跨域搜索。如果启用,代理将在所有 Active Directory 域中查询用户组。跨域搜索可能非常耗时。仅在必要时选择此选项。
  • 启用代理使用缓存的域搜索结果。如果启用,代理将使用域查询结果的缓存来提高性能和弹性。域查询结果最多缓存七天。
  • 检查应用程序是否存在。如果启用,代理将不会创建快捷方式,除非它确认应用程序存在于用户登录的计算机上。
  • 展开应用程序的环境变量。控制是否在处理应用程序目标路径和工作文件夹中的环境变量之前将其展开。
  • WEM 服务超时 (ms)。代理无法连接到基础架构服务时,切换到其自身缓存的超时值。默认值为 15000 毫秒。
  • 代理最大并行度。代理可以使用的最大线程数。默认值为 0(处理器物理允许的最大线程数)。1 表示单线程,2 表示双线程,依此类推。通常,此值无需更改。
  • 目录服务超时 (ms)。代理主机上目录服务的超时值,在此之后,代理将使用其自身的用户组关联内部缓存。默认值为 15000 毫秒。
  • 网络资源超时 (ms)。解析网络资源(网络驱动器或位于网络上的文件/文件夹资源)的超时值,在此之后,代理认为操作已失败。默认值为 500 毫秒。
局域网唤醒:
使用此选项卡可远程开启代理主机。WEM 会自动选择与目标代理位于同一子网上的代理,并使用这些代理作为局域网唤醒信使。此功能需要与局域网唤醒兼容的硬件。要使用此功能,请验证目标计算机是否满足硬件要求并已配置相关的 BIOS 设置。
为代理启用局域网唤醒。控制是否在 Windows 操作系统上配置设置以启用代理主机的局域网唤醒。如果选中,代理将配置以下系统设置:
  • 禁用网卡的节能以太网
  • 为网卡启用魔术包唤醒
  • 为网卡启用允许此设备唤醒计算机
  • 为网络适配器启用 仅允许幻数据包唤醒计算机
  • 禁用 启用快速启动
启用此选项后,导航到 监控 > 管理 > 代理 > 统计信息,从列表中选择一个或多个代理,然后在 更多 中选择 电源管理 > 唤醒 以唤醒所选代理。

操作设置

此页面允许您配置与操作处理和清理相关的设置。

操作处理

控制代理处理操作的方式和时间,以及是否从桌面删除未分配的操作。
登录和刷新时的操作处理。以下设置控制用户登录和代理刷新时代理处理的操作。
  • 登录和刷新时处理应用程序
  • 登录和刷新时处理打印机
  • 登录和刷新时处理虚拟驱动器
  • 登录和刷新时处理注册表
  • 登录和刷新时处理环境变量
  • 登录和刷新时处理端口
  • 登录和刷新时处理 INI 文件
  • 在登录和刷新时处理外部任务
  • 在登录和刷新时处理文件系统操作
  • 在登录和刷新时处理用户 DSN
  • 在登录和刷新时处理 FTA
其他设置:
  • 在登录时等待策略和 JSON 文件处理完成。如果您希望用户在所有设置(GPO 和 JSON 对象)处理完毕后才完成登录,请使用此选项。
重新连接时的操作处理。以下设置控制当用户重新连接到代理计算机时代理处理哪些操作。
  • 在重新连接时处理应用程序
  • 在重新连接时处理打印机
  • 在重新连接时处理网络驱动器
  • 在重新连接时处理虚拟驱动器
  • 在重新连接时处理注册表
  • 在重新连接时处理环境变量
  • 在重新连接时处理端口
  • 在重新连接时处理 INI 文件
  • 在重新连接时处理外部任务
  • 在重新连接时处理文件系统操作
  • 在重新连接时处理用户 DSN
  • 在重新连接时处理 FTA
取消分配时删除操作。如果启用这些设置,代理将在下次刷新时删除所有未分配的操作。
  • 取消分配时从桌面删除应用程序
  • 取消分配时从桌面删除打印机
  • 取消分配时从桌面删除网络驱动器
  • 取消分配时从桌面删除虚拟驱动器
  • 取消分配时从桌面删除注册表
  • 取消分配时从桌面删除环境变量
  • 取消分配时从桌面删除端口
  • 取消分配时从桌面删除文件系统操作
  • 取消分配时从桌面删除用户 DSN
  • 取消分配时从桌面删除 FTA
强制处理操作。如果启用这些设置,即使未进行任何更改,代理也会始终刷新这些操作。
  • 强制处理应用程序
  • 强制处理打印机
  • 强制处理网络驱动器
  • 强制处理虚拟驱动器
  • 强制处理环境变量
  • 强制处理端口
强制处理筛选器。如果启用,这些选项会强制代理在每次刷新时重新处理筛选器。
  • 强制处理应用程序的筛选器
  • 强制处理打印机的筛选器
  • 强制处理网络驱动器的筛选器
  • 强制处理虚拟驱动器的筛选器
  • 强制处理注册表的筛选器
  • 强制处理环境变量的筛选器
  • 强制处理端口的筛选器
  • 强制处理文件系统操作的过滤器
  • 强制处理用户 DSN 的过滤器
  • 强制处理 FTA 的过滤器
异步处理:
  • 异步处理打印机。如果启用,代理将异步处理打印机,而无需等待其他操作处理完成。
  • 异步处理网络驱动器。如果启用,代理将异步处理网络驱动器,而无需等待其他操作处理完成。

操作清理

此磁贴上的选项控制代理在启动时是否删除快捷方式或其他项目(网络驱动器和打印机)。当您将操作分配给用户或用户组时,您可能会发现您还可以控制快捷方式或项目的创建。例如,您可以指定在管理应用程序分配时创建应用程序快捷方式的位置。Workspace Environment Management 根据特定优先级处理这些选项:
  1. 在管理分配中为分配的操作配置的选项。
  2. 操作清理磁贴上显示的选项。
例如,假设您已在管理分配中为分配的应用程序启用了创建桌面快捷方式选项,并且应用程序快捷方式已在桌面上创建。即使您在操作清理磁贴上启用了启动时删除桌面快捷方式选项,当代理启动时,该快捷方式仍会保留在桌面上。
应用程序快捷方式。以下设置控制在启动时删除哪些快捷方式。
  • 启动时删除桌面快捷方式。
  • 启动时删除固定到任务栏的快捷方式。
  • 启动时删除快速启动快捷方式。
  • 在启动时删除“开始”菜单快捷方式。
  • 在启动时删除固定到“开始”菜单的快捷方式。
网络打印机:
  • 在启动时删除网络打印机。如果启用,代理将在启动时删除所有网络打印机。
网络驱动器:
  • 在启动时删除网络驱动器。如果启用,代理将在启动时删除所有网络驱动器。

UI 代理个性化

此页面允许您在用户环境中个性化代理(在 UI 模式下)的外观,并自定义用户与代理的交互方式。

外观和交互

自定义 UI 代理外观和交互。
启动画面和主题:
  • 自定义徽标。默认情况下,当代理启动或刷新时,用户会看到一个带有 Citrix Workspace™ Environment Management 徽标的启动画面。您可以指定一个可从用户环境访问的图像来替换该徽标。
  • 加载圆圈颜色。修改加载圆圈的颜色以适应您的自定义徽标。
  • 文本标签颜色。修改加载文本的颜色以适应您的自定义徽标。
  • UI 代理主题。为从 UI 代理打开的对话框选择一个外观主题。
  • 隐藏代理启动画面。如果启用,则在代理加载或刷新时隐藏启动画面。此设置在代理首次刷新时不会生效。
  • 重新连接时隐藏代理启动画面。如果启用,则在用户重新连接到代理计算机时隐藏启动画面。
  • 为已发布的应用程序隐藏代理启动画面。如果启用,则在运行代理的已发布的应用程序中隐藏代理启动画面。
  • 为已发布的应用程序隐藏代理图标。如果启用,已发布的应用程序将不显示代理图标。
用户交互:
  • 只有管理员才能关闭代理。如果启用,则只有管理员才能退出代理。因此,代理菜单中的“退出”选项在非管理员的端点上处于禁用状态。
  • 禁止管理员关闭代理。如果启用,管理员将无法退出代理。
  • 禁用管理刷新反馈。如果选中,则当管理员使用管理控制台刷新代理时,用户环境中不会出现通知。
  • 允许用户重置操作。控制是否在代理菜单中显示“重置操作”选项。默认情况下,此选项处于禁用状态。“重置操作”选项允许当前用户指定要在其环境中重置哪些操作。用户选择“重置操作”后,将显示“重置操作”对话框。在该对话框中,用户可以对要重置的内容进行精细控制。用户可以选择适用的操作,然后单击“重置”。这样做会清除相应的操作相关注册表项。
    注意:
    代理菜单中始终提供以下两个选项:“刷新”和“关于”。“刷新”选项会立即更新 WEM 代理设置。因此,在管理控制台中配置的设置会立即生效。“关于”选项会打开一个对话框,显示正在使用的代理的版本详细信息。
  • 允许用户管理应用程序。如果启用,代理菜单中的“管理应用程序”选项可供端点上的用户使用。用户可以单击该选项打开“管理应用程序”对话框并配置以下选项。默认情况下,此选项处于启用状态。
  • 允许用户管理打印机。如果启用,代理菜单中的“管理打印机”选项可供端点上的用户使用。用户可以单击该选项打开“管理打印机”对话框以配置默认打印机并修改打印首选项。默认情况下,此选项处于启用状态。
  • 在代理菜单中显示我的应用程序。如果启用,则在代理菜单中显示“我的应用程序”选项。如果显示,用户可以查看分配给他们的应用程序。
  • 在代理菜单中显示代理洞察。在代理菜单中显示“代理洞察”选项。可见时,用户可以从菜单中启用或禁用“代理洞察”。

帮助台选项

指定帮助和支持链接并配置屏幕捕获选项。

帮助和支持

  • 帮助链接。输入用户可以寻求帮助的网页链接。如果指定,用户将在代理菜单中看到“帮助”选项。单击它将打开网站。
  • 支持链接。输入用户可以访问支持相关信息的网页链接。如果指定,用户将在代理菜单中看到“支持”选项。单击它将打开网站。

屏幕捕获

启用屏幕捕获。控制是否在代理菜单中显示“捕获”选项。用户可以使用此选项打开屏幕捕获工具。该工具提供以下选项:
  • 新建捕获。截取用户环境中错误的屏幕截图。
  • 保存。保存屏幕截图。
  • 发送给支持人员。将屏幕截图发送给支持人员。
显示发送给支持人员选项。控制是否在屏幕捕获工具中显示“发送给支持人员”选项。如果启用,用户可以使用此选项将屏幕截图和日志文件以指定格式直接发送到指定的支持电子邮件地址。此设置需要一个正常工作的已配置电子邮件客户端。
支持电子邮件地址。输入电子邮件地址。
电子邮件模板。指定屏幕捕获工具用于发送支持电子邮件的电子邮件内容模板。此字段不能为空。
注意:
有关可在电子邮件模板中使用的哈希标签列表,请参阅动态令牌。仅当电子邮件模板中包含##UserScreenCaptureComment## hash-tag时,用户才会看到输入评论的选项。
自定义主题。指定屏幕捕获工具用于发送支持电子邮件的电子邮件主题模板。
使用 SMTP 发送电子邮件。如果启用,则使用 SMTP 而非 MAPI 发送支持电子邮件。

节电

指定何时关闭或暂停代理计算机。
  • 在指定时间关机。如果启用,代理将在指定时间自动关闭其运行所在的计算机。时间基于代理时区。
  • 空闲时关机。如果启用,代理将在计算机空闲(无用户输入)指定时间后自动关闭其运行所在的计算机。
  • 暂停而非关机。如果启用,代理将在指定时间或计算机空闲指定时间后暂停其运行所在的计算机。

监视首选项

此页面包含以下设置:
  • 操作处理结果。允许您收集操作处理结果并查看报告。选择要收集结果的操作。
    注意:
    结果每四小时上传一次。要立即从代理上传结果,请使用 Monitoring > Administration > Agents 中的“从代理检索统计信息”选项。
  • 组策略设置
  • JSON 文件
    • 组策略设置
    • 外部任务
    • JSON 文件
  • 其他设置。 配置代理报告的处理方式:
    • 将报告本地保存以在 Agent Insights 中显示。使代理能够将报告本地保存,以便它们显示在 Agent Insights 中。启用此设置后,将自动选择以下“要保存的报告”选项:
      • 要保存的报告。指定要本地保存的报告类型:
        • 登录分析:保存登录分析报告。
        • 配置文件见解:保存配置文件容器见解报告。
    • 为本地保存的代理报告设置备用位置。 指定保存报告的备用位置。
  • 优化和使用情况见解。让您深入了解应用程序行为。使用以下选项控制代理是否收集和上传数据以获取见解。
    • 启用优化和使用情况见解的数据收集和上传
    启用此选项后,数据更新可能需要几个小时才能完成。
  • 配置文件见解。让您深入了解 Profile Management 和 FSLogix 的配置文件容器。使用以下选项控制代理是否扫描配置文件容器上的大文件。
    • 启用大文件扫描
      如果启用,当容器使用量超过指定阈值时,对配置文件容器上的大文件运行扫描。扫描限制为每 24 小时一次。您可以根据文件大小指定哪些文件被视为大文件。
  • Profile Management 运行状况检查。让您指定要在 Profile Management 运行状况检查报告中涵盖的设置范围。运行状况检查每 24 小时运行一次或按需运行。选择要在报告中涵盖的Profile Management 设置。
    注意:
    • 要按需运行运行状况检查,请使用 Monitoring > Administration > Agents 中的“运行 Profile Management 运行状况检查”选项。
    • 您所做的更改仅反映在新报告中,不影响现有报告。每个代理只保留最新报告。
  • 安全日志。让您收集安全规则执行日志并生成报告。选择要包含在报告中的安全方面。
    • “特权提升”安全方面控制事件的日志收集,包括“EXE 特权提升”、“MSI 特权提升”和“自提升”。
    • 当您选择“进程层次结构控制”安全方面时,“已阻止的活动”选项默认处于选中状态,但可以编辑“允许的活动”选项。
    • 当您选择“应用程序安全日志”安全方面时,“已阻止的活动”选项默认处于选中状态,而“已审核的活动”和“允许的活动”选项可以编辑。
    有关更多详细信息,请参阅报告。
  • 应用程序交付结果。允许您收集应用程序交付结果并生成报告。如果选中“应用程序交付任务结果”复选框,代理将收集报告并将其上传到 WEM 服务器。有关更多详细信息,请参阅报告。
    注意:
    • 结果每四小时上传一次。要立即从代理上传结果,请使用监控 > 管理 > 代理中的“从代理检索统计信息”选项。
  • VHD 管理。收集结果并生成有关 VHD 管理相关操作的报告。如果选择 VHD 磁盘压缩,代理将收集相关报告并将其上传到 WEM 服务。有关更多信息,请参阅报告。

文件共享

此页面允许您添加 WEM 可以连接的 SMB 共享。然后,您可以为所需功能配置共享,以便这些功能可以根据需要使用这些共享。使用 SMB 共享可减少网络流量,并缩短将文件下载到代理计算机所需的时间。
下图概述了文件共享的工作原理。
文件共享技术概述
文件下载从特定的代理计算机开始。此初始下载通过 Citrix Cloud 进行。下载完成后,代理会将文件上传到文件共享,供其他代理使用。因此,后续下载直接通过文件共享进行,而不是通过 Citrix Cloud。
配置文件共享后,当需要下载文件时,代理首先验证文件在文件共享上是否可用。如果可用,则通过文件共享进行下载。如果不可用,代理将连接到 Citrix Cloud 进行初始下载,然后将下载的文件上传到文件共享。

添加 SMB 共享

输入 SMB 共享以及具有访问该共享权限的管理员凭据。完成以下步骤:
  1. 在“文件共享”页面上,单击“添加 SMB 共享”。
  2. 在“添加 SMB 共享”向导中,填写以下信息:
    • SMB 共享。以 \\ServerName\ShareName 形式输入路径,其中 ServerName 是托管 SMB 共享的服务器的 FQDN 或 IP 地址,ShareName 是 SMB 共享的名称。
    • 用户名。以 domain\username 形式输入名称。
    • 密码。输入用于访问 SMB 共享的密码。
  3. 单击“完成”以保存并退出。

选择功能要使用的 SMB 共享

从列表中选择一个 SMB 共享。该设置默认为“无”。为功能选择共享时,请考虑以下事项:
  • 凭据必须对共享具有完全读/写权限。
  • 要连接到共享,代理必须在本地系统帐户下运行。
  • 配置后,功能会根据需要使用共享 — 与共享的连接是非持久性的,仅在必要时建立。
  • 如果共享不可访问,代理将回退到通过 Citrix Cloud 下载文件。
您还可以更改或删除“应用程序包交付”功能的 SMB 共享。

选择相关服务要使用的 SMB 共享

从列表中选择一个或多个 SMB 共享。选择后,部署中在本地系统帐户下运行的服务(例如,Citrix Profile Management 服务)可以根据需要使用这些共享 — 与共享的连接是持久的。此功能使这些服务能够通过连接访问共享。

SMB 配置示例

有关如何配置 SMB 共享的示例: