Upcoming breaking changes in Azure PowerShell

The breaking changes listed in this article are planned for the next major release of the Az PowerShell module unless otherwise noted. Per our Support lifecycle, breaking changes in Azure PowerShell occur twice a year with major versions of the Az PowerShell module.

Preview modules are not included in this list. Read more about module version types.

Az.Compute

New-AzVM

• Cmdlet breaking-change will happen to all parameter sets
  • The default VM size will change from 'Standard_D2s_v3' to 'Standard_D2s_v5'.
  • This change is expected to take effect from Az.Compute version: 11.0.0 and Az version: 15.0.0

New-AzVmss

• Cmdlet breaking-change will happen to all parameter sets
  • In the next breaking change period (Nov 2025), the default VM size will change from 'Standard_Ds1_v2' to 'Standard_D2s_v5'.
  • This change is expected to take effect from Az.Compute version: 11.0.0 and Az version: 15.0.0

Az.ContainerInstance

New-AzContainerGroup

• Parameter breaking-change will happen to all parameter sets
  • -OSType
    • The parameter : 'OSType' is changing.
    • This change will take effect on '5/21/2025'- The change is expected to take effect from Az version : '14.0.0'
    • The change is expected to take effect from version : '5.0.0'

New-AzContainerInstanceContainerGroupProfile

• Parameter breaking-change will happen to all parameter sets
  • -OSType
    • The parameter : 'OSType' is changing.
    • Change description : Removing the default value of OSType parameter.
    • This change will take effect on '5/21/2025'- The change is expected to take effect from Az version : '14.0.0'
    • The change is expected to take effect from version : '5.0.0'

Az.ManagedServices

Get-AzManagedServicesAssignment

• Cmdlet breaking-change will happen to all parameter sets The cmdlet is being deprecated. There will be no replacement for it.
  • Change description : The types of the properties 'Authorization' and 'EligibleAuthorization' will be changed to 'List'.
  • This change will take effect on '11/3/2025'- The change is expected to take effect from Az version : '15.0.0'
  • The change is expected to take effect from version : '9.0.0'

Get-AzManagedServicesDefinition

• Cmdlet breaking-change will happen to all parameter sets The cmdlet is being deprecated. There will be no replacement for it.
  • Change description : The types of the properties 'Authorization' and 'EligibleAuthorization' will be changed to 'List'.
  • This change will take effect on '11/3/2025'- The change is expected to take effect from Az version : '15.0.0'
  • The change is expected to take effect from version : '9.0.0'

New-AzManagedServicesDefinition

• Cmdlet breaking-change will happen to all parameter sets The cmdlet is being deprecated. There will be no replacement for it.
  • Change description : The types of the properties 'DelegatedRoleDefinitionId' and 'JustInTimeAccessPolicyManagedByTenantApprover' will be changed to 'List'.
  • This change will take effect on '11/3/2025'- The change is expected to take effect from Az version : '15.0.0'
  • The change is expected to take effect from version : '9.0.0'

New-AzManagedServicesEligibleAuthorizationObject

• Cmdlet breaking-change will happen to all parameter sets The cmdlet is being deprecated. There will be no replacement for it.
  • Change description : The type of the property 'DelegatedRoleDefinitionId' will be changed from Array to List.
  • This change will take effect on '11/3/2025'- The change is expected to take effect from Az version : '15.0.0'
  • The change is expected to take effect from version : '9.0.0'

Remove-AzManagedServicesDefinition

• Cmdlet breaking-change will happen to all parameter sets The cmdlet is being deprecated. There will be no replacement for it.
  • Change description : The types of the properties 'Authorization' and 'EligibleAuthorization' will be changed to 'List'.
  • This change will take effect on '11/3/2025'- The change is expected to take effect from Az version : '15.0.0'
  • The change is expected to take effect from version : '9.0.0'

Az.RecoveryServices

Get-AzRecoveryServicesBackupSchedulePolicyObject

• Cmdlet breaking-change will happen to all parameter sets
  • May 2025 onwards, this command will return a schedule policy object for Enhanced policy by default for AzureVM workload
  • This change is expected to take effect from Az.RecoveryServices version: 8.0.0 and Az version: 14.0.0

Az.Relay

Get-AzRelayNamespace

• Cmdlet breaking-change will happen to all parameter sets The cmdlet is being deprecated. There will be no replacement for it.
  • Change description : The type of property 'PrivateEndpointConnection' will be changed to 'List'.
  • This change will take effect on '11/3/2025'- The change is expected to take effect from Az version : '15.0.0'
  • The change is expected to take effect from version : '9.0.0'

Get-AzRelayNamespaceNetworkRuleSet

• Cmdlet breaking-change will happen to all parameter sets The cmdlet is being deprecated. There will be no replacement for it.
  • Change description : The type of property 'IPRule' will be changed to 'List'.
  • This change will take effect on '11/3/2025'- The change is expected to take effect from Az version : '15.0.0'
  • The change is expected to take effect from version : '9.0.0'