配置文件管理策略

Last published : Nov 13, 2026
本文介绍了 .adm 和 .admx 文件中策略的重要方面。

配置文件管理变量

在此版本的配置文件管理中,以下变量可用于组策略和 .ini 文件。
对于定义文件和注册表项的策略,以下变量展开如下:
变量 版本 1 配置文件的展开 版本 2 配置文件的展开
!ctx_localsettings!! Local Settings\Application Data AppData\Local
!ctx_roamingappdata!! Application Data AppData\Roaming
!ctx_startmenu!! Start Menu AppData\Roaming\Microsoft\Windows\Start menu
!ctx_internetcache!! Local Settings\Temporary Internet Files AppData\Local\Microsoft\Windows\Temporary Internet Files
!ctx_localappdata!! Local Settings\Application Data AppData\Local
对于用于构建路径的策略,!ctx_osbitness! 变量根据操作系统展开为 x86 或 x64。以下变量也展开:
  • !ctx_osname! 根据操作系统展开为短名称,如下所示。
  • !ctx_profilever! 根据操作系统展开为配置文件版本,如下所示。
配置文件管理服务启动时,长名称会写入日志文件。
长名称 短名称 配置文件版本
Windows 11 Win11 v6
Windows 10 Redstone 6 Win10 红石 6 v6
Windows 10 Redstone 5 Win10 红石 5 v6
Windows 10 Redstone 4 Windows 10 版本 1803 v6
Windows 10 Redstone 3 Windows 10 版本 1709 v6
Windows 10 Redstone 2 Win10RS2 版本 v6
Windows 10 Redstone 1 Win10RS1 版本 v6
Windows 10 Win10 v5
Windows 8.1 Win8.1 v4 或 v2
Windows 8 Win8 v3 或 v2
Windows 7 Win7 v2
Windows Server 2022 Win2022 v6
Windows Server 2019 Win2019 v6
Windows Server 2016 Win2016 v6
Windows Server 2012 R2 Win2012R2 操作系统 v4 或 v2
Windows Server 2012 Win2012 v3 或 v2
Windows Server 2008 R2 Win2008 v2
Windows Server 2008 Win2008 v2
注意:
对于从 20H1 开始的 Windows 10,长名称为 Windows10 \<postfix\>,对应的短名称为 Win10_\<postfix\>。\<postfix\> 值从两个特定的注册表项中获取:
  • 条目:HKLM\Software\Microsoft\Windows NT\CurrentVersion > 值名称:DisplayVersion
  • 条目:HKLM\Software\Microsoft\Windows NT\CurrentVersion > 值名称:ReleaseId
如果第一个注册表项包含值,则将其用作 \<postfix\>。否则,使用第二个注册表项中的值。
对于 Windows 8、Windows 8.1、Windows Server 2012 和 Windows Server 2012R2,实际配置文件版本可能会根据 HLKM\System\CurrentControlset\Services\ProfSvc\Parameters 下 UseProfilePathExtensionVersion 注册表项的设置而改变:
  • 如果设置为 1,则配置文件版本为 v3 或 v4,具体取决于操作系统。
  • 如果未设置或设置为 0,则配置文件版本为 v2。

按版本划分的策略

为帮助迁移,下表显示了不同版本的 Profile Management 中可用的策略、每个策略在 .adm(或 .admx)文件和 .ini 文件中的位置,以及每个策略设计用于的功能(或它是否是所有部署的基本配置的一部分)。
.adm 或 .admx 文件中的位置是相对于 Citrix > Profile Management 的。

从版本 2308 开始提供的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
AutoExtend \ProfileContainerSettings AutoExtend 为配置文件容器启用 VHD 自动扩展
AutoExtendThreshold \AdvancedSettings AutoExtendThreshold 配置文件容器自动扩展阈值
AutoExtendSize \AdvancedSettings AutoExtendSize 配置文件容器自动扩展增量
AutoExtendLimit \AdvancedSettings AutoExtendLimit 配置文件容器自动扩展限制
VhdCapacity \AdvancedSettings VhdCapacity VHD 容器的默认容量
DisableConcurrentAccessToProfileContainer \ProfileContainerSettings DisableConcurrentAccessToProfileContainer 启用对 VHD 容器的独占访问
DisableConcurrentAccessToOneDriveContainer \ProfileContainerSettings DisableConcurrentAccessToOneDriveContainer 启用对 VHD 容器的独占访问
EnableUwpAppsRoaming \AdvancedSettings EnableUwpAppsRoaming UWP 应用程序漫游

版本 2305 起可用的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
UserGroupLevelConfigEnabled \AdvancedSettings UserGroupLevelConfigEnabled 启用用户级策略设置
OrderedGroups \AdvancedSettings OrderedGroups 设置用户组的优先级顺序

从版本 2303 开始提供的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
PSMidSessionWriteBackSessionLock \BasicSettings PSMidSessionWriteBackSessionLock 启用会话锁定和断开连接时的主动回写
AppAccessControl \AppAccessControl AppAccessControl 启用应用程序访问控制
EnableVHDDiskCompaction \ProfileContainerSettings EnableVHDDiskCompaction 启用 VHD 磁盘压缩
FreeRatio4Compaction \AdvancedSettings FreeRatio4Compaction 触发 VHD 磁盘压缩的空闲空间比率
用于压缩的注销次数 \AdvancedSettings 用于压缩的注销次数 触发 VHD 磁盘压缩的注销次数
用于压缩的碎片整理次数 \AdvancedSettings N碎片整理4压缩 禁用 VHD 磁盘压缩的碎片整理

从版本 2209 开始可用的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
SharedStoreFileInclusionList \文件重复数据删除 SharedStoreFileInclusionList 要包含在共享存储中进行重复数据删除的文件
SharedStoreFileExclusionList \文件重复数据删除 SharedStoreFileExclusionList 要从共享存储中排除的文件

从版本 2206 开始可用的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
SyncGpoStateEnabled \AdvancedSettings SyncGpoStateEnabled 在登录时为用户组策略启用异步处理
OneDriveContainer \AdvancedSettings OneDriveContainer 启用漫游 OneDrive 文件夹
OutlookSearchRoamingConcurrentSessionEnabled \AdvancedSettings OutlookSearchRoamingConcurrentSessionEnabled 在并发会话中启用 Outlook 搜索数据漫游
PSForPendingAreaEnabled \流式用户配置文件 PSForPendingAreaEnabled 为暂存区启用配置文件流式处理

从版本 2203 开始提供的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
EnableVolumeReattach \AdvancedSettings EnableVolumeReattach 在会话中自动重新连接 VHDX 磁盘

从版本 2112 开始提供的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
ProfileContainerExclusionListFile 配置文件容器设置 ProfileContainerExclusionListFile 从配置文件容器中排除文件
ProfileContainerInclusionListFile 配置文件容器设置 ProfileContainerInclusionListFile 在配置文件容器中包含文件
VhdStorePath AdvancedSettings PathToVhdStore 指定 VHDX 文件的网络存储位置

适用于版本 2109 的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
CredBasedAccessEnabled AdvancedSettings CredBasedAccessEnabled 启用基于凭据的用户存储访问

适用于版本 2106 的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
AccelerateFolderMirroring \FileSystemSettings\FSSynchronization AccelerateFolderMirroring 加速文件夹镜像
CredBasedAccessEnabled AdvancedSettings CredBasedAccessEnabled 启用基于凭据的用户存储访问
MultiSiteReplication AdvancedSettings MultiSiteReplication 复制用户存储

从版本 2103 开始提供的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
PSForFoldersEnabled \PsSettings PSForFoldersEnabled 文件夹的配置文件流
ProfileContainerLocalCache \ProfileContainerSettings ProfileContainerLocalCache 配置文件容器的本地缓存

从 2009 版本开始提供的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
ProfileContainerExclusionListDir \ProfileContainerSettings ProfileContainerExclusionListDir 配置文件容器
ProfileContainerInclusionListDir \ProfileContainerSettings ProfileContainerInclusionListDir 配置文件容器

从版本 2003 开始提供的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
FSLogixProfileContainerSupport \AdvancedSettings FSLogixProfileContainerSupport 版本 2103 之前: 为 FSLogix Profile Container 启用多会话回写 版本 2103 及更高版本: 为 Profile Containers 启用多会话回写

从版本 1909 开始提供的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
MigrateUserStore MigrateUserStore 迁移用户存储
OutlookEdbBackupEnabled \AdvancedSettings OutlookEdbBackupEnabled Outlook 搜索索引数据库 - 备份和还原
ApplicationProfilesAutoMigration \AdvancedSettings ApplicationProfilesAutoMigration 现有应用程序配置文件的自动迁移

从版本 1903 开始提供的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
ProfileContainer 2009 版本之前: \FileSystemSettings\FSSynchronization 2009 版本及更高版本: \ProfileContainer ProfileContainer 配置文件容器

从 7.18 版本开始提供的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
OutlookSearchRoamingEnabled \AdvancedSettings OutlookSearchRoamingEnabled Outlook 搜索漫游

从 7.16 版本开始提供的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
XenAppOptimizationSettings \XenAppOptimizationSettings XenAppOptimizationSettings Citrix Virtual Apps and Desktops 应用程序优化
XenAppOptimizationDefinitionPath \XenAppOptimizationSettings XenAppOptimizationDefinitionPath Citrix Virtual Apps and Desktops 应用程序优化
LargeFileHandlingList \FileSystemSettings LargeFileHandlingList 大文件处理

从版本 7.15 开始提供的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
LogonExclusionCheck \FileSystemSettings LogonExclusionCheck 登录排除检查

从版本 5.8 开始提供的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
StreamingExclusionList \PsSettings StreamingExclusionList 配置文件流式传输排除列表

从版本 5.6 开始提供的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
CEIPEnabled \AdvancedSettings CEIPEnabled CEIP
PSMidSessionWriteBackReg PSMidSessionWriteBackReg 活动回写注册表

从版本 5.5 开始提供的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
默认排除列表 \Registry DefaultExclusionListRegistry 基础
NTUSER.DAT \注册表 LastKnownGoodRegistry 备份 NTUSER.DAT
默认排除列表 - 目录 \文件系统 DefaultSyncExclusionListDir 基础

版本 5.0–5.4 中可用的策略

在 .adm 或 .admx 文件中的策略 在 .adm 或 .admx 文件中的位置 在 .ini 文件中的策略 功能
排除的组 ExcludedGroups 排除的组
禁用自动配置 \高级设置 DisableDynamicConfig 自动配置
重定向 AppData (漫游) 文件夹,重定向 Desktop 文件夹,... \文件夹重定向(在用户配置中) 注意:不适用 与 XenDesktop 集成
删除缓存配置文件前的延迟 \配置文件处理 ProfileDeleteDelay 基本

从版本 4.x 开始提供的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
跨平台设置用户组 \跨平台设置 CPUserGroupList 跨平台设置
启用跨平台设置 \跨平台设置 CPEnabled 跨平台设置
创建跨平台设置的源 \跨平台设置 CPMigrationFromBaseProfileToCPStore 跨平台设置
跨平台定义路径 \跨平台设置 CPSchemaPath 跨平台设置
跨平台设置存储路径 \跨平台设置 CPPath 跨平台设置
脱机配置文件支持 \跨平台设置 OfflineSupport 脱机配置文件
如果遇到问题,注销用户 \高级设置 LogoffRatherThanTempProfile 改进的故障排除

版本 3.x 中提供的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
活动回写 PSMidSessionWriteBack 活动配置文件回写(在 4.0 版中,重命名为活动回写)
要镜像的文件夹(从 3.1 版开始提供) \文件系统\同步 MirrorFoldersList 文件夹镜像
注销时处理 Internet Cookie 文件(从 3.1 版开始提供) \高级设置 ProcessCookieFiles 文件夹镜像
删除重定向的文件夹(在 3.2、3.2.2 和 4.0 版中提供) \高级设置 DeleteRedirectedFolders 文件夹重定向支持
始终缓存 \流式用户配置文件 PSAlwaysCache 流式用户配置文件
配置文件流技术 \流式用户配置文件 PSEnabled 流式用户配置文件
暂存区锁定文件的超时 \流式用户配置文件 PSPendingLockTimeout 流式用户配置文件
流式用户配置文件组 \流式用户配置文件 PSUserGroupsList 流式用户配置文件

从版本 2.x 开始提供的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
用户存储路径 用户存储路径 基本
已处理的组 已处理组 基本
本地配置文件冲突处理 \配置文件处理 本地配置文件冲突处理 基本
现有配置文件的迁移 \配置文件处理 将 Windows 配置文件迁移到用户存储 基本
模板配置文件 \配置文件处理 模板配置文件路径, 模板配置文件覆盖漫游配置文件, 模板配置文件覆盖本地配置文件 基本
在注销时删除本地缓存的配置文件 \配置文件处理 DeleteCachedProfilesOnLogoff 基本
MFT 缓存文件目录(在 5.0 版中已移除) \高级设置 USNDBPath 基本
要同步的目录 \文件系统\同步 SyncDirList 基本
排除列表 \注册表 ExclusionListRegistry 基本
要同步的文件 \文件系统\同步 SyncFileList 基本
包含列表 \注册表 InclusionListRegistry 基础
排除列表 - 目录 \文件系统 SyncExclusionListDir 基础
排除列表 - 文件 \文件系统 SyncExclusionListFiles 基础
访问锁定文件时的重试次数 \高级设置 LoadRetries 基础
处理本地管理员的登录 ProcessAdmin 基础
启用配置文件管理 ServiceActive 基本
启用日志记录 \日志设置 LoggingEnabled 日志记录
日志设置 \日志设置 LogLevel 日志记录
日志文件的最大大小 \日志设置 MaxLogSize 日志记录
日志文件路径(从版本 2.1 开始提供) \日志设置 PathToLogFile 日志记录