Profile Management

Profile Management policies

This article describes important aspects of the policies in the .adm and .admx files.

Profile Management variables

In this version of Profile Management, the following variables are available for use in both Group Policy and the .ini file.

For policies that define files and registry entries, the following variables expand as follows:

Variable Expansion for Version 1 profiles Expansion for Version 2 profiles
!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

For policies that are used to build paths, the !ctx_osbitness! variable expands to x86 or x64 depending on the operating system. The following variables also expand:

  • !ctx_osname! expands to the short name as follows depending on the operating system.
  • !ctx_profilever! expands to the profile version as follows depending on the operating system.

The long name is written to the log files when the Profile Management Service starts.

Long Name Short Name Profile Version
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 Win10RS2 v6
Windows 10 Redstone 1 Win10RS1 v6
Windows 10 Win10 v5
Windows 8.1 Win8.1 v4 or v2
Windows 8 Win8 v3 or 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 or v2
Windows Server 2012 Win2012 v3 or v2
Windows Server 2008 R2 Win2008 v1
Windows Server 2008 Win2008 v1

Note:

For Windows 10 starting with 20H1, the long name is Windows10 <postfix>, and the corresponding short name is Win10_<postfix>. The <postfix> value is obtained from two specific registry entries:

  • Entry: HKLM\Software\Microsoft\Windows NT\CurrentVersion > Value Name: DisplayVersion
  • Entry: HKLM\Software\Microsoft\Windows NT\CurrentVersion > Value Name: ReleaseId

If the first registry entry contains a value, it is used as the <postfix>. Otherwise, the value from the second registry entry is used.

For Windows 8, Windows 8.1, Windows Server 2012, and Windows Server 2012R2, the actual profile version might change depending on the setting of the UseProfilePathExtensionVersion registry key under HLKM\System\CurrentControlset\Services\ProfSvc\Parameters:

  • If it’s set to 1, the profile version is v3 or v4 depending on the operating system.
  • If it’s not set or set to 0, the profile version is v2.

Policies by version

As an aid to migration, the following tables show the policies that are available in different versions of Profile Management, the location of each policy in the .adm (or .admx) file and in the .ini file, and the feature each policy is designed for (or whether it is part of the base configuration of all deployments).

The location in the .adm or .admx file is relative to Citrix > Profile Management.

Policies available from Version 2311

Policy in .adm or .admx file Location in .adm or .admx file Policy in .ini file Feature
SelectBestPerfUS \AdvancedSettings SelectBestPerfUS User store selection method
SharedStoreProfileContainerFileSizeLimit \FileDeduplication SharedStoreProfileContainerFileSizeLimit File Deduplication
PreventLoginWhenProfileContainerMountFailed \ProfileContainerSettings PreventLoginWhenProfileContainerMountFailed Log off users when profile container is not available during logon
GroupsToAccessProfileContainer \ProfileContainerSettings GroupsToAccessProfileContainer Users and groups to access profile container

Policies available from Version 2308

Policy in .adm or .admx file Location in .adm or .admx file Policy in .ini file Feature
AutoExtend \ProfileContainerSettings AutoExtend Enable VHD auto-expansion for profile container
AutoExtendThreshold \AdvancedSettings AutoExtendThreshold Profile container auto-expansion threshold
AutoExtendSize \AdvancedSettings AutoExtendSize Profile container auto-expansion increment
AutoExtendLimit \AdvancedSettings AutoExtendLimit Profile container auto-expansion limit
VhdCapacity \AdvancedSettings VhdCapacity Default capacity of VHD containers
DisableConcurrentAccessToProfileContainer \ProfileContainerSettings DisableConcurrentAccessToProfileContainer Enable exclusive access to VHD containers
DisableConcurrentAccessToOneDriveContainer \ProfileContainerSettings DisableConcurrentAccessToOneDriveContainer Enable exclusive access to VHD containers
EnableUwpAppsRoaming \AdvancedSettings EnableUwpAppsRoaming UWP app roaming

Policies available from Version 2305

Policy in .adm or .admx file Location in .adm or .admx file Policy in .ini file Feature
UserGroupLevelConfigEnabled \AdvancedSettings UserGroupLevelConfigEnabled Enable user-level policy settings
OrderedGroups \AdvancedSettings OrderedGroups Set priority order for user groups

Policies available from Version 2303

Policy in .adm or .admx file Location in .adm or .admx file Policy in .ini file Feature
PSMidSessionWriteBackSessionLock \BasicSettings PSMidSessionWriteBackSessionLock Enable active write-back on session lock and disconnection
AppAccessControl \AppAccessControl AppAccessControl Enable app access control
EnableVHDDiskCompaction \ProfileContainerSettings EnableVHDDiskCompaction Enable VHD disk compaction
FreeRatio4Compaction \AdvancedSettings FreeRatio4Compaction Free space ratio to trigger VHD disk compaction
NLogoffs4Compaction \AdvancedSettings NLogoffs4Compaction Number of logoffs to trigger VHD disk compaction
NDefrag4Compaction \AdvancedSettings NDefrag4Compaction Disable defragmentation for VHD disk compaction

Policies available from Version 2209

Policy in .adm or .admx file Location in .adm or .admx file Policy in .ini file Feature
SharedStoreFileInclusionList \File deduplication SharedStoreFileInclusionList Files to include in the shared store for deduplication
SharedStoreFileExclusionList \File deduplication SharedStoreFileExclusionList Files to exclude from the shared store

Policies available from Version 2206

Policy in .adm or .admx file Location in .adm or .admx file Policy in .ini file Feature
SyncGpoStateEnabled \AdvancedSettings SyncGpoStateEnabled Enable asynchronous processing for user Group Policy on logon
OneDriveContainer \AdvancedSettings OneDriveContainer Enable the roaming OneDrive folders
OutlookSearchRoamingConcurrentSessionEnabled \AdvancedSettings OutlookSearchRoamingConcurrentSessionEnabled Enable Outlook search data roaming in concurrent sessions
PSForPendingAreaEnabled \Streamed user profiles PSForPendingAreaEnabled Enable profile streaming for pending area

Policies available from Version 2203

Policy in .adm or .admx file Location in .adm or .admx file Policy in .ini file Feature
EnableVolumeReattach \AdvancedSettings EnableVolumeReattach Automatically reattach VHDX disks in sessions

Policies available from Version 2112

Policy in .adm or .admx file Location in .adm or .admx file Policy in .ini file Feature
ProfileContainerExclusionListFile Profile container settings ProfileContainerExclusionListFile Exclude files from the profile container
ProfileContainerInclusionListFile Profile container settings ProfileContainerInclusionListFile Include files in the profile container
VhdStorePath AdvancedSettings PathToVhdStore Specify a network storage location for VHDX files

Policies available from Version 2109

Policy in .adm or .admx file Location in .adm or .admx file Policy in .ini file Feature
CredBasedAccessEnabled AdvancedSettings CredBasedAccessEnabled Enable credential-based access to user stores

Policies available from Version 2106

Policy in .adm or .admx file Location in .adm or .admx file Policy in .ini file Feature
AccelerateFolderMirroring \FileSystemSettings\FSSynchronization AccelerateFolderMirroring Accelerate folder mirroring
CredBasedAccessEnabled AdvancedSettings CredBasedAccessEnabled Enable credential-based access to user store
MultiSiteReplication AdvancedSettings MultiSiteReplication Replicate user stores

Policies available from Version 2103

Policy in .adm or .admx file Location in .adm or .admx file Policy in .ini file Feature
PSForFoldersEnabled \PsSettings PSForFoldersEnabled Profile streaming for folders
ProfileContainerLocalCache \ProfileContainerSettings ProfileContainerLocalCache Local caching for profile containers

Policies available from Version 2009

Policy in .adm or .admx file Location in .adm or .admx file Policy in .ini file Feature
ProfileContainerExclusionListDir \ProfileContainerSettings ProfileContainerExclusionListDir Profile container
ProfileContainerInclusionListDir \ProfileContainerSettings ProfileContainerInclusionListDir Profile container

Policy available from Version 2003

Policy in .adm or .admx file Location in .adm or .admx file Policy in .ini file Feature
FSLogixProfileContainerSupport \AdvancedSettings FSLogixProfileContainerSupport Before Version 2103: Enable multi-session write-back for FSLogix Profile Container Version 2103 and later: Enable multi-session write-back for Profile Containers

Policies available from Version 1909

Policy in .adm or .admx file Location in .adm or .admx file Policy in .ini file Feature
MigrateUserStore \ MigrateUserStore Migrate UserStore
OutlookEdbBackupEnabled \AdvancedSettings OutlookEdbBackupEnabled Outlook search index database - backup and restore
ApplicationProfilesAutoMigration \AdvancedSettings ApplicationProfilesAutoMigration Automatic migration of existing application profiles

Policy available from Version 1903

Policy in .adm or .admx file Location in .adm or .admx file Policy in .ini file Feature
ProfileContainer Before Version 2009: \FileSystemSettings\FSSynchronization Version 2009 and later: \ProfileContainer ProfileContainer Profile Container

Policy available from Version 7.18

Policy in .adm or .admx file Location in .adm or .admx file Policy in .ini file Feature
OutlookSearchRoamingEnabled \AdvancedSettings OutlookSearchRoamingEnabled Outlook search roaming

Policies available from Version 7.16

Policy in .adm or .admx file Location in .adm or .admx file Policy in .ini file Feature
XenAppOptimizationSettings \XenAppOptimizationSettings XenAppOptimizationSettings Citrix Virtual Apps and Desktops application optimization
XenAppOptimizationDefinitionPath \XenAppOptimizationSettings XenAppOptimizationDefinitionPath Citrix Virtual Apps and Desktops application optimization
LargeFileHandlingList \FileSystemSettings LargeFileHandlingList Large file handling

Policy available from Version 7.15

Policy in .adm or .admx file Location in .adm or .admx file Policy in .ini file Feature
LogonExclusionCheck \FileSystemSettings LogonExclusionCheck Logon exclusion check

Policy available from Version 5.8

Policy in .adm or .admx file Location in .adm or .admx file Policy in .ini file Feature
StreamingExclusionList \PsSettings StreamingExclusionList Profile streaming exclusion list

Policies available from Version 5.6

Policy in .adm or .admx file Location in .adm or .admx file Policy in .ini file Feature
CEIPEnabled \AdvancedSettings CEIPEnabled CEIP
PSMidSessionWriteBackReg \ PSMidSessionWriteBackReg Active write back registry

Policies available from Version 5.5

Policy in .adm or .admx file Location in .adm or .admx file Policy in .ini file Feature
Default Exclusion list \Registry DefaultExclusionListRegistry Base
NTUSER.DAT \Registry LastKnownGoodRegistry Backup NTUSER.DAT
Default Exclusion list - directories \File system DefaultSyncExclusionListDir Base

Policies available from Version 5.0–5.4

Policy in .adm or .admx file Location in .adm or .admx file Policy in .ini file Feature
Excluded groups \ ExcludedGroups Excluded Groups
Disable automatic configuration \Advanced Settings DisableDynamicConfig Automatic Configuration
Redirect the AppData (Roaming) folder, Redirect the Desktop folder, … \Folder Redirection (in User Configuration) Note: Not applicable Integration with XenDesktop
Delay before deleting cached profiles \Profile handling ProfileDeleteDelay Base

Policies available from Version 4.x

Policy in .adm or .admx file Location in .adm or .admx file Policy in .ini file Feature
Cross-platform settings user groups \Cross-platform settings CPUserGroupList Cross-platform settings
Enable cross-platform settings \Cross-platform settings CPEnabled Cross-platform settings
Source for creating cross-platform settings \Cross-platform settings CPMigrationFromBaseProfileToCPStore Cross-platform settings
Path to cross-platform definitions \Cross-platform settings CPSchemaPath Cross-platform settings
Path to cross-platform settings store \Cross-platform settings CPPath Cross-platform settings
Offline profile support \Cross-platform settings OfflineSupport Offline profiles
Log off user if a problem is encountered \Advanced Settings LogoffRatherThanTempProfile Improved Troubleshooting

Policies available from Version 3.x

Policy in .adm or .admx file Location in .adm or .admx file Policy in .ini file Feature
Active write back \ PSMidSessionWriteBack Active profile writeback (in Version 4.0, renamed Active write back)
Folders to mirror (available from Version 3.1) \File system\Synchronization MirrorFoldersList Folder mirroring
Process Internet cookie files on logoff (available from Version 3.1) \Advanced settings ProcessCookieFiles Folder mirroring
Delete Redirected Folders (available in Versions 3.2, 3.2.2, and 4.0) \Advanced settings DeleteRedirectedFolders Support for folder redirection
Always cache \Streamed user profiles PSAlwaysCache Streamed user profiles
Profile streaming \Streamed user profiles PSEnabled Streamed user profiles
Timeout for pending area lock files \Streamed user profiles PSPendingLockTimeout Streamed user profiles
Streamed user profile groups \Streamed user profiles PSUserGroupsList Streamed user profiles

Policies available from Version 2.x

Policy in .adm or .admx file Location in .adm or .admx file Policy in .ini file Feature
Path to user store \ PathToUserStore Base
Processed groups \ ProcessedGroups Base
Local profile conflict handling \Profile handling LocalProfileConflictHandling Base
Migration of existing profiles \Profile handling MigrateWindowsProfilesToUserStore Base
Template profile \Profile handling TemplateProfilePath, TemplateProfileOverridesRoamingProfile, TemplateProfileOverridesLocalProfile Base
Delete locally cached profiles on logoff \Profile handling DeleteCachedProfilesOnLogoff Base
Directory of the MFT cache file (removed in Version 5.0) \Advanced settings USNDBPath Base
Directories to synchronize \File system\Synchronization SyncDirList Base
Exclusion list \Registry ExclusionListRegistry Base
Files to synchronize \File system\Synchronization SyncFileList Base
Inclusion list \Registry InclusionListRegistry Base
Exclusion list - directories \File system SyncExclusionListDir Base
Exclusion list - files \File system SyncExclusionListFiles Base
Number of retries when accessing locked files \Advanced settings LoadRetries Base
Process logons of local administrators \ ProcessAdmin Base
Enable Profile Management \ ServiceActive Base
Enable logging \Log settings LoggingEnabled Logging
Log settings \Log settings LogLevel Logging
Maximum size of the log file \Log settings MaxLogSize Logging
Path to log file (available from Version 2.1) \Log settings PathToLogFile Logging
Profile Management policies