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 Windows 10 版本 1903 v6
Windows 10 Redstone 5 Windows 10 版本 1809 v6
Windows 10 Redstone 4 Windows 10 版本 1803 v6
Windows 10 Redstone 3 Windows 10 版本 1709 v6
Windows 10 Redstone 2 微软 Windows 10 RS2 v6
Windows 10 Redstone 1 微软 Windows 10 RS1 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 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。

从版本 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 \高级设置 注意:不适用 当配置文件大小超出配额时通知用户
QuotaAlertMessage \高级设置 注意:不适用 当配置文件大小超出配额时的通知消息
PathToAppRepositoryContainerStore \高级设置 PathToAppRepositoryContainerStore 启用 AppX 包加载加速
GroupsToAccessRedirectedFolders \文件夹重定向(在用户配置中) 注意:不适用 访问重定向目标路径的用户和组

从版本 2407 开始提供的策略

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

从版本 2311 开始提供的策略

.adm 或 .admx 文件中的策略 .adm 或 .admx 文件中的位置 .ini 文件中的策略 功能
SelectBestPerfUS \高级设置 选择最佳性能用户存储 用户存储选择方法
共享存储配置文件容器文件大小限制 \文件重复数据删除 共享存储配置文件容器文件大小限制 文件重复数据删除
配置文件容器挂载失败时阻止登录 \配置文件容器设置 配置文件容器挂载失败时阻止登录 登录时配置文件容器不可用时注销用户
访问配置文件容器的组 \配置文件容器设置 访问配置文件容器的组 访问配置文件容器的用户和组

从版本 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次注销后压缩 \AdvancedSettings N次注销后压缩 触发 VHD 磁盘压缩的注销次数
NDefrag4Compaction \AdvancedSettings 碎片整理压缩 禁用 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 高级设置 CredBasedAccessEnabled 启用基于凭据的用户存储访问
MultiSiteReplication 高级设置 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 \Registry 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 开始提供) \File system\Synchronization 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 日志记录
配置文件管理策略