Share via

Configure profile containers using FSLogix

  • Article

FSLogix profile containers are a complete roaming user profile solution for Windows desktop scenarios, such as Azure Virtual Desktop. Users can sign in to different devices and want their customization and personalization data roam to whichever device or session they connect to.

A profile container (single container), redirects the entire Windows user profile into a virtual hard disk (VHD) stored on a storage provider. The most common storage provider is an SMB file share. For more information, see Container storage options.

The profile container includes all Microsoft 365 application data and is inclusive of all the benefits and uses found in the ODFC container. If you configure a profile container, you don't need to configure an ODFC container.

Note

Using the profile container in a single container configuration is recommended.

This article doesn't cover how to convert to/from single or dual containers.

Prerequisites

Before you can configure profile containers using FSLogix, you need:

Profile container configuration

To configure your profile container:

  1. Verify FSLogix installation and version.

  2. Sign-in to the virtual machine as a local administrator or with an account with administrative privileges.

  3. Open the Registry Editor and navigate to HKEY_LOCAL_MACHINE\SOFTWARE\FSLogix\Profiles.

  4. Add the following settings:

    Value Name Data Type Data Description
    Enabled DWORD 1 Required
    DeleteLocalProfileWhenVHDShouldApply DWORD 1 Recommended to ensure user's don't use local profiles and lose data unexpectedly.
    FlipFlopProfileDirectoryName DWORD 1 Recommended. Provides an easier way to browse the container directories.
    LockedRetryCount DWORD 3 Recommended. Decreases the retry timing to enable a faster fail scenario.
    LockedRetryInterval DWORD 15 Recommended. Decreases the retry timing to enable a faster fail scenario.
    ProfileType DWORD 0 Default. Single connections reduce complexity and increase performance.
    ReAttachIntervalSeconds DWORD 15 Recommended. Decreases the retry timing to enable a faster fail scenario.
    ReAttachRetryCount DWORD 3 Recommended. Decreases the retry timing to enable a faster fail scenario.
    SizeInMBs DWORD 30000 Default
    VHDLocations MULTI_SZ or REG_SZ SMB Share path For example: \\<storage-account-name>.file.core.windows.net\<share-name>
    VolumeType REG_SZ VHDX Recommended. VHDX is preferred over VHD due to its supported size and reduced corruption scenarios.

    Note

    These settings are used to configure a standard profile container. To view more registry settings and configurations, see Configuration examples.

    You can use these PowerShell commands to add the registry settings:

    $VHDLocations = "\\<STORAGE-ACCOUNT-NAME>.file.core.windows.net\<SHARE-NAME>"
New-ItemProperty -Path HKLM:\SOFTWARE\FSLogix\Profiles\ -Name Enabled -PropertyType dword -Value 1 -Force
New-ItemProperty -Path HKLM:\SOFTWARE\FSLogix\Profiles\ -Name DeleteLocalProfileWhenVHDShouldApply -PropertyType dword -Value 1 -Force
New-ItemProperty -Path HKLM:\SOFTWARE\FSLogix\Profiles\ -Name FlipFlopProfileDirectoryName -PropertyType dword -Value 1 -Force
New-ItemProperty -Path HKLM:\SOFTWARE\FSLogix\Profiles\ -Name LockedRetryCount -PropertyType dword -Value 3 -Force
New-ItemProperty -Path HKLM:\SOFTWARE\FSLogix\Profiles\ -Name LockedRetryInterval -PropertyType dword -Value 15 -Force
New-ItemProperty -Path HKLM:\SOFTWARE\FSLogix\Profiles\ -Name ProfileType -PropertyType dword -Value 0 -Force
New-ItemProperty -Path HKLM:\SOFTWARE\FSLogix\Profiles\ -Name ReAttachIntervalSeconds -PropertyType dword -Value 15 -Force
New-ItemProperty -Path HKLM:\SOFTWARE\FSLogix\Profiles\ -Name ReAttachRetryCount -PropertyType dword -Value 3 -Force
New-ItemProperty -Path HKLM:\SOFTWARE\FSLogix\Profiles\ -Name SizeInMBs -PropertyType dword -Value 30000 -Force
New-ItemProperty -Path HKLM:\SOFTWARE\FSLogix\Profiles\ -Name VHDLocations -PropertyType string -value $VHDLocations -Force
New-ItemProperty -Path HKLM:\SOFTWARE\FSLogix\Profiles\ -Name VolumeType -PropertyType string -Value vhdx -Force

Verify your profile container configuration

Once you configure the Windows device to use FSLogix profile containers, you can verify the configuration by following these steps:

  1. Sign in as a standard user.

  2. Open the Command Prompt and change the directory by running the following command:

    C:\Program Files\FSLogix\Apps

  3. Run the following command to list each redirect:

    `frx list-redirects`

    Here's an example of the output of the command:

    Active redirections
-------------------
\Device\HarddiskVolume4\Users\contoso => \Device\HarddiskVolume9\Profile
\Device\HarddiskVolume4\Users\contoso\AppData\Roaming\Microsoft\Protect => \Device\HarddiskVolume4\Users\local_contoso\AppData\Roaming\Microsoft\Protect
\Device\HarddiskVolume4\Users\contoso\AppData\Roaming\Microsoft\Credentials => \Device\HarddiskVolume4\Users\local_contoso\AppData\Roaming\Microsoft\Credentials
\Device\HarddiskVolume4\Users\contoso\AppData\Local\Microsoft\Credentials => \Device\HarddiskVolume4\Users\local_contoso\AppData\Local\Microsoft\Credentials
\Device\HarddiskVolume4\Users\contoso\AppData\Local\Microsoft\Office\16.0\OfficeFileCache => \Device\HarddiskVolume4\Users\local_contoso\AppData\Local\Microsoft\Office\16.0\OfficeFileCache
\Device\HarddiskVolume4\OneDriveTemp\S-1-5-21-000000000-000000000-0000000000-0000000 => \Device\HarddiskVolume9\ODTemp
\Device\HarddiskVolume4\$RECYCLE.BIN\S-1-5-21-000000000-000000000-0000000000-0000000 => \Device\HarddiskVolume9\PROFILE_RECYCLE.BIN
Operation completed successfully!

  4. Open File Explorer and open the full path you set for VHDLocations in the registry.

  5. Double-click the folder for the standard user.

  6. Locate the newly created VHDX container.

Related content

Learn more about how to use FSLogix: