Skip to main content

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