管理基本部署代理

Last published : Nov 13, 2026
您可以使用 Workspace Environment Management™ (WEM) 来管理基本部署代理。此功能提供了一种轻量级的 WEM 部署方法。您可以使用此部署方法轻松利用 WEM 基本功能，而无需部署后端组件，例如代理、数据库和控制台。

配置基本部署代理设置

当 WEM 代理处于基本模式时，默认启用一些优化功能。这些设置存储在预定义的代理缓存文件中。
  • VDA 计算机上的 CPU 峰值保护会自动开启。此设置会降低高 CPU 进程的优先级，以最大程度地减少对用户体验的影响：
    • CPU 峰值保护
    • 自动防止 CPU 峰值
    • 启用智能 CPU 优化
  • 自定义基本部署代理的设置。有关详细信息，请参阅配置组策略。基本模式可用的设置如下：
属性 类型 设置 默认 示例 注意
enableCpuSpikeProtection 布尔值 启用 CPU 峰值保护 是 是 CPU 峰值保护设置
enableCpuAutoProtection 布尔值 自动防止 CPU 峰值 是 是
cpuUsageLimitOfSpikeProtection 浮点型 CPU 使用率限制 (%) 70.0 70.0
enablePerCoreCpuUsageLimit 布尔值 设置相对于单个 CPU 核心的限制 否 否
perCoreCpuUsageLimitOfSpikeProtection 浮点型 相对于单个 CPU 核心的 CPU 使用率限制 (%) 80.0 80.0
cpuUsageLimitSampleTimeOfSpikeProtection 整型 采样时间限制 (秒) 30 30
idlePriorityTimeOfSpikeProtection 整数 空闲优先级时间 (秒) 180 180
enableLimitCpuCoreUsage 布尔值 启用 CPU 核心使用限制 否 否
cpuCoreLimitOfSpikeProtection 整数 CPU 核心使用限制 1 1
enableIntelligentCpuOptimization 布尔值 启用智能 CPU 优化 是 是
enableIntelligentIoOptimization 布尔值 启用智能 I/O 优化 否 否
排除CPU峰值保护中的进程 布尔值 从CPU峰值保护中排除进程 否 否
从CPU峰值保护中排除的进程 字符串数组 进程名称 [] ["devenv", "msbuild"]
禁用进程优先级继承 布尔值 防止子进程继承CPU优先级 否 否
禁用优先级继承的父进程 字符串数组 进程名称 [] ["devenv", "msbuild"]
启用内存工作集优化 布尔值 优化空闲进程的内存使用 是 是 内存优化设置
内存工作集优化的空闲采样时间 整数 空闲采样时间 (分钟) 30 30
idleStateLimitOfMemoryWorkingSetOptimization 整数 空闲状态限制 (%) 1 1
enableMemoryOptimizationThreshold 布尔值 限制优化 是 是
memoryOptimizationThreshold 整数 仅当总可用内存小于 (MB) 时优化 200 200
excludeProcessesFromMemoryWorkingSetOptimization 布尔值 从内存使用优化中排除进程 否 否
processesExcludedFromMemoryWorkingSetOptimization 字符串数组 进程名称 [] ["devenv", "msbuild"]
enableFastLogoff 布尔值 启用快速注销 是 是 快速注销设置
enableMultiSessionOptimization 布尔值 启用多会话优化 是 是 多会话优化
excludeProcessesFromMultiSessionOptimization 布尔值 从多会话优化中排除进程 否 否
processesExcludedFromMultiSessionOptimization 字符串数组 进程名称 [] ["devenv", "msbuild"]
agentServiceDebugModeEnabled 布尔值 启用代理服务调试模式 否 否 高级设置 > 代理设置 > 代理服务选项
enableLogonDurationAnalysis 布尔值 启用登录持续时间分析 是 是 登录持续时间分析
useAlternativeLocalReportLocation 布尔值 使用备用位置保存本地代理报告 否 否
alternativeLocalReportLocation 字符串 保存本地代理报告的备用位置 %PROGRAMDATA%\Citrix\WEM\Local Agent Reports D:\WEM Local Agent Reports
localReportMaxDays 整数 本地代理报告的最长保留天数 7 7
localReportMaxFilesPerEvent 整数 本地代理报告的最大保留数量 30 30
saveLogonDurationAnalysisToLocal 布尔值 将登录持续时间分析报告保存为本地代理报告 是 是
saveUpmHealthCheckToLocal 布尔值 将 UPM 运行状况检查报告保存为本地代理报告 是 是
saveProfileContainerInsightsToLocal 布尔值 将配置文件容器见解报告保存为本地代理报告 是 是
launchAgentOnLogon 布尔值 用户登录时自动启动代理 否 是
enableAgentInsightsManagement 布尔值 启用代理见解管理 否 是 代理见解设置
enableLargeFileScan 布尔值 在配置文件容器中启用大文件扫描 否 是
注意：
如果未配置自定义设置或自定义设置无效，WEM 代理将使用默认设置。
您可以指定 JSON 格式的字符串来自定义基本部署代理的设置。例如：
{
    "enableCpuSpikeProtection": true,
    "enableCpuAutoProtection": true,
    "enableIntelligentCpuOptimization": true,
}
基本部署的自定义设置

切换代理部署类型

要切换部署类型，请选择以下方法之一。
  • 利用代理组策略将代理切换到其他部署类型。有关详细信息，请参阅配置组策略。
  • 使用 WEM 运行状况检查工具切换到其他部署类型。

使用 WEM 登录持续时间功能

使用 WEM 登录持续时间功能的好处如下：
  • 当您登录到代理计算机时，WEM 代理会自动分析登录持续时间并生成报告。
  • 您可以使用 Citrix Environment Tool Hub 查看代理生成的报告。