Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Anchor
_GoBack
_GoBack

Info

Script Version 2 

Note

This information applies to Citrix UPM profiles and Microsoft Roaming profiles. To migrate an existing local profile, use the frx.exe command line tool.

Table of Contents

FSLogix Apps Profile Migration Overview
FSLogix Apps Profile Migration Requirements
FSLogix Apps Profile Migration Installation Components
FSLogix Apps Profile Migration Installation
Setup.exe installation
FSLogix Profile Migration
Run the FSLProfConfig.ps1 Script
VHD
Size
Dynamic
Rename Local Profile After Migration
Citrix UPM Profile 
Container Directory 
Profile Directory 
Redirection Folder 
Group Name 
Choose which User's profiles to migrate. 
Migrate Folder Redirection folders into the Profile 
Convert the profile(s)

...

Profiles can be migrated from any machine that has FSLogix Apps 2.0.2100 or later installed.   Before getting started have the following information available:

  • The file share that contains the profile folders to be migrated.
  • The file share that contains the Folder Redirection.
  • The name of the file share where the FSLogix Profiles will reside.
  • The script must be run in a user account that has read/write privileges to both the existing profile folders and the folder that will hold the FSLogix profiles.
  • Subinacl utility. Download from: https://www.microsoft.com/en-us/download/details.aspx?id=23510
    • Subinacl is only used for files migrated from Folder Redirection
    • Set the location of the Subinacl.exe into the environment variable, "subinacl"$env:subinacl = {directory of where subinacl is stored}

Image Removed

...

The Profile Migration Tool is available upon request as a seperate download.  It includes a .zip file containing setup.exe and FSLProfConfig.msi.

...

Image Removed

...

Otherwise just start powershell_ise.

...

The script presents a configuration UI to help with the many possible settings. Note these settings apply to all users.

...

This combo box chooses between VHD and VHDx format for the virtual hard disk. VHDx is only supported on Windows 8 and above and Server 2012 and above. For ease of reference this document refers to either format as VHD.

...

This value determines how big the VHD will be when it is created.

...

This combo box chooses between Dynamic and Fixed size VHD formats.

...

Check this box if you are migrating a local profile. This will rename the local profile with a ".old" extension. In order for FSLogix Profiles to work on this machine there should be no local profiles present.

...

Click the "Citrix UPM Profile" checkbox if you are converting from a Citrix UPM Profile.

...

This is a UNC Path to the location where the FSLogix Profile VHDs are stored. Typically, this is set during FSLogix Profiles installation

...

This is the location of the Central Profile Store. Use %USERNAME% and %DOMAIN% as substitutions.
For example, if the user directory is <username>.v2 use %USERNAME%.v2

...

This is the location for Folder Redirection

...

This is an Active Directory Group name of the users to convert. This Group will be enumerated and presented when the "Choose Users…" button is pressed.

...

Choose which folders to migrate

...

Once conversion begins the script my run for several minutes for each user being migrated.

The information in this Guide was outdated and has been removed