FSLogix › Profile Containers › Cloud Cache
Healthy Providers Required For Register
Supported on v2105 or later
What it does
NOTE: Once this policy is Enabled, only Disable will remove the registry value. Enabled to Not Configured will have NO EFFECT. This setting specifies the number of healthy CCD Locations required to allow a sign in. If using the default setting, users will always be allowed to sign in, even if no CCD Locations are available. If a user signs in with no available CCD Locations, FSLogix assumes that one or more CCD Locations will become available prior to the user signing out. If a CCD Locations does not become available during the time of the user session, then the user is prevented from signing out (discussed in Healthy Provider Required For Unregister). If it is desired to block a user from signing in and a minimum number of CCD Locations are not available, the Healthy Providers Required For Register may be set to the number of CCD Locations required for a sign in. If the minimum number of CCD Locations required for registration aren't available, then the sign in will fail. When setting Healthy Providers Required For Register to anything other than 0, then Prevent Login With Failure and/or Preven tLogin With Temp Profile should be used in order to create the desired user experience. Registry Entry: HKLM\SOFTWARE\FSLogix\Profiles\HealthyProvidersRequiredForRegister Type: DWORD Values: Min = 0, Max = 4
What it writes
- Hive
- HKEY_LOCAL_MACHINE
- Registry key
Software\FSLogix\Profiles
Options
| Option | Type | Registry value | Allowed values |
|---|---|---|---|
| Healthy Providers Required For RegisterRequiredDefault: 0 | Number | HealthyProvidersRequiredForRegister |
0 to 4 |
Configure and deploy
Choose a state and the option values; the output below is generated from the template for exactly that.
Enabled · Computer · template defaults
Registry file (.reg)
Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\Software\FSLogix\Profiles]
"HealthyProvidersRequiredForRegister"=dword:00000000
PowerShell
$ErrorActionPreference = 'Stop'
function Set-RegistryValue {
param(
[Parameter(Mandatory = $true)][string] $Path,
[Parameter(Mandatory = $true)][string] $Name,
[Parameter(Mandatory = $true)][string] $PropertyType,
[Parameter(Mandatory = $true)][object] $Value
)
if (-not (Test-Path -LiteralPath $Path)) {
New-Item -Path $Path -Force | Out-Null
}
New-ItemProperty -LiteralPath $Path -Name $Name -PropertyType $PropertyType -Value $Value -Force | Out-Null
}
function Remove-RegistryValue {
param(
[Parameter(Mandatory = $true)][string] $Path,
[Parameter(Mandatory = $true)][string] $Name
)
if (Test-Path -LiteralPath $Path) {
Remove-ItemProperty -LiteralPath $Path -Name $Name -Force -ErrorAction SilentlyContinue
}
}
function Clear-RegistryKeyValues {
param(
[Parameter(Mandatory = $true)][string] $Path
)
if (-not (Test-Path -LiteralPath $Path)) {
return
}
foreach ($propertyName in (Get-Item -LiteralPath $Path).Property) {
Remove-ItemProperty -LiteralPath $Path -Name $propertyName -Force -ErrorAction SilentlyContinue
}
}
# Policy: Healthy Providers Required For Register
# Name: ProfilesHealthyProvidersRequiredForRegister
# Scope: Machine
# State: Enabled
# Source: fslogix.admx
Set-RegistryValue -Path 'Registry::HKEY_LOCAL_MACHINE\Software\FSLogix\Profiles' -Name 'HealthyProvidersRequiredForRegister' -PropertyType 'DWord' -Value 0
- The OMA-URI is an inferred ADMX-backed Policy CSP candidate derived from the source ADMX file name and policy name.
- Some Microsoft policies use built-in Policy CSP pages whose area names don't match the ADMX file name, so verify the candidate against Microsoft Learn before deployment.
ADMX profile candidate (OMA-URI)
./Device/Vendor/MSFT/Policy/Config/ADMX_fslogix/ProfilesHealthyProvidersRequiredForRegisterADMX SyncML candidate
<SyncML xmlns="SYNCML:SYNCML1.2">
<SyncBody>
<Replace>
<CmdID>1</CmdID>
<Item>
<Meta>
<Format>chr</Format>
<Type>text/plain</Type>
</Meta>
<Target>
<LocURI>./Device/Vendor/MSFT/Policy/Config/ADMX_fslogix/ProfilesHealthyProvidersRequiredForRegister</LocURI>
</Target>
<Data><enabled/>
<data id="ProfilesHealthyProvidersRequiredForRegister" value="0"/></Data>
</Item>
</Replace>
<Final/>
</SyncBody>
</SyncML>Intune remediation scripts
Detection
$ErrorActionPreference = 'Stop'
$reasons = [System.Collections.Generic.List[string]]::new()
function Test-RegistryValueExists {
param(
[Parameter(Mandatory = $true)][string] $Path,
[Parameter(Mandatory = $true)][string] $Name
)
if (-not (Test-Path -LiteralPath $Path)) {
return $false
}
return $null -ne (Get-ItemProperty -LiteralPath $Path -Name $Name -ErrorAction SilentlyContinue)
}
function Test-RegistryValueEquals {
param(
[Parameter(Mandatory = $true)][string] $Path,
[Parameter(Mandatory = $true)][string] $Name,
[Parameter(Mandatory = $true)][string] $Kind,
[Parameter(Mandatory = $true)][object] $Expected
)
if (-not (Test-Path -LiteralPath $Path)) {
return $false
}
$valueObject = Get-ItemProperty -LiteralPath $Path -Name $Name -ErrorAction SilentlyContinue
if ($null -eq $valueObject) {
return $false
}
$actual = $valueObject.$Name
switch ($Kind) {
'String' { return [string]$actual -ceq [string]$Expected }
'ExpandString' { return [string]$actual -ceq [string]$Expected }
'DWord' { return [uint32]$actual -eq [uint32]$Expected }
'QWord' { return [uint64]$actual -eq [uint64]$Expected }
'MultiString' {
$actualArray = @($actual)
$expectedArray = @($Expected)
if ($actualArray.Count -ne $expectedArray.Count) { return $false }
for ($index = 0; $index -lt $actualArray.Count; $index++) {
if ([string]$actualArray[$index] -cne [string]$expectedArray[$index]) { return $false }
}
return $true
}
'Binary' {
$actualArray = [byte[]]$actual
$expectedArray = [byte[]]$Expected
if ($actualArray.Length -ne $expectedArray.Length) { return $false }
for ($index = 0; $index -lt $actualArray.Length; $index++) {
if ($actualArray[$index] -ne $expectedArray[$index]) { return $false }
}
return $true
}
default { return [string]$actual -ceq [string]$Expected }
}
}
# Policy: Healthy Providers Required For Register
# Name: ProfilesHealthyProvidersRequiredForRegister
# Scope: Machine
# State: Enabled
# Source: fslogix.admx
$isMatch = Test-RegistryValueEquals -Path 'Registry::HKEY_LOCAL_MACHINE\Software\FSLogix\Profiles' -Name 'HealthyProvidersRequiredForRegister' -Kind 'DWord' -Expected 0
if (-not $isMatch) {
$reasons.Add('Value mismatch: HKEY_LOCAL_MACHINE\Software\FSLogix\Profiles\HealthyProvidersRequiredForRegister') | Out-Null
}
if ($reasons.Count -eq 0) {
Write-Output 'Compliant'
exit 0
}
$reasons | ForEach-Object { Write-Output $_ }
exit 1
Remediation
$ErrorActionPreference = 'Stop'
function Set-RegistryValue {
param(
[Parameter(Mandatory = $true)][string] $Path,
[Parameter(Mandatory = $true)][string] $Name,
[Parameter(Mandatory = $true)][string] $PropertyType,
[Parameter(Mandatory = $true)][object] $Value
)
if (-not (Test-Path -LiteralPath $Path)) {
New-Item -Path $Path -Force | Out-Null
}
New-ItemProperty -LiteralPath $Path -Name $Name -PropertyType $PropertyType -Value $Value -Force | Out-Null
}
function Remove-RegistryValue {
param(
[Parameter(Mandatory = $true)][string] $Path,
[Parameter(Mandatory = $true)][string] $Name
)
if (Test-Path -LiteralPath $Path) {
Remove-ItemProperty -LiteralPath $Path -Name $Name -Force -ErrorAction SilentlyContinue
}
}
function Clear-RegistryKeyValues {
param(
[Parameter(Mandatory = $true)][string] $Path
)
if (-not (Test-Path -LiteralPath $Path)) {
return
}
foreach ($propertyName in (Get-Item -LiteralPath $Path).Property) {
Remove-ItemProperty -LiteralPath $Path -Name $propertyName -Force -ErrorAction SilentlyContinue
}
}
# Policy: Healthy Providers Required For Register
# Name: ProfilesHealthyProvidersRequiredForRegister
# Scope: Machine
# State: Enabled
# Source: fslogix.admx
Set-RegistryValue -Path 'Registry::HKEY_LOCAL_MACHINE\Software\FSLogix\Profiles' -Name 'HealthyProvidersRequiredForRegister' -PropertyType 'DWord' -Value 0
History 1 retained release
- 26.0827 Aug 2026
- Already present in the first release ChangeIntel keeps.
Template
- Internal name
ProfilesHealthyProvidersRequiredForRegister- Namespace
FSLogix.Policies- Template file
fslogix.admx- Release
- Microsoft FSLogix 26.08 · file set
d042c1d887a47461…
Definition, editor controls and support
Definition
<policy class="Machine" displayName="$(string.ProfilesHealthyProvidersRequiredForRegister_Display)" explainText="$(string.ProfilesHealthyProvidersRequiredForRegister_Explain)" key="Software\FSLogix\Profiles" name="ProfilesHealthyProvidersRequiredForRegister" presentation="$(presentation.ProfilesHealthyProvidersRequiredForRegister)" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
<parentCategory ref="FSLogix.Policies:Profiles_CCD" />
<supportedOn ref="FSLogix.Policies:v2105" />
<elements>
<decimal id="ProfilesHealthyProvidersRequiredForRegister" key="Software\FSLogix\Profiles" maxValue="4" required="true" valueName="HealthyProvidersRequiredForRegister" />
</elements>
</policy>Editor controls
<presentation id="ProfilesHealthyProvidersRequiredForRegister" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
<decimalTextBox defaultValue="0" refId="ProfilesHealthyProvidersRequiredForRegister">Healthy Providers Required For Register</decimalTextBox>
</presentation>Supported platforms and category
FSLogix.Policies:category:FSLogix
<category displayName="$(string.FSLogix_Category)" name="FSLogix" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions" />
FSLogix.Policies:category:Profiles
<category displayName="$(string.Profiles_Category)" name="Profiles" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
<parentCategory ref="FSLogix.Policies:FSLogix" />
</category>
FSLogix.Policies:category:Profiles_CCD
<category displayName="$(string.Profiles_CCD_Category)" name="Profiles_CCD" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
<parentCategory ref="FSLogix.Policies:Profiles" />
</category>
FSLogix.Policies:definition:v2105
<definition displayName="$(string.v2105_Definition)" name="v2105" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions" />
FSLogix.Policies:category:FSLogix
<category displayName="$(string.FSLogix_Category)" name="FSLogix" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions" />
<strings><string id="FSLogix.Policies:FSLogix_Category">FSLogix</string></strings>
FSLogix.Policies:category:Profiles
<category displayName="$(string.Profiles_Category)" name="Profiles" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
<parentCategory ref="FSLogix.Policies:FSLogix" />
</category>
<strings><string id="FSLogix.Policies:Profiles_Category">Profile Containers</string></strings>
FSLogix.Policies:category:Profiles_CCD
<category displayName="$(string.Profiles_CCD_Category)" name="Profiles_CCD" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
<parentCategory ref="FSLogix.Policies:Profiles" />
</category>
<strings><string id="FSLogix.Policies:Profiles_CCD_Category">Cloud Cache</string></strings>
FSLogix.Policies:definition:v2105
<definition displayName="$(string.v2105_Definition)" name="v2105" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions" />
<strings><string id="FSLogix.Policies:v2105_Definition">v2105 or later</string></strings>