FSLogix Settings and Configuration

FSLogix Settings and Configuration

FSLogix is a user profile container technology (FSLogix Profile Containers) that allows users to switch virtual desktops session host without losing access to their own customizations. With FSLogix, you can use OneDrive and the indexed search functionality in virtual desktops. This option was not available for the legacy RDS User Profile Disks (UPDs).

The FSLogix profile container is based on two components:

  • Installation of the FSLogix application (https://aka.ms/fslogix_download)

  • Configuration of the FSLogix via GPO or registry. For more information, see this Microsoft article.

Nerdio Manager automatically installs the FSLogix application, by default, when a new session host VM is created, or an existing one is re-imaged. This is the most common use case. From v4.1.0, partners can now choose the FSLogix profile version for their NMM install.

There are two methods for configuring the FSLogix profiles, depending on your needs:

Add Global FSLogix Profiles Configuration

Nerdio Manager allows you to create a Global FSLogix Profile at the MSP level and assign it to your customer accounts. This setting allows you to centrally manage the FSLogix profile across customer accounts.

To add a global FSLogix profile configuration:

  1. At the MSP level, navigate to SettingsIntegrations.

  2. In the Global FSLogix Profiles storage tile, select Add.

  3. Enter the following information:

    • Name: Type the FSLogix Profile's name.

    • Manage Profile path: Select this option if you want to include the Profiles Path in the global profile for re-use across customers.

      • Use Cloud Cache: Select this option to enable FSLogix Cloud Cache in the host pools, and the session hosts within those host pools, that use this FSLogix profile.

      • Use Azure Page Blobs: Select this option to use storage account blob containers to store user profiles. These containers are accessed using storage account access keys.

      • FSLogix Profiles path (CCDLocation): From the drop-down list, select an Azure Files share or Azure NetApp Files volumes. Alternatively, type in a UNC path.

    • Manage Registry Options: Select this option if you want to include the FSLogix Registry settings in the global profile for re-use across customers. See above for details.

    • Manage Redirections: Select this option if you want to include Redirections in the global profile for re-use across customers.

      • Redirections; Toggle this option on and then type the redirections.

    • Manage FSLogix version:

      • FSLogix version: From the drop-down list, select the FSLogix version.

    • Manage ODFC path:

      • Use Cloud Cache: Select this option to enable FSLogix Cloud Cache in the host pools, and the session hosts within those host pools, that use this FSLogix profile.

      • FSLogix ODFC container path (VHDLocation): Modify as needed.

    • Manage ODFC Registry Options:

      • FSLogix ODFC Container Registry Options: Modify as needed.

    • Manage exclusions:

      • Exclude the Nerdio stored admin account from FSLogix: Select this option to prevent Nerdio admin's profile creation in FSLogix storage location. When FSLogix is having issues on a session host, there's still a way to sign in with an excluded user for troubleshooting purposes.

      • Exclude the domain admin account from FSLogix : Select this option to prevent domain admin's profile creation in FSLogix storage location. When FSLogix is having issues on a session host, there's still a way to sign in with an excluded user for troubleshooting purposes.

  4. Once you have entered the desired information, select OK.

Edit an Existing Global FSLogix Profiles Configuration

Nerdio Manager allows you to edit an existing global FSLogix profiles.

To edit an existing FSLogix profile:

  1. At the MSP level, navigate to SettingsIntegrations.

  2. In the Global FSLogix Profiles storage tile, locate the FSLogix you wish to work with.

  3. Select the profile name to display the edit window.

  4. Make all your desired changes and select OK to save the changes.

Remove an Existing Global FSLogix Profiles Configuration

Nerdio Manager allows you to remove existing global FSLogix profiles.

To remove an existing FSLogix profile:

  1. At the MSP level, navigate to SettingsIntegrations.

  2. In the Global FSLogix Profiles storage tile, locate the FSLogix you wish to work with.

  3. Select remove.

  4. On the confirmation pop-up window, select Confirm.

Assign Existing Global FSLogix Profiles to Accounts

Nerdio Manager allows you to assign an FSLogix profile to accounts.

To assign an existing FSLogix profile to accounts:

  1. At the MSP level, navigate to SettingsIntegrations.

  2. In the Global FSLogix Profiles storage tile, locate the FSLogix you wish to work with.

  3. Select assign.

  4. When prompted, select the customer(s) from the drop-down list.

  5. Once you have assigned the Global FSLogix Profile to one or more accounts, log into your customer account(s).

  6. Repeat the following steps for each customer account:

    • At the Account level, navigate to SettingsIntegrations.

    • In the FSLogix Profiles storage tile, select Add.

    • Global profile: From the drop-down, select the global FSLogix profile.

      Note: When a global profile is selected, all the fields are populated with the global profile's information. You may use the global settings or update them as per your customer's requirements.

    • Sync managed settings with Global configuration: Select this option to automatically sync any changes made to global profile to this profile.

    • See Add Global FSLogix Profiles Configuration for detailed information about the other settings.

  7. Once you have entered the desired information, select OK.

FSLogix Profile Deployment Per-Host Pool

Once you have configured the FSLogix version for your customer account, Nerdio Manager automatically installs the same FSLogix version, by default, when creating a new session host VMs or re-imaging an existing one. This setting can also be changed at the host pool level.

To configure customized FSLogix settings for a host pool:

Note: Any settings configured here are applied only to newly created or re-imaged hosts in this pool.

  1. At the Account level, locate the host pool you wish to work with.

  2. From the action menu, select Properties > FSLogix.

  3. Enter the following information:

    • Toggle Use FSLogix profiles to On.

      Note: If this option is not enabled, Nerdio Manager does not install the FSLogix profile container application on newly created VMs when they are deployed in this host pool. Existing VMs are not affected.

    • FSLogix profile: From the drop-down list, select the FSLogix profile to use.

      Notes:

      • Though FSLogix profile can be changed at host pool level, the corresponding FSLogix version number can't be changed at host pool level.

      • If you wish to customize the FSLogix settings, you must select Custom. Otherwise, you may not change the settings.

    • Use Cloud Cache: Select this option to enable FSLogix Cloud Cache.

      Tip: For performance reasons, it is strongly recommended that you use Premium SSD and Ephemeral OS disks when Cloud Cache is enabled. (Standard SSD disks might be sufficient in very small environments or a testing scenarios.)

      Note: See the following Microsoft document for more information about FSLogix Cloud Cache.

      Cloud Cache allows you to specify multiple profile storage location. It asynchronously replicates the profiles and makes the profiles available in multiple storage locations at the same time. So, if one of the locations is not available, the session host automatically fails over to one of the alternate locations.

    • Configure session hosts registry for Microsoft Entra Joined storage: Select this option Enable Entra ID Kerberos functionality and Entra ID account credentials loading.

    • Exclude the Nerdio stored admin account from FSLogix: Select this option to prevent Nerdio admin's profile creation in the FSLogix storage location. When FSLogix is having issues on a session host, there's still a way to sign in with an excluded user for troubleshooting purposes.

    • Exclude the domain admin account from FSLogix : Select this option to prevent domain admin's profile creation in FSLogix storage location. When FSLogix is having issues on a session host, there's still a way to sign in with an excluded user for troubleshooting purposes.

    • FSLogix version: From the drop-down list, select the FSLogix version you wish to use.

      Note: The most recent FSLogix version is marked as "Latest." You may select the latest version or an older version, as per your requirements.

    • FSLogix Profiles path: From the drop-down list, select an Azure Files share. Alternatively, type in a UNC path.

      Note: You can specify up to 4 paths. In addition, use the arrows to change the order of the paths. The profiles are created in all of these locations.

    • FSLogix Registry Options: From the drop-down list, select whether you want to work with Common settings or All settings.

      • For Common settings:

        • In the Value column, type the setting's value.

        • Select Reset to reset the setting

      • For All settings:

        • In the Configuration column, type the setting's value.

        • Select Clear to set a specific setting to Not configured.

        • Select Clear all to set all the settings to Not configured.

        • Select Reset to Nerdio defaults to set all the settings to Nerdio defaults.

    • Configure Office Container to redirect Microsoft Officer user data: Toggle on this option to redirect only areas of the profile that are specific to Microsoft Office.

      Note: Office Containers separate Microsoft Office data (for example, OST files) from the overall user profile for easier troubleshooting. Office Containers and Profile Containers are stored in separate VHDX files can be stored on different file shares. See this Microsoft article for details.

      • FSLogix ODFC container path ($VHDLocation): Modify as needed.

      • FSLogix ODFC container Registry Options: Modify as needed.

    • Redirections: Select this option if you want to include Redirections in the global profile for re-use across customers.

      Note: See this Microsoft article for more information about redirections.

    • Apply to existing hosts: Select this option to apply these changes to existing hosts. Otherwise, the change only effect new or re-imaged hosts.

      • Process hosts in groups of: Type the number of concurrent actions to execute during this bulk operation.

      • Number of failures before aborting: Type the number of failures that causes the process to stop.

      • Messaging: Toggle on the Messaging to send messages to active users.

        • Delay: From the drop-down list, select the number of minutes to wait after sending the message before starting the process.

        • Message: Type the message you want to send to the users.

  4. Once you have entered all the desired information, select Save or Save & close.

Notes:

  • You can add DWORD values in the format: "ValueName":dword:ValueData (example: "ProfileType"=dword:00000003).

  • You can add string values in the format: "ValueName":"ValueData" (example: "VolumeType":"vhdx").

  • These values are added under the HKLM\SOFTWARE\FSLogix\Profiles key. See the above link for Microsoft documentation on the FSLogix profile container registry reference.

View FSLogix Profile Version for Host Pools and Session Hosts

Once you have configured the FSLogix version for your customer account, by default the same FSLogix version is applied on newly created host pools or session host VMs, or re-imaged hosts on existing host pools.

To view the FSLogix version number for your host pool and session hosts:

  1. At the Account level, locate the host pool you wish to work with.

  2. From the action menu, select Properties > FSLogix.

  3. To view the FSLogix version number for session host in your host pool, select Manage Hosts .

Was this article helpful?

1 out of 1 found this helpful
Have more questions? Submit a request

Comments (0 comments)

Please sign in to leave a comment.