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

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.

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.

Note

Setting or changing the upgrade policy to automatic using the Azure Portal on Virtual Machine Scale Sets with Flexible Orchestration is not yet available. To change the upgrade policy to automatic, use CLI, PowerShell, ARM Template, or any other SDK.

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=Automatic

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": "automatic",
        }
    }

Next steps

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