Update-CPCUserSettingsPolicy
SYNOPSIS
Updates a User Settings Policy in the Intune Cloud PC Service
SYNTAX
Update-CPCUserSettingsPolicy -Name <String> [-LocalAdminEnabled <Boolean>] [-ResetEnabled <Boolean>]
[-UserRestoreEnabled <Boolean>] [-UserRestoreFrequency <String>] [-DisableRestartPrompts <Boolean>]
[-SelfServiceEnabled <Boolean>] [-ProgressAction <ActionPreference>] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Updates a User Settings Policy in the Intune Cloud PC Service. Supports updating LocalAdminEnabled, ResetEnabled and the restore point configuration.
Graph replaces the whole policy on an update, so the cmdlet reads the current policy and sends every setting back: only the parameters you pass are changed, all other settings (including the cross-region disaster recovery settings) are kept. Changes someone else makes to the policy between that read and the update are overwritten. The cmdlet returns no output.
The self-service and restart prompt settings were retired by Microsoft. -SelfServiceEnabled and -DisableRestartPrompts only write a warning and are not sent.
EXAMPLES
EXAMPLE 1
Update-CPCUserSettingsPolicy -Name "Your Settings Policy" -LocalAdminEnabled $true
EXAMPLE 2
Update-CPCUserSettingsPolicy -Name "Your Settings Policy" -LocalAdminEnabled $false -ResetEnabled $true -UserRestoreEnabled $true -UserRestoreFrequency 6
EXAMPLE 3
Update-CPCUserSettingsPolicy -Name "Your Settings Policy" -UserRestoreFrequency 4
PARAMETERS
-Name
Name of the User Settings Policy to update. The name must match exactly one policy.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-LocalAdminEnabled
Enable or disable local admin on the Cloud PC. When $true the end user is an admin of the Cloud PC.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-ResetEnabled
Allow targeted users to reprovision their Cloud PC from within the Windows 365 app and web app.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-UserRestoreEnabled
Enable or disable user-initiated restore from the Cloud PC restore point.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-UserRestoreFrequency
Frequency (in hours) at which restore point snapshots are captured. Valid values: 4, 6, 12, 16, 24. Sent as the restorePointSetting frequencyType (fourHours, sixHours, twelveHours, sixteenHours, twentyFourHours).
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableRestartPrompts
Retired: has no effect and writes a warning. Microsoft retired the notificationSetting (restartPromptsDisabled) of User Settings Policies on July 14, 2026.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-SelfServiceEnabled
Retired: has no effect and writes a warning. Microsoft retired the selfServiceEnabled setting of User Settings Policies on December 1, 2023.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ProgressAction
Determines how PowerShell responds to progress updates generated by a script, cmdlet, or provider, such as the progress bars generated by Write-Progress.
Type: ActionPreference
Parameter Sets: (All)
Aliases: proga
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
INPUTS
OUTPUTS
NOTES
Required permission: CloudPC.ReadWrite.All https://learn.microsoft.com/graph/api/cloudpcusersetting-update?view=graph-rest-beta https://learn.microsoft.com/graph/api/cloudpcusersetting-get?view=graph-rest-beta https://learn.microsoft.com/graph/api/resources/cloudpcusersetting?view=graph-rest-beta https://learn.microsoft.com/graph/api/resources/cloudpcrestorepointsetting?view=graph-rest-beta