Change the upgrade policy on Virtual Machine Scale Sets (Preview)

Article
08/19/2024

Note

Upgrade policies for Virtual Machine Scale Sets with Uniform Orchestration are in general availability (GA).

Upgrade policies for Virtual Machine Scale Sets with Flexible Orchestration are currently in preview. Previews are made available to you on the condition that you agree to the supplemental terms of use. Some aspects of these features may change prior to general availability (GA).

The upgrade policy for a Virtual Machine Scale Set can be changed at any point in time. Depending on your scenario, you may want to use a particular upgrade policy when setting up and developing your workload and once you're ready to move to production, change it to another upgrade policy mode.

Select the Virtual Machine Scale Set you want to change the upgrade policy for. In the menu under Settings, select Upgrade Policy and from the drop-down menu, select the upgrade policy you want to enable.

Update an existing Virtual Machine Scale Set using az vmss update and the --set parameter.

az vmss update \
    --name myScaleSet \
    --resource-group myResourceGroup \
    --set upgradePolicy.mode=Automatic

Update an existing Virtual Machine Scale Set using Update-AzVmss and the -UpgradePolicyMode to set the upgrade policy mode.

$vmss = Get-AzVmss -ResourceGroupName "myResourceGroup" -VMScaleSetName "myScaleSet"

Update-Azvmss `
    -ResourceGroupName "myResourceGroup" `
    -Name "myScaleSet" `
    -UpgradePolicyMode "Manual" `
    -VirtualMachineScaleSet $vmss

Update the properties section of your ARM template with the upgrade policy to set the upgrade policy mode.

"properties": {
        "upgradePolicy": {
            "mode": "automatic",
        }
    }

Change the upgrade policy on Virtual Machine Scale Sets (Preview)

Additional resources