Proposed Pull Request Change

📄 Document Links

View on GitHub View on Microsoft Learn

--- title: Set the upgrade policy mode on Virtual Machine Scale Sets description: Learn about to set the upgrade policy mode on Virtual Machine Scale Sets author: mimckitt ms.author: mimckitt ms.topic: how-to ms.service: azure-virtual-machine-scale-sets ms.date: 05/19/2026 ms.reviewer: wwilliams ms.custom: upgradepolicy, ignite-2024 # Customer intent: "As a cloud administrator, I want to set the upgrade policy mode for Virtual Machine Scale Sets during creation or post-deployment, so that I can control the upgrade process according to our operational needs." --- # Set the upgrade policy mode on Virtual Machine Scale Sets The upgrade policy mode can be set during scale set creation or changed post deployment. If you don't explicitly set the upgrade policy mode, it defaults to manual. To change the upgrade policy mode of an existing scale set deployment, see [changing the upgrade policy mode](virtual-machine-scale-sets-change-upgrade-policy.md). ### [Portal](#tab/portal) During the Virtual Machine Scale Set creation in the Azure portal, under the **Management** tab, set the upgrade policy to **Rolling**, **Automatic**, or **Manual**. If using a rolling upgrade policy mode, see [configure rolling upgrade policy mode](virtual-machine-scale-sets-configure-rolling-upgrades.md) for configuration settings and suggestions. :::image type="content" source="../virtual-machine-scale-sets/media/upgrade-policy/pick-upgrade-policy.png" alt-text="Screenshot showing deploying a scale set and enabling MaxSurge."::: ### [CLI](#tab/cli) When creating a new scale set using Azure CLI, use [az vmss create](/cli/azure/vmss#az-vmss-create) and the `-upgrade-policy-mode` to set the upgrade policy mode. If using a rolling upgrade policy mode, see [configure rolling upgrade policy](virtual-machine-scale-sets-configure-rolling-upgrades.md) for configuration settings and suggestions. ```azurecli-interactive az group create --name myResourceGroup --location westus ``` ```azurecli-interactive az vmss create \ --resource-group myResourceGroup \ --name myScaleSet \ --orchestration-mode Flexible \ --image Ubuntu2204 \ --lb myLoadBalancer \ --upgrade-policy-mode manual \ --instance-count 5 \ --admin-username azureuser \ --generate-ssh-keys ``` ### [PowerShell](#tab/powershell) When creating a new scale set using Azure PowerShell, use [New-AzVmss](/powershell/module/az.compute/new-azvmss) and the `-UpgradePolicyMode` parameter to set the upgrade policy mode. If using a rolling upgrade policy mode, see [configure rolling upgrade policy](virtual-machine-scale-sets-configure-rolling-upgrades.md) for configuration settings and suggestions. ```azurepowershell-interactive New-AzResourceGroup -Name "myResourceGroup" -Location "WestUS" ``` ```azurepowershell-interactive New-AzVmss ` -ResourceGroupName "myResourceGroup" ` -Location "EastUS" ` -VMScaleSetName "myScaleSet" ` -OrchestrationMode "Flexible" ` -VirtualNetworkName "myVnet" ` -SubnetName "mySubnet" ` -PublicIpAddressName "myPublicIPAddress" ` -LoadBalancerName "myLoadBalancer" ` -UpgradePolicyMode "Manual" ``` ### [ARM Template](#tab/template) When using an ARM template, add the `upgradePolicy` parameter to the properties section of your template to set the upgrade policy mode. If using a rolling upgrade policy mode, see [configure rolling upgrade policy](virtual-machine-scale-sets-configure-rolling-upgrades.md) for configuration settings and suggestions. ```json "properties": { "upgradePolicy": { "mode": "manual", } } ``` --- ## Next steps Learn how to [change the upgrade policy mode](virtual-machine-scale-sets-change-upgrade-policy.md) of your Virtual Machine Scale Set.