Maintained with ☕️ by
IcePanel logo

Breaking Change Notice: Virtual Machine Scale Set Default Orchestration Mode changing from Uniform to Flexible on PowerShell, Azure CLI

Share

Services

We are announcing an upcoming breaking change to the default orchestration mode for Virtual Machine Scale Sets created on PowerShell and Azure CLI starting November 2023\. Once this change is complete, any new VM scale sets created using these clients will automatically default to Flexible orchestration mode instead of Uniform. If you would like to continue creating Uniform scale sets, please update your scripts to set orchestration mode to Uniform when deploying your VMs. For more information on this breaking change, please see [Breaking Change for VMSS PowerShell/CLI Customers - Microsoft Community Hub](https://techcommunity.microsoft.com/t5/azure-compute-blog/breaking-change-for-vmss-powershell-cli-customers/ba-p/3818295). To learn more about VM Scale Set orchestration modes, please see [Orchestration modes for Virtual Machine Scale Sets in Azure - Azure Virtual Machine S](https://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-orchestration-modes)[cale Sets | Microsoft Learn](https://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-orchestration-modes)[.](https://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-orchestration-modes) ## Impacted Commands * PowerShell: Starting November 2023, the _\-OrchestrationMode_ parameter for [New-AzVmss](https://learn.microsoft.com/en-us/powershell/module/az.compute/new-azvmss?view=azps-9.6.0) will have a new default value of “Flexible”, replacing the current default of “Uniform”. VM Scale Sets created using _New-AzVmss_ after this change will default to “Flexible” orchestration mode if no _–OrchestrationMode_ is specified. * Azure CLI: Starting November 2023, the _–orchestration-mode_ parameter for [az vmss create](https://learn.microsoft.com/en-us/cli/azure/vmss?view=azure-cli-latest#az-vmss-create) will have a new default value of “flexible”, replacing the current default of “uniform”. VM Scale Sets created using _az vmss create_ after this change will default to “flexible” orchestration mode if no _\--orchestration-mode_ is specified. Flexible scale sets will be configured with a Standard Load Balancer and Standard Public IP. ## Recommended Action ### If you are currently using Virtual Machine scale sets in Uniform orchestration mode and would like to continue using Uniform orchestration after November 2023 Please update your PowerShell or CLI deployment scripts to specify Uniform orchestration mode to maintain the existing behaviour of your scale sets. This update is recommended to be done as soon as possible to avoid any unintended behaviour after the change. For examples on how to update, see [Breaking Change for VMSS PowerShell/CLI Customers - Microsoft Community Hub](https://techcommunity.microsoft.com/t5/azure-compute-blog/breaking-change-for-vmss-powershell-cli-customers/ba-p/3818295). ### If you are currently using Virtual Machine scale sets in Uniform orchestration mode and would like to start using Flexible orchestration mode Unfortunately, existing Virtual Machine Scale Sets in Uniform orchestration mode cannot be migrated to Flexible orchestration mode at this time. If you would like to experience the performance benefits and new features coming to Flex, consider updating your deployment scripts to create a Flex-oriented workload. ### If you are already using Virtual Machine scale sets in Flexible orchestration mode No action is required, your scale sets will continue to perform as expected following this change. If you have any questions or concerns about this change, please do not hesitate to reach out to our support team for assistance. * Virtual Machine Scale Sets * Features * [ Virtual Machine Scale Sets](https://azure.microsoft.com/en-gb/products/virtual-machine-scale-sets/)