Skip to main content

Invoke-CPCResize

SYNOPSIS​

Resizes a Cloud PC to a new service plan (vCPU and storage configuration)

SYNTAX​

ById (Default)​

Invoke-CPCResize -Name <String> -ServicePlanId <String> [-ProgressAction <ActionPreference>] [-WhatIf]
[-Confirm] [<CommonParameters>]

ByName​

Invoke-CPCResize -Name <String> -ServicePlanName <String> [-ProgressAction <ActionPreference>] [-WhatIf]
[-Confirm] [<CommonParameters>]

DESCRIPTION​

The function upgrades or downgrades an existing Cloud PC to a configuration with a new virtual CPU (vCPU) and storage size by targeting a new service plan. The target service plan ID can be provided directly, or resolved by display name using the ServicePlanName parameter. Use Get-CPCServicePlan to discover available service plan IDs and their display names.

EXAMPLES​

EXAMPLE 1​

Invoke-CPCResize -Name "CloudPC01" -ServicePlanId "30d0e128-de93-41dc-89ec-33d84bb662a0"

EXAMPLE 2​

Invoke-CPCResize -Name "CloudPC01" -ServicePlanName "Windows 365 Enterprise 4 vCPU, 16 GB, 256 GB"

PARAMETERS​

-Name​

Enter the display name of the Cloud PC to resize

Type: String
Parameter Sets: (All)
Aliases:

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

-ServicePlanId​

Enter the target service plan ID (GUID) to resize the Cloud PC to

Type: String
Parameter Sets: ById
Aliases:

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

-ServicePlanName​

Enter the display name of the target service plan to resize the Cloud PC to. The function will resolve the ID automatically using Get-CPCServicePlan.

Type: String
Parameter Sets: ByName
Aliases:

Required: True
Position: Named
Default value: None
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​