Upcoming breaking changes in Azure CLI

The breaking changes listed in this section are planned for the next major release of the Azure CLI unless otherwise noted. Per our Support lifecycle, breaking changes in Azure Core CLI reference groups occur twice a year.

acr

acr helm

Link to acr helm reference group

• In November 2020, Helm 2 reached end of life. Starting on March 30th, 2025 Azure Container Registry will no longer support Helm 2. Therefore, the legacy "Helm repositories" functionality will also be retired. We recommend that you transition to Helm 3 immediately.
• Starting January 21st, 2025 the CLI command az acr helm push was retired to prevent pushing new Helm charts to legacy Helm repositories.
• Starting March 30th, 2025 the CLI command group az acr helm was retired, ending all legacy Helm repository capabilities in Azure Container Registry.
• All Helm charts not stored as an OCI artifact was deleted from Azure Container Registry on March 30th, 2025.
• Learn how to find all Helm charts stored in a Helm repository here: az acr helm list. If the Helm chart you are using is listed then it is stored in a legacy Helm repository and is at risk of deletion.
• For more information on managing and deploying applications for Kubernetes, see https://aka.ms/acr/helm.

resource

policy assignment identity assign

Link to policy assignment identity reference group

• Replacing an existing identity will change in a future release of the resource commands. It will require first removing the existing identity.

policy assignment identity remove

Link to policy assignment identity reference group

• Removing a user assigned identity will change in a future release of the resource commands. It will require providing the --mi-user-assigned switch.

policy assignment non-compliance-message create

Link to policy assignment non-compliance-message reference group

• The return value will change in a future release of the resource commands. It will be the single created message object rather than the full array of message objects.
• The return value will change in a future release of the resource commands. It will be the single created message object rather than the full array of message objects.

policy assignment non-compliance-message delete

Link to policy assignment non-compliance-message reference group

• The return value will change in a future release of the resource commands. It will be empty rather than the full array of remaining message objects.

policy definition delete

Link to policy definition reference group

• Behavior will change in a future release of the resource commands. Bypassing the confirmation prompt will require providing the -y switch.

policy set-definition delete

Link to policy set-definition reference group

• Behavior will change in a future release of the resource commands. Bypassing the confirmation prompt will require providing the -y switch.

policy exemption create

Link to policy exemption reference group

• Date format will change slightly in a future release of the resource commands. New format is ISO-8601, e.g. 2025-08-05T00:45:13Z instead of 2025-08-05T00:45:13+00:00.

policy exemption update

Link to policy exemption reference group

• Date format will change slightly in a future release of the resource commands. New format is ISO-8601, e.g. 2025-08-05T00:45:13Z instead of 2025-08-05T00:45:13+00:00.

vm

vm create

Link to vm reference group

• The default value of '--size' will be changed to 'Standard_D2s_v5' from 'Standard_DS1_v2' in a future release.

vmss create

Link to vmss reference group

• The default value of '--vm-sku' will be changed to 'Standard_D2s_v5' from 'Standard_DS1_v2' in a future release.

Note

This article provides information on upcoming breaking changes. For previously published breaking changes, see Azure CLI release notes.