配置文件管理策略
本文介绍了 .adm 和 .admx 文件中策略的重要方面。
配置文件管理变量
在此版本的 Profile Management 中，以下变量可用于组策略和 .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 红石 6 | v6 |
Windows 10 Redstone 5 |
Windows 10 红石 5 | v6 |
Windows 10 Redstone 4 |
Windows 10 红石 4 | v6 |
Windows 10 Redstone 3 |
Windows 10 红石 3 | v6 |
Windows 10 Redstone 2 |
Windows 10 红石 2 | v6 |
Windows 10 Redstone 1 |
Windows 10 红石 1 | 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 的。
从版本 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 | 用户存储选择方法 |
| 共享存储配置文件容器文件大小限制 | \文件重复数据删除 | 共享存储配置文件容器文件大小限制 | 文件重复数据删除 |
| 配置文件容器挂载失败时阻止登录 | \配置文件容器设置 | 配置文件容器挂载失败时阻止登录 | 在登录期间配置文件容器不可用时注销用户 |
| 访问配置文件容器的组 | \配置文件容器设置 | 访问配置文件容器的组 | 访问配置文件容器的用户和组 |
从版本 2308 开始提供的策略
| .adm 或 .admx 文件中的策略 | .adm 或 .admx 文件中的位置 | .ini 文件中的策略 | 功能 |
|---|---|---|---|
| 自动扩展 | \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 | 用于压缩的碎片整理次数 | 禁用 VHD 磁盘压缩的碎片整理 |
从版本 2209 开始提供的策略
| .adm 或 .admx 文件中的策略 | .adm 或 .admx 文件中的位置 | .ini 文件中的策略 | 功能 |
|---|---|---|---|
| SharedStoreFileInclusionList | \文件重复数据删除 | SharedStoreFileInclusionList | 要包含在共享存储中进行重复数据删除的文件 |
| SharedStoreFileExclusionList | \文件重复数据删除 | SharedStoreFileExclusionList | 要从共享存储中排除的文件 |
从版本 2206 开始提供的策略
| .adm 或 .admx 文件中的策略 | .adm 或 .admx 文件中的位置 | .ini 文件中的策略 | 功能 |
|---|---|---|---|
| SyncGpoStateEnabled | \高级设置 | 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 | 高级设置 | 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 及更高版本： 为配置文件容器启用多会话回写 |
从版本 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 版开始提供） | \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 | 日志记录 |
| 日志设置 | \日志设置 | 日志级别 | 日志记录 |
| 日志文件的最大大小 | \日志设置 | 最大日志大小 | 日志记录 |
| 日志文件路径（从版本 2.1 开始可用） | \日志设置 | 日志文件路径 | 日志记录 |