Profile Management

Configure folder redirection

Folder redirection is a feature of Microsoft Windows and can be used with Profile Management. It lets you redirect the paths of local folders to new locations for users. The following folders can be redirected:

  • AppData(Roaming)
  • Desktop
  • Start menu
  • Documents
  • Pictures
  • Music
  • Videos
  • Favorites
  • Contacts
  • Downloads
  • Links
  • Searches
  • Saved Games

Important:

Configure folder redirection using only one of these methods: Microsoft Active Directory (AD) GPOs or Citrix policies. Using multiple methods to configure folder redirection might cause unpredictable results.

To configure folder redirection, follow these steps:

  1. Move applicable users to an OU that Profile Management manages.

  2. Create a GPO and then open it for editing.

  3. Navigate to User Configuration > Administrative Templates > Citrix Components > Profile Management > Folder Redirection and then select the folder you want to redirect.

  4. Open the Redirect the <folder name> folder policy (for example, the Redirect the Desktop folder policy), select Enabled, and then type the redirection target path.

    • Don’t add the redirection target path as exclusions.
    • Don’t add user names or folder names to the path. For example, if you set the path to the Desktop folder as \\server\share\, the folder in the user environment is redirected as \\server\share\<user name>\Desktop.
  5. For your changes to take effect, run the gpupdate /force command from the command prompt. For details, see https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/gpupdate.

Note:

  • The Documents folder. You can redirect it to the user’s home directory.
  • The Music, Pictures, and Videos folders. You can redirect them to folders relative to the Documents folder.
  • To change the redirection target path for a folder, follow similar steps described above. By default, Profile Management transfers content from the previous location to the new one when the policy takes effect. To prevent this transfer, select Disable moving contents to new location.
  • To disable a folder redirection, set the corresponding policy to Disabled. Alternatively, you can keep the policy as Enabled and select Redirect to the local user profile location.

Verify that folder redirection works

To verify that folder redirection works, complete the following steps:

  1. In a session, navigate to a folder you directed, right-click the folder, and then select Properties.

  2. In the properties window, navigate to the Shortcut tab and then check the Target field. If the field displays a redirected path, folder redirection works. Otherwise, folder redirection does not work.

Folder redirection logs

Note:

Profile Management writes information to the Windows event log only when folder redirection fails.

Profile Management writes information to the Windows event log. You can view the events in the Application pane of the Windows Event Viewer. The information helps you troubleshoot issues you experience when using the folder redirection feature.

Configure folder redirection