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, NotificationSetting, and restore point configuration.

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" -DisableRestartPrompts $true

EXAMPLE 4

Update-CPCUserSettingsPolicy -Name "Your Settings Policy" -SelfServiceEnabled $true

PARAMETERS

-Name

Name of the User Settings Policy to update

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.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisableRestartPrompts

When $true, disables the restart prompts shown to the user on the Cloud PC (notificationSetting).

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-SelfServiceEnabled

Allow or prevent targeted users from performing self-service actions (e.g. upgrading their Cloud PC) from within the Windows 365 app. Uses the Graph beta selfServiceEnabled property.

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

API reference: https://learn.microsoft.com/en-us/graph/api/cloudpcusersetting-update

RELATED LINKS