Change the upgrade policy on Virtual Machine Scale Sets

Note

Automatic, manual and rolling upgrade policy is available for Virtual Machine Scale sets with Uniform Orchestration.

Only manual upgrade policy is available for Virtual Machine scale Sets with Flexible Orchestration. Manual upgrade policy for Virtual Machine Scale Sets with Flexible Orchestration is 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.

Portal

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.

If using a rolling upgrade policy, see configure rolling upgrade policy for more configuration options and suggestions.

CLI

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

If using a rolling upgrade policy, see configure rolling upgrade policy for more configuration options and suggestions.

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

PowerShell

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

If using a rolling upgrade policy, see configure rolling upgrade policy for more configuration options and suggestions.

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

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

ARM Template

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

If using a rolling upgrade policy, see configure rolling upgrade policy for more configuration options and suggestions.

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

Next steps

Learn how to configure rolling upgrade policy on Virtual Machine Scale Sets.