Skip to content

Commit

Permalink
Sync upcoming breaking changes doc from azure-powershell repo.
Browse files Browse the repository at this point in the history
  • Loading branch information
azure-powershell-bot committed Jul 3, 2023
1 parent 6a50011 commit 9dc338e
Showing 1 changed file with 175 additions and 0 deletions.
175 changes: 175 additions & 0 deletions docs-conceptual/azps-10.1.0
Original file line number Diff line number Diff line change
@@ -0,0 +1,175 @@
---
description: Learn about upcoming breaking changes to the Azure Az PowerShell module
ms.custom: devx-track-azurepowershell
ms.date: 07/03/2023
ms.devlang: powershell
ms.service: azure-powershell
ms.topic: conceptual
title: Upcoming breaking changes in Azure PowerShell
---
# Upcoming breaking changes in Azure PowerShell

## Az.Aks

### `New-AzAksCluster`

- Parameter breaking-change will happen to all parameter sets
- `-DockerBridgeCidr`
- DockerBridgeCidr parameter will be deprecated in Az 11.0.0 without being replaced.
- This change is expected to take effect from Az.Aks version: 6.0.0 and Az version: 11.0.0

## Az.Compute

### `New-AzDisk`

- Cmdlet breaking-change will happen to all parameter set
- Starting in November 2023 the "New-AzDisk" cmdlet will deploy with the Trusted Launch configuration by default. This includes defaulting the "HyperVGeneration" parameter to "v2". To know more about Trusted Launch, please visit https://learn.microsoft.com/en-us/azure/virtual-machines/trusted-launch
- This change is expected to take effect from Az.Compute version: 7.0.0 and Az version: 11.0.0

### `New-AzVM`

- Cmdlet breaking-change will happen to all parameter set
- Consider using the image alias including the version of the distribution you want to use in the "-Image" parameter of the "New-AzVM" cmdlet. On April 30, 2023, the image deployed using `UbuntuLTS` will reach its end of life. In October 2023, the aliases `UbuntuLTS`, `CentOS`, `Debian`, and `RHEL` will be removed.
- This change is expected to take effect from Az.Compute version: 7.0.0 and Az version: 11.0.0
- Starting in November 2023 the "New-AzVM" cmdlet will deploy with the Trusted Launch configuration by default. To know more about Trusted Launch, please visit https://docs.microsoft.com/en-us/azure/virtual-machines/trusted-launch
- This change is expected to take effect from Az.Compute version: 7.0.0 and Az version: 11.0.0

### `New-AzVmss`

- Cmdlet breaking-change will happen to all parameter set
- Starting November 2023, the "New-AzVmss" cmdlet will default to Trusted Launch VMSS. For more info, visit https://aka.ms/trustedLaunchVMSS.
- This change is expected to take effect from Az.Compute version: 7.0.0 and Az version: 11.0.0
- Starting November 2023, the "New-AzVmss" cmdlet will use new defaults: Flexible orchestration mode and enable NATv2 configuration for Load Balancer. To learn more about Flexible Orchestration modes, visit https://aka.ms/orchestrationModeVMSS.
- This change is expected to take effect from Az.Compute version: 7.0.0 and Az version: 11.0.0
- Consider using the image alias including the version of the distribution you want to use in the "-ImageName" parameter of the "New-AzVmss" cmdlet. On April 30, 2023, the image deployed using `UbuntuLTS` will reach its end of life. In November 2023, the aliases `UbuntuLTS`, `CentOS`, `Debian`, and `RHEL` will be removed.
- This change is expected to take effect from Az.Compute version: 7.0.0 and Az version: 11.0.0

## Az.DesktopVirtualization

### `New-AzWvdScalingPlan`

- Parameter breaking-change will happen to all parameter sets
- `-HostPoolType`
- The parameter : 'HostPoolType' is changing.
- The change is expected to take effect from the Az.DesktopVirtualization version : '4.0.0'

## Az.PowerBIEmbedded

### `Get-AzPowerBIWorkspace`

- Cmdlet breaking-change will happen to all parameter set
- The cmdlet is being deprecated. There will be no replacement for it.
- This change is expected to take effect from Az.PowerBIEmbedded version: 2.0.0 and Az version: 11.0.0

### `Get-AzPowerBIWorkspaceCollection`

- Cmdlet breaking-change will happen to all parameter set
- The cmdlet is being deprecated. There will be no replacement for it.
- This change is expected to take effect from Az.PowerBIEmbedded version: 2.0.0 and Az version: 11.0.0

### `Get-AzPowerBIWorkspaceCollectionAccessKey`

- Cmdlet breaking-change will happen to all parameter set
- The cmdlet is being deprecated. There will be no replacement for it.
- This change is expected to take effect from Az.PowerBIEmbedded version: 2.0.0 and Az version: 11.0.0

### `New-AzPowerBIWorkspaceCollection`

- Cmdlet breaking-change will happen to all parameter set
- The cmdlet is being deprecated. There will be no replacement for it.
- This change is expected to take effect from Az.PowerBIEmbedded version: 2.0.0 and Az version: 11.0.0

### `Remove-AzPowerBIWorkspaceCollection`

- Cmdlet breaking-change will happen to all parameter set
- The cmdlet is being deprecated. There will be no replacement for it.
- This change is expected to take effect from Az.PowerBIEmbedded version: 2.0.0 and Az version: 11.0.0

### `Reset-AzPowerBIWorkspaceCollectionAccessKey`

- Cmdlet breaking-change will happen to all parameter set
- The cmdlet is being deprecated. There will be no replacement for it.
- This change is expected to take effect from Az.PowerBIEmbedded version: 2.0.0 and Az version: 11.0.0

## Az.RecoveryServices

### `Get-AzRecoveryServicesVaultSettingsFile`

- Parameter breaking-change will happen to all parameter sets
- `-Certificate`
- Parameter is being deprecated without being replaced
- This change is expected to take effect from Az.RecoveryServices version: 7.0.0 and Az version: 11.0.0

## Az.Storage

### `New-AzDataLakeGen2SasToken`

- Cmdlet breaking-change will happen to all parameter set
- The leading question mark '?' of the created SAS token will be removed in a future release.
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0

### `New-AzStorageAccount`

- Cmdlet breaking-change will happen to all parameter set
- Default value of AllowBlobPublicAccess and AllowCrossTenantReplication will be changed from True to False in a future release.
When AllowBlobPublicAccess is False on a storage account, it is not permitted to configure container ACLs to allow anonymous access to blobs within the storage account.
When AllowCrossTenantReplication is False on a storage account, cross AAD tenant object replication is not allowed.
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0

### `New-AzStorageAccountSASToken`

- Cmdlet breaking-change will happen to all parameter set
- The leading question mark '?' of the created SAS token will be removed in a future release.
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0

### `New-AzStorageBlobSASToken`

- Cmdlet breaking-change will happen to all parameter set
- The leading question mark '?' of the created SAS token will be removed in a future release.
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0

### `New-AzStorageContainerSASToken`

- Cmdlet breaking-change will happen to all parameter set
- The leading question mark '?' of the created SAS token will be removed in a future release.
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0

### `New-AzStorageContext`

- Parameter breaking-change will happen to all parameter sets
- `-SasToken`
- The SAS token in created Storage context properties 'ConnectionString' and 'StorageAccount.Credentials' won't have the leading question mark '?' in a future release.
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0

### `New-AzStorageFileSASToken`

- Cmdlet breaking-change will happen to all parameter set
- The leading question mark '?' of the created SAS token will be removed in a future release.
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0

### `New-AzStorageQueueSASToken`

- Cmdlet breaking-change will happen to all parameter set
- The leading question mark '?' of the created SAS token will be removed in a future release.
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0

### `New-AzStorageShareSASToken`

- Cmdlet breaking-change will happen to all parameter set
- The leading question mark '?' of the created SAS token will be removed in a future release.
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0

### `New-AzStorageTableSASToken`

- Cmdlet breaking-change will happen to all parameter set
- The leading question mark '?' of the created SAS token will be removed in a future release.
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0

### `Set-AzStorageAccount`

- Parameter breaking-change will happen to all parameter sets
- `-EnableLargeFileShare`
- EnableLargeFileShare parameter will be deprecated in a future release.
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0


0 comments on commit 9dc338e

Please sign in to comment.