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 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 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 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 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 |
发布评论