Migrate user profiles
This article guides you through two migration workflows:
- Migration to the Citrix container-based profile solution
- Migration to Windows roaming profile solution
For more information about migration strategies, see Upgrade and migrate.
Migrate to the Citrix container-based profile solution
You can use the migration tool in the Profile Management installation package to migrate user profiles from the following profile solutions to the Citrix container-based profile solution:
Windows local profile solution
Citrix file-based profile solution
FSLogix Profile Container
To migrate your current profile solution to the Citrix container-based profile solution, follow these steps:
Set up the Citrix user store on a storage server and configure its Windows Access Control Lists (ACLs).
For more information, see Create the user store.
Migrate user profiles using the migration tool delivered with Profile Management.
For more information, see Example: Migrate user profiles for FSLogix Profile Container
Install Profile Management on your machines.
For more information, see Install and set up.
Set up the container-based profile solution by configuring specific Profile Management policies. The essential workflow is as follows:
- Enable Profile Management
- Specify the path to the user store (Path to user store)
- Enable profile containers for the entire user profile （Profile container）
For more information about advanced settings for profile containers, see Citrix Profile Management profile container.
(For FSLogix Profile Container) Disable FSLogix Profile Container on your machines. Otherwise, the Citrix container-based solution can’t work properly. Detailed steps are as follows:
- In Registry Editor, go to
- Set Enabled to 0.
- In Registry Editor, go to
This section details how to migrate user profiles from VHDX-based FSLogix Profile Container to the Citrix container-based profile solution.
Before you begin, make sure that you meet the following requirements:
- Have set up the Citrix user store on a storage server and configured its Windows Access Control Lists (ACL).
- Have the VHDX location of the FSLogix Profile Container.
- Have the credentials of a domain administrator.
Detailed steps are as follows:
Log on to a machine using the domain administrator account.
Run Windows PowerShell ISE as an administrator.
In the PowerShell console, access the \tool folder in the Profile Management installation package, and then run CPM_ProfileContainer_Migration_Tool.ps1.
When prompted, choose migration type 3, which represents migrating user profiles from FSLogix Profile Container (VHDX) to the Citrix container-based profile solution.
Enter users and groups that you want to migrate, separated by commas. Example:
<DOMAIN NAME>\<USER NAME1>,<DOMAIN NAME>\<GROUP NAME1>
Enter the VHDX location of the FSLogix Profile Container.
Enter the path to the Citrix VHDX store.
- You can use either the Citrix user store or a different network storage as the Citrix VHDX store.
%USERNAME%is supported among all variables.
Specify the Windows OS version of your machines by entering its short name. To get short names of Windows OS versions, see Profile Management policies.
Only user profiles with the specified OS type are migrated.
Upon completion, the migration results appear on the screen.
Migrate to Windows roaming profiles
You can migrate Citrix user profiles to Windows roaming profiles at any time. Move profile data to a network location where the roaming profiles are stored. After migration, Profile Management takes no part in processing user logons or application settings.
- Make sure that all users are logged off.
- Remove the Profile Management Service from all computers that the software manages.
- In the user store, move the contents of \UPM_Profile to your roaming profile location. You do not have to move the contents of the cross-platform settings store.
- (For Version 1 profiles only) Remove the _upm_var suffix from all subfolders of \UPM_Profile. Note: You might find that scripting simplifies this step.