Skip to end of metadata
Go to start of metadata


Per User-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\FSLogix\Profiles

Value NameValue TypeDefault SettingDescription
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.
CheckLocationsForCreateDWORD11: check locations. 0: don't check. When the FSLogix Profiles system decides that it needs to create a VHD/X for the user, return the first location in VHDLocations where the user has create access.
ConcurrentUserSessionsDWORD1

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

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.

DeleteLocalProfileWhenVHDShouldApplyDWORD0

0: no deletion. 1: delete local profile if exists and matches the profile being loaded from VHD.

Please use caution with this setting. When the FSLogix Profiles system determines that a user should have a FSLogix profile but a local profile exists, the local profile WILL BE REMOVED and the user logged on with the FSLogix profile.

DiffDiskParentFolderPathREG_SZ%TEMP%Specifies the path where difference disks will be created (when ProfileType 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: Profile system enabled. 0: Profile 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%”.
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.
KeepLocalDirDWORD0If set to ‘1’ the “local_%username%” folder will be left on the system after logoff and will also be used again if the same user logs on again.
LockedRetryCountDWORD0Specifies 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 (see LockedRetryCount).
NoProfileContainingFolderDWORD0If set to ‘1’ the FSLogix Profiles 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.
OutlookCachedModeDWORD1

If set to '1' and the Profile Container is successfully attached, the Outlook setting that enables cached mode will be temporarily set until the container is detached. 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.

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

ProfileDirSDDLREG_SZ

SDDL string representing the ACLs to use when creating the profile directory (e.g. “C:\Users\%username%). See the What are ACLs and SDDL? appendix for more information.

Variables may be used in this SDDL string. Variable names are delimited with '%' characters. Supported variables are %username%, %userdomain%, %sid%, %osmajor%, %osminor%, %osbuild%, %osservicepack%, %profileversion%, %clientname%, and any environment variable.

The most common of these variables used will likely be sid and in the SDDL this would be specified as %sid% in order for it to be processed and replaced.

ProfileTypeDWORD0

A value of '0' (default) means normal profile behavior. A value of '1' means that this machine should only be the RW profile instance. A value of '2' means that this machine should only be the RO profile instance. A value of '3' means that the machine should try to take the RW role and if it can't, it should fall back to a RO role.  

All sessions trying to use the VHD concurrently must have a ProfileType of 1, 2, or 3. If the VHD is not accessed concurrently, ProfileType should be 0.

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.
RebootOnUserLogoffDWORD0

A value of ‘0’ means, “Take no action”. A value of ‘1’ means, “Reboot when any user logs off”, a value of ‘2’ means, “Reboot when a FSLogix Profile user logs off”.

RedirectTypeDWORD2A value of '1' means, "Use legacy redirection". A value of '2' (default) means, "Use FSLogix advanced redirection".
RedirXMLSourceFolderREG_SZ
RedirXMLSourceFolder = <path to File System e.g. "\\someserver\someshare">) If the folder contains a redirections.xml, it will be copied to the local profile and immediately used. Variable names are delimited with '%' characters. Supported variables are %username%, %userdomain%, %sid%, %osmajor%, %osminor%, %osbuild%, %osservicepack%, %profileversion%, %clientname%, and any environment variable.
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.
SetTempToLocalPathDWORD3A value of ‘0’ means, “Take no action”. A value of ‘1’ means, “Redirect TEMP and TMP to the local drive”. A value of ‘2’ means, “Redirect INetCache to the local drive”. A value of ‘3’means, “Redirect TEMP, TMP, and INetCache to the local drive.”
ShutdownOnUserLogoffDWORD0A value of ‘0’ means, “Take no action”. A value of ‘1’ means, “Shutdown when any user logs off”, a value of ‘2’ means, “Shutdown when a FSLogix Profile user logs off”.
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.

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.

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.

SIDDirSDDLREG_SZ
SDDL string representing the ACLs to use when creating the SID container folder. See the What are ACLs and SDDL? appendix for more information.
SizeInMBsDWORD30000 (30 GBs)Specifies the size of newly created VHD(X) in number of MBs.
VHDNameMatchREG_SZProfile*

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.

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_SZProfile_%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.







  • No labels