配置文件管理策略
本文介绍了 .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 |
Win10RS6 版本 | v6 |
Windows 10 Redstone 5 |
Win10RS5 版本 | v6 |
Windows 10 Redstone 4 |
Win10红石4 | v6 |
Windows 10 Redstone 3 |
Win10红石3 | 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 的。
从版本 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 | 高级设置 | 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 开始提供） | \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 | 日志记录 |