Versions Compared

Key

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



Info

Per User / Per Group Configuration Settings can be made that override the default settings.


The admin can choose to manage the settings via Group Policy Template Files, or direct registry access, or both.

Direct Registry Settings

Registry Key: HKLM\SOFTWARE\Policies\FSLogix\ODFC


Value Name
Value Type
Default Setting
Description
AccessNetworkAsComputerObjectDWORD00: default – attach as user. 1 – attach as computer; folder must have permissions for computer objects.
AttachVHDSDDLREG_SZ
SDDL string representing the ACLs to use when attaching the VHD. See the What are ACLs and SDDL? appendix for more information.
CCDLocationsREG_SZ
See FSLogix Cloud Cache Configuration Settings for details about configuring.
ConcurrentUserSessionsDWORD1

0: don’t handle concurrent sessions. 1 : handle concurrent sessions.

Note

Note: If you are using the Windows server feature to allow concurrent logins for the same Windows account on the same server (seen most often with Citrix XenApp), you must have this set to 1.


DiffDiskParentFolderPathREG_SZ%TEMP%Specifies the path where difference disks will be created (when VHDAccessMode is configured to use them). Variables may be used in this value. Supported variables are %username%, %userdomain%, %sid%, %osmajor%, %osminor%, %osbuild%, %osservicepack%, %profileversion%, %clientname%, and any environment variable.
Enabled (required setting)DWORD01: O365 Container system enabled. 0: O365 Container system disabled.
FlipFlopProfileDirectoryNameDWORD0When set to ‘1’ the SID folder is created as “%username%_%sid%” instead of the default “%sid%_%username%”. Note that using this setting has the same effect as setting SIDDirNamePattern = “%username%_%sid%” and SIDDirNameMatch = “%username%_%sid%”.
IncludeOfficeActivationDWORD11: Office activation data is redirected to the container. 0: Office activation data is not redirected to the container.
IncludeOfficeFileCacheDWORD1

1: Office Cache Data is redirected to the container. 0: Office Cache Data is not redirected to the container.

Note

Note: This setting is specific to Office 2016.


IncludeOneDriveDWORD11: OneDrive cache is redirected to the container. 0: OneDrive cache is not redirected to the container.
IncludeOneNoteDWORD01: OneNote notebook files are redirected to the container. 0: OneNote notebook files are not redirected to the container.
IncludeOneNote_UWPDWORD01: OneNote UWP notebook files are redirected to the container. 0: OneNote UWP notebook files are not redirected to the container.
IncludeOutlookDWORD11: Outlook data is redirected to the container. 0: Outlook data is not redirected to the container.
IncludeOutlookPersonalizationDWORD11: Outlook personalization data is redirected to the container. 0: Outlook personalization data is not redirected to the container.
IncludeSharepointDWORD11: Sharepoint data is redirected to the container. 0: Sharepoint data is not redirected to the container.
IncludeSkypeDWORD11: Skype for Business Global Address List is redirected to the container. 0: Skype for Business Global Address List is not redirected to the container.
IncludeTeamsDWORD01: Teams data is redirected to the container. 0: Teams data is not redirected to the container. NOTE: User will be required to sign in to teams at the beginning of each session.
IsDynamicDWORD1If set to ‘1’ the VHD(X) that is created will be dynamic. If set to ‘0’ the created VHD(X) will be fixed size.
LockedRetryCountDWORD012Specifies the number of retries to perform when a VHD(X) file is locked (open by another process or computer).
LockedRetryIntervalDWORD5Specifies the number of seconds to wait between retries (set by LockedRetryCount above).
MirrorLocalOSTToVHDDWORD0
  • A value of '0' means do nothing with an existing OST file.
  • A value of '1' means when a new VHD is created and there are contents in the local OST folder, they will be copied to the VHD before the user is given access.
  • A value of '2' means when a new VHD is created and there are contents in the local OST folder, they will be moved to the VHD before the user is given access.
NoProfileContainingFolderDWORD0If set to ‘1’ the FSLogix O365 Container system will not use or create a SID containing folder for the VHD(X) file. This is intended for situations where the storage provides a location that is already unique per-user. The default settings for matching VHD names will not work correctly if this setting is enabled and VHDs for multiple users are stored in the same location.
NumSessionVHDsToKeepDWORD2This setting is used when VHDAccessMode is set to '3'. This controls the number of session VHDs that are persistent. For example, if this is set to '2' and the user creates a 3rd session, a new session VHD will be created and used, but it will be deleted when the 3rd session ends.
OutlookCachedModeDWORD1

If set to '1' and the O365 Container is successfully attached, the Outlook setting that enables cached mode and length of cache (typically set via an MS GPO) will not be disabled by the registry entry given below. This can be used to ensure that cached mode is only used when the container is attached. '0' prevents FSLogix from doing anything with cached mode.

Note

In order for this feature to work, Outlook must be configured for online mode, which ensures that if FSLogix gets disabled that large OST files will not be downloaded.

HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\office\16.0\Outlook\OST\NoOST:DWORD = 2

Please see this KB for a walk through of how these settings (OutlookCachedMode and the NoOST registry entry) may be used together - First session cached, subsequent sessions use on-line mode.


OutlookFolderPathREG_SZ
The path to the user’s Outlook folder.  Default is “%userprofile%\AppData\Local\Microsoft\Outlook
ReAttachRetryCountDWORD60Specifies the number of times the system should attempt to re-attach the VHD(X) container if it is disconnected unexpectedly.
ReAttachIntervalSecondsDWORD10Specifies the number of seconds to wait between retries when attempting to re-attach the VHD(X) container if it is disconnected unexpectedly.
RedirectTypeDWORD2A value of '1' means, "Use legacy redirection". A value of '2' (default) means, "Use FSLogix advanced redirection".
RemoveOrphanedOSTFilesOnLogoffDWORD0A value of '0' or lack of this setting results in no action. A value of '1' will cause duplicate OST files to be removed. Please read below in full prior to setting. In rare cases duplicate OST files are created for a user. This circumstance occurs outside of the use of a non-persistent profile. When the profile is stored in the standard file system, administrators may remove Orphaned or Stale OST files by deleting them. Because an OST file in a VHD is not as visible, over long periods of time duplicate OST files may consume incremental disk space. Setting this option to 1 will cause Profile Container and/or Office 365 Container to automatically remove all OST files in a VHD(X) except the OST with the latest modify date. NOTE: an administrator should be very familiar with the use and function of OST files, as well as potential implications, prior to choosing to enable this setting.
RoamSearchDWORD0


Used to control the FSLogix Search Roaming feature. Set to '1' or '2' to enable the feature. See Roaming the Windows Search Database for details.

SIDDirNameMatchREG_SZ%sid%_%username%

Specifies a string pattern used to match (find) the SID directory. Variable names are delimited with '%' characters. Supported variables are %username%, %userdomain%, %sid%, %osmajor%, %osminor%, %osbuild%, %osservicepack%, %profileversion%, %clientname%, and any environment variable.

Note

In almost all cases SIDDirNameMatch and SIDDirNamePattern should match. Unless there is a well understood use case that requires these settings to be different, please verify SIDDirNameMatch and SIDDirNamePattern are the same when setting either.


SIDDirNamePatternREG_SZ%sid%_%username%

Specifies a string pattern used when creating a SID container folder. Variable names are delimited with '%' characters. Supported variables are %username%, %userdomain%, %sid%, %osmajor%, %osminor%, %osbuild%, %osservicepack%, %profileversion% , %clientname%, and any environment variable.

Note

In almost all cases SIDDirNameMatch and SIDDirNamePattern should match. Unless there is a well understood use case that requires these settings to be different, please verify SIDDirNameMatch and SIDDirNamePattern are the same when setting either.


SizeInMBsDWORD30000 (30 GBs)Specifies the size of newly created VHD(X) in number of MBs.
VHDAccessModeDWORD0
  • A value of '0' (default) means normal direct access behavior. This is the simplest access model, but only allows one concurrent session.
  • A value of '1' means that a difference disk will be used and stored on the network. This allows for simultaneous session access. This mode should not be used if the O365 Container is being used with Outlook Cached Exchange mode.
  • A value of '2' means that a difference disk will be used and stored on the local machine. This allows for simultaneous session access. This mode should not be used if the O365 Container is being used with Outlook Cached Exchange mode.
  • A value of '3' means that a unique VHD(X) will be used for each concurrent session. These VHD(X) files will typically persist so that they can be used the next time a user creates a session. To control the number of VHD(X) files that will persist, see the NumSessionVHDsToKeep setting.

    Note

    If the O365 Container is being used with Outlook Cached Exchange mode, VHDAccessMode 0 or 3 must be used. More detail on these options is available here.


VHDNameMatchREG_SZODFC*

Specifies a string pattern used to match (find) the profile VHD(X) file. Variable names are delimited with '%' characters. Supported variables are %username%, %userdomain%, %sid%,%osmajor%, %osminor%, %osbuild%, %osservicepack%, %profileversion%, %clientname%, and any environment variable.

Note

Beginning in 2.9.4 VHDNameMatch appends either .vhd or .vhdx to the Name Match string. Prior to 2.9.4 this search used a .* rather than specifying the file type. the VolumeType setting will determine which file type is appended.


VHDNamePatternREG_SZODFC_%username%Specifies a string pattern used when creating a profile VHD(X) file. Variable names are delimited with '%' characters. Supported variables are %username%, %userdomain%, %sid%,%osmajor%, %osminor%, %osbuild%, %osservicepack%, %profileversion%, %clientname%, and any environment variable.
VHDLocations (required setting)REG_SZ / MULTI_SZ

A list of file system locations to search for the user’s profile VHD(X) file. If one is not found, one will be created in the first listed location. If the VHD path does not exist it will be created before it checks if a VHD(X) exists in the path. These values can contain variables which will be resolved. Supported variables are %username%, %userdomain%, %sid%, %osmajor%, %osminor%, %osbuild%, %osservicepack%, %profileversion% , and any environment variable.

When specified as a REG_SZ value, multiple locations can be separated with a semi-colon.

VHDXSectorSizeDWORD0 (system default)Sector size to use if the file being created is a VHDX. Currently can only be 512 (0x200) or 4096 (0x1000).
VolumeTypeREG_SZ"vhd"A value of “vhd” means that newly created files should be of type VHD. A value of “vhdx” means that newly created files should be of type VHDX.
VolumeWaitTimeMSDWORD20000 (20 seconds)Specifies the number of milliseconds the system should wait for the volume to arrive after the VHD(X) has been attached.



Noprint