配置文件管理策略
本文介绍了 .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 |
Win10RS6 版本 | v6 |
Windows 10 Redstone 5 |
Win10RS5 版本 | v6 |
Windows 10 Redstone 4 |
Win10RS4 版本 | v6 |
Windows 10 Redstone 3 |
Win10RS3 版本 | v6 |
Windows 10 Redstone 2 |
温10RS2 | v6 |
Windows 10 Redstone 1 |
温10RS1 | 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 的。
从版本 2311 开始可用的策略
| .adm 或 .admx 文件中的策略 | .adm 或 .admx 文件中的位置 | .ini 文件中的策略 | 功能 |
|---|---|---|---|
| SelectBestPerfUS | \AdvancedSettings | SelectBestPerfUS | 用户存储选择方法 |
| SharedStoreProfileContainerFileSizeLimit | \FileDeduplication | SharedStoreProfileContainerFileSizeLimit | 文件重复数据删除 |
| PreventLoginWhenProfileContainerMountFailed | \ProfileContainerSettings | PreventLoginWhenProfileContainerMountFailed | 当配置文件容器在登录期间不可用时注销用户 |
| GroupsToAccessProfileContainer | \ProfileContainerSettings | GroupsToAccessProfileContainer | 访问配置文件容器的用户和组 |
版本 2308 中提供的策略
| .adm 或 .admx 文件中的策略 | .adm 或 .admx 文件中的位置 | .ini 文件中的策略 | 功能 |
|---|---|---|---|
| 自动扩展 | \ProfileContainerSettings | 自动扩展 | 为配置文件容器启用 VHD 自动扩展 |
| 自动扩展阈值 | \AdvancedSettings | 自动扩展阈值 | 配置文件容器自动扩展阈值 |
| 自动扩展大小 | \AdvancedSettings | 自动扩展大小 | 配置文件容器自动扩展增量 |
| 自动扩展限制 | \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 | \AdvancedSettings | SyncGpoStateEnabled | 在登录时为用户组策略启用异步处理 |
| OneDriveContainer | \AdvancedSettings | OneDriveContainer | 启用漫游 OneDrive 文件夹 |
| OutlookSearchRoamingConcurrentSessionEnabled | \AdvancedSettings | OutlookSearchRoamingConcurrentSessionEnabled | 在并发会话中启用 Outlook 搜索数据漫游 |
| PSForPendingAreaEnabled | \流式用户配置文件 | PSForPendingAreaEnabled | 为挂起区域启用配置文件流 |
从版本 2203 开始提供的策略
| .adm 或 .admx 文件中的策略 | .adm 或 .admx 文件中的位置 | .ini 文件中的策略 | 功能 |
|---|---|---|---|
| EnableVolumeReattach | \高级设置 | 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 配置文件容器启用多会话回写 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 | 日志记录 |