Profile Management

配置文件管理策略

本文介绍了 .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! 根据操作系统扩展为配置文件版本,如下所示。

当 Profile Management Service 启动时,长名称将写入日志文件。

长名称 短名称 配置文件版本
Windows 11 Win11 v6
Windows 10 Redstone 6 Win10 红石 6 v6
Windows 10 Redstone 5 Win10 红石 5 v6
Windows 10 Redstone 4 Win10RS4 版本 v6
Windows 10 Redstone 3 Win10RS3 版本 v6
Windows 10 Redstone 2 Windows 10 创意者更新 v6
Windows 10 Redstone 1 Windows 10 年度更新 v6
Windows 10 Win10 v5
Windows 8.1 Win8.1 v4 或 v2
Windows 8 Win8 v3 或 v2
Windows 7 Win7 v2
Windows Server 2025 Win2025 v6
Windows Server 2022 Win2022 v6
Windows Server 2019 Win2019 v6
Windows Server 2016 Win2016 v6
Windows Server 2012 R2 视窗2012R2 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 的。

版本 2603 起可用的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
BindLinkRedirection \配置文件容器设置 注意:不适用 启用 BindLink 重定向

版本 2511 起可用的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
HibernationSupport \AdvancedSettings 注意:不适用 启用计算机休眠的多会话支持

版本 2503 起可用的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
ConfigurableProfileTimeoutEnabled \AdvancedSettings 注意:不适用 启用配置文件加载超时
NumOfStoresToSyncOnLogoff \AdvancedSettings 注意:不适用 限制注销期间的配置文件同步

从版本 2411 开始提供的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
QuotaMaxSize \AdvancedSettings 注意:不适用 当配置文件大小超出配额时通知用户
QuotaAlertMessage \AdvancedSettings 注意:不适用 当配置文件大小超出配额时的通知消息
PathToAppRepositoryContainerStore \AdvancedSettings PathToAppRepositoryContainerStore 启用 AppX 包加载加速
GroupsToAccessRedirectedFolders \文件夹重定向(在用户配置中) 注意:不适用 访问重定向目标路径的用户和组

从版本 2407 开始提供的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
ProfileContainerFailOver \AdvancedSettings ProfileContainerFailOver 启用用户存储之间的会话内配置文件容器故障转移

从版本 2311 开始提供的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
SelectBestPerfUS \AdvancedSettings SelectBestPerfUS 用户存储选择方法
SharedStoreProfileContainerFileSizeLimit \FileDeduplication SharedStoreProfileContainerFileSizeLimit 文件重复数据删除
PreventLoginWhenProfileContainerMountFailed \ProfileContainerSettings PreventLoginWhenProfileContainerMountFailed 当登录时配置文件容器不可用时注销用户
GroupsToAccessProfileContainer \ProfileContainerSettings GroupsToAccessProfileContainer 访问配置文件容器的用户和组

从版本 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 磁盘压缩的可用空间比率
N注销4压缩 \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 高级设置 PathToVhdStore 为 VHDX 文件指定网络存储位置

从版本 2109 开始提供的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
CredBasedAccessEnabled 高级设置 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 配置文件容器启用多会话回写 2103 版本及更高版本: 为配置文件容器启用多会话回写

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