Release Notes

• Added Archive for V1 vaults.
• Fixed Disable SQL AG AutoProtection.

Gallery Module for Azure PowerShell : https://www.powershellgallery.com/packages/Az/6.1.0

To install Az from the PowerShell Gallery, run the following command:

Install-Module -Name Az -Repository PSGallery -Force

To update from an older version of Az, run the following command:

Update-Module -Name Az

Docker images

• mcr.microsoft.com/azure-powershell:latest
• mcr.microsoft.com/azure-powershell:ubuntu-18.04
• mcr.microsoft.com/azure-powershell:6.1.0-ubuntu-18.04
• mcr.microsoft.com/azure-powershell:debian-9
• mcr.microsoft.com/azure-powershell:6.1.0-debian-9
• mcr.microsoft.com/azure-powershell:centos-7
• mcr.microsoft.com/azure-powershell:6.1.0-centos-7
• mcr.microsoft.com/azure-powershell:alpine-3.10
• mcr.microsoft.com/azure-powershell:6.1.0-alpine-3.10

6.1.0 - June 2021

Az.Accounts

• Added cmdlet 'Open-AzSurveyLink'
• Supported certificate file as input parameter of Connect-AzAccount

Az.Aks

• Fixed the issue that 'Set-AzAks' will fail in Automation Runbook. [#15006]

Az.ApplicationInsights

• Fixed issue that 'ResourcegroupName' is missed when executing below cmdlets with 'InputObject' parameter [#14848]
  • 'Get-AzApplicationInsightsLinkedStorageAccount'
  • 'New-AzApplicationInsightsLinkedStorageAccount'
  • 'Update-AzApplicationInsightsLinkedStorageAccount'
  • 'Remove-AzApplicationInsightsLinkedStorageAccount'

Az.Cdn

• Fixed profile missing issue in 'Remove-AzCdnProfile' cmdlet

Az.Compute

• Updated Compute module to use the latest .Net SDK version 47.0.0.

Az.ContainerInstance

• Removed the display of file share credential [#15224]

Az.DataFactory

• Updated ADF .Net SDK version to 4.19.0

Az.EventHub

• Added functionality to accept input from pipeline for 'Get-AzEventHub' from 'Get-AzEventHubNamespace'.

Az.HDInsight

• Support new azure monitor feature in HDInsight:
  • Add cmdlet 'Get-AzHDInsightAzureMonitor' to allow customer to get the Azure Monitor status of HDInsight cluster.
  • Add cmdlet 'Enable-AzHDInsightAzureMonitor' to allow customer to enable the Azure Monitor in HDInsight cluster.
  • Add cmdlet 'Disable-AzHDInsightAzureMonitor' to allow customer to disable the Azure Monitor in HDInsight cluster.

Az.KeyVault

• Removed duplicate list item in 'Get-AzKeyVault' [#15164]
• Added 'SecretManagement' tag to 'Az.KeyVault' module [#15173]

Az.Network

• Updated cmdlets for route server for a more stable way to add IP configuration.
• Added support for getting a single private link resource.
• Added more detailed description about GroupId in 'New-AzPrivateLinkServiceConnection'
• Updated cmdlets to enable setting of PrivateRange on AzureFirewallPolicy.
  • 'New-AzFirewallPolicy'
  • 'Set-AzFirewallPolicy'
• Updated cmdlets to add NatRules in VirtualNetworkGateway and BgpRouteTranslationForNat.
  • 'New-AzVirtualNetworkGateway'
  • 'Set-AzVirtualNetworkGateway'
• Updated cmdlets to add EngressNatRules and EgressNatRules in VirtualNetworkGateway Connection.
  • 'New-AzVirtualNetworkGatewayConnection'
  • 'Set-AzVirtualNetworkGatewayConnection'
• Updated cmdlet to enable setting of FlowTimeout in VirtualNetwork.
  • 'New-AzVirtualNetwork'
• Added cmdlets for Get/Create/Update/Delete VirtualNetworkGatewayNatRules.
  • 'New-AzVirtualNetworkGatewayNatRule'
  • 'Update-AzVirtualNetworkGatewayNatRule'
  • 'Get-AzVirtualNetworkGatewayNatRule'
  • 'Remove-AzVirtualNetworkGatewayNatRule'
• Added a new cmdlet for Sync on VirtualNetworkPeering
  • 'Sync-AzVirtualNetworkPeering'
• Updated cmdlets to add new properties and redefined an existing property in the VirtualNetworkPeering
  • 'Add-AzVirtualNetworkPeering'
  • 'Get-AzVirtualNetworkPeering'
• Updated cmdlets to enable setting of PreferredRoutingGateway on VirtualHub.
  • 'New-AzVirtualHub'
  • 'Update-AzVirtualHub'
• Updated cmdlets to expose two read-only properties of client certificate.
  • 'Get-AzApplicationGatewayTrustedClientCertificate'

Az.RecoveryServices

• Added cross tenant DS Move.
• Removed restriction to fetch recovery points only for a 30 days time range.
• Enabled CRR for new regions.

Az.Resources

• Allowed naming the deployment when testing deployments [#11497]

Az.SignalR

• Changed to 'Allow' and 'Deny' parameters of 'Update-AzSignalRNetworkAcl' cmdlet:
  • Accepted 'Trace' as a valid value.
  • Accepted '@()' as empty collection to clear the list.
• Supported 'ResourceGroupCompleter' and 'ResourceNameCompleter' in the applicable cmdlets.
• Deprecated the 'HostNamePrefix' property of output type 'PSSignalRResource' of following cmdlets:
  • 'Get-AzSignalR'
  • 'New-AzSignalR'
  • 'Update-AzSignalR'

Az.Sql

• Added option to support short version of maintenance configuration id for Managed Instance in 'New-AzSqlInstance' and 'Set-AzSqlInstance' cmdlets
• Added HighAvailabilityReplicaCount to 'New-AzSqlDatabaseSecondary'
• Added External Administrator and AAD Only Properties to AzSqlServer and AzSqlInstance
  • Added option to specify '-ExternalAdminName', '-ExternalAdminSid', '-EnableActiveDirectoryOnlyAuthentication' in 'New-AzSqlInstance' and 'Set-AzSqlInstance' cmdlets
  • Added option to expand external administrators information using '-ExpandActiveDirectoryAdministrator' in 'Get-AzSqlServer' and 'Get-AzSqlInstance' cmdlets
• Fixed 'Set-AzSqlDatabase' to no longer default ReadScale to Disabled when not specified
• Fixed 'Set-AzSqlServer' and 'Set-AzSqlInstance' for partial PUT with only identity and null properties
• Added parameters related to UMI in 'New-AzSqlServer', 'New-AzSqlInstance', 'Set-AzSqlServer' and 'Set-AzSqlInstance' cmdlets.
• Added -AutoRotationEnabled parameter to following cmdlets:
  • 'Set-AzSqlServerTransparentDataEncryptionProtector'
  • 'Get-AzSqlServerTransparentDataEncryptionProtector'
  • 'Set-AzSqlInstanceTransparentDataEncryptionProtector'
  • 'Get-AzSqlInstanceTransparentDataEncryptionProtector'

Az.Storage

• Supported create file share with NFS/SMB enabledEnabledProtocol and RootSquash, and update share with RootSquash
  • 'New-AzRmStorageShare'
  • 'Update-AzRmStorageShare'
• Supported enable Smb Multichannel on File service
  • 'Update-AzStorageFileServiceProperty'
• Fixed copy inside same account issue by access source with anonymous credential, when copy Blob inside same account with Oauth credential
• Removed StorageFileDataSmbShareOwner from value set of parameter DefaultSharePermission in create/update storage account
  • 'New-AzStorageAccount'
  • 'Set-AzStorageAccount'

Az.Websites

• Fixed issue that prevented removing rules by name and unique identifier in 'Remove-AzWebAppAccessRestrictionRule'
• Fixed issue that defaults AlwaysOn to false in 'Set-AzWebAppSlot'

Thanks to our community contributors

• Andy Roberts (@andyr8939), Removing unused TimeGrain variable from example (#15062)
• Ashley Roll (@AshleyRoll), Remove Write-Host leaking file share credentials (#15225)
• Kailash Mandal (@KaishM), Update New-AzPublicIpAddress.md (#15040)
• Olivier Miossec (@omiossec), Update Get-AzExpressRouteCircuitRouteTable.md (#15054)
• Scott (@S-T-S), Update Set-AzNetworkInterface.md (#15112)
• @sohaibMSFT, Application Gateway AutoScale Example (#15071)
• @Srihsu, Update Split-AzReservation.md (#15049)
• @srozemuller, typo in examples resourcegroup parameter (#15146)

Version 0.1.1

• Hotfix for the issue on windows powershell

https://www.powershellgallery.com/packages/Az.DiskPool/0.1.1

• AzureRM Compatible AzureStack operator module. Bug fix for taking >= dependency on AzureRM.Profile module version 5.8.4

Supported soft delete DataLake Gen2 item

- Get-AzDataLakeGen2DeletedItem
- Restore-AzDataLakeGen2DeletedItem

https://www.powershellgallery.com/packages/Az.Storage/3.7.1-preview

https://www.powershellgallery.com/packages/Az.Resources/4.1.1

Version 4.1.1

• Fixed issue that property IdentifierUri is cleaned by Update-AzAdApplication [#15134]

Gallery Module for Azure PowerShell : https://www.powershellgallery.com/packages/Az/6.0.0

To install Az from the PowerShell Gallery, run the following command:

Install-Module -Name Az -Repository PSGallery -Force

To update from an older version of Az, run the following command:

Update-Module -Name Az

Docker images

• mcr.microsoft.com/azure-powershell:latest
• mcr.microsoft.com/azure-powershell:ubuntu-18.04
• mcr.microsoft.com/azure-powershell:6.0.0-ubuntu-18.04
• mcr.microsoft.com/azure-powershell:debian-9
• mcr.microsoft.com/azure-powershell:6.0.0-debian-9
• mcr.microsoft.com/azure-powershell:centos-7
• mcr.microsoft.com/azure-powershell:6.0.0-centos-7
• mcr.microsoft.com/azure-powershell:alpine-3.10
• mcr.microsoft.com/azure-powershell:6.0.0-alpine-3.10

6.0.0 - May 2021

Az 6.0.0 (Az.Accounts 2.3.0) is only supported on Windows PowerShell 5.1, PowerShell 7.0 version 7.0.6 or greater and PowerShell 7.1 version 7.1.3 or greater, open https://aka.ms/install-powershell to learn how to upgrade. For further information, go to http://aka.ms/azpslifecyle.

Az.Accounts

• Upgraded Azure.Identity to 1.4 and MSAL to 4.30.1
• Removed obsolete parameters 'ManagedServiceHostName', 'ManagedServicePort' and 'ManagedServiceSecret' of cmdlet 'Connect-AzAccount', environment variables 'MSI_ENDPOINT' and 'MSI_SECRET' could be used instead
• Customize display format of PSAzureRmAccount to hide secret of service principal [#14208]
• Added optional parameter 'AuthScope' to 'Connect-AzAccount' to support enhanced authentication of data plane features
• Set retry times by environment variable [#14748]
• Supported subject name issuer authentication

Az.Compute

• Added 'Invoke-AzVmInstallPatch' to support patch installation in VMs using PowerShell.
• Updated Compute module to use the latest .Net SDK version 46.0.0.
• Added optional parameter '-EdgeZone' to the following cmdlets:
  • 'Get-AzVMImage
  • 'Get-AzVMImageOffer'
  • 'Get-AzVMImageSku'
  • 'New-AzDiskConfig'
  • 'New-AzImageConfig'
  • 'New-AzSnapshotConfig'
  • 'New-AzVM'
  • 'New-AzVmssConfig'
  • 'New-AzVMSS'

Az.ContainerInstance

• Added new cmdlets: 'Start-AzContainerGroup', 'Stop-AzContainerGroup' [#10773], 'Invoke-AzContainerInstanceCommand' [#7648], 'Update-AzContainerGroup', 'Add-AzContainerInstanceOutput', 'Get-AzContainerInstanceCachedImage', 'Get-AzContainerInstanceCapability', 'Get-AzContainerInstanceUsage', 'New-AzContainerGroupImageRegistryCredentialObject', 'New-AzContainerGroupPortObject', 'New-AzContainerGroupVolumeObject', 'New-AzContainerInstanceEnvironmentVariableObject', 'New-AzContainerInstanceInitDefinitionObject', 'New-AzContainerInstanceObject', 'New-AzContainerInstancePortObject' and 'New-AzContainerInstanceVolumeMountObject'
• Supported Log Analytics parameters in 'New-AzContainerGroup' [#11117]
• Added support to specify network profile and the name of Azure File Share in 'New-AzContainerGroup' [#9993] [#12218]
• Added support to specify environment variables as SecureValue [#10110] [#10640]

Az.ContainerRegistry

• Fixed username and password issue in 'Import-AzContainerRegistryImage' [#14971]
• Fixed data plane operations (repository, tag, manifest) failed cross registry in single Powershell session [#14849]

Az.CosmosDB

• Introduced support for Sql data plane RBAC, allowing the creation, updating, removal, and retrieval of Role Definitions and Role Assignments
  • The following cmdlets are added:
    • Get-AzCosmosDBSqlRoleDefinition, Get-AzCosmosDBSqlRoleAssignment,
    • New-AzCosmosDBSqlRoleDefinition, New-AzCosmosDBSqlRoleAssignment,
    • Remove-AzCosmosDBSqlRoleDefinition, Remove-AzCosmosDBSqlRoleAssignment,
    • Update-AzCosmosDBSqlRoleDefinition, Update-AzCosmosDBSqlRoleAssignment,
    • New-AzCosmosDBSqlPermission

Az.DesktopVirtualization

• Upgraded api version to 2021-02-01-preview.

Az.Functions

• Added support in function app creation for Python 3.9 and Node 14 function apps
• Removed support in function app creation for V2, Python 3.6, Node 8, and Node 10 function apps
• Updated IdentityID parameter from string to string array in Update-AzFunctionApp. This is to be consistent with New-AzFunctionApp which has the same parameter as a string array
• Updated FullyQualifiedErrorId for an invalid Functions version from FunctionsVersionIsInvalid to FunctionsVersionNotSupported
• When creating a Node.js function app, if no runtime version is specified, the default runtime version is set to 14 instead of 12

Az.KeyVault

• Provided key size for RSA key [#14819]

Az.Kusto

• Bumped API version to stable 2021-01-01

Az.Maintenance

• Bumped API version to stable 2021-05-01

Az.Migrate

• Fixed an issue in Initialize-AzMigrateReplicationInfrastructure.ps1

Az.Network

• Updated validation to allow passing zero value for saDataSizeKilobytes parameter
  • 'New-AzureRmIpsecPolicy'
• Added optional parameter '-EdgeZone' to the following cmdlets:
  • 'New-AzNetworkInterface'
  • 'New-AzPublicIpAddress'
  • 'New-AzVirtualNetwork'

Az.RecoveryServices

• Fixed security issue with SQL restore, this is a necessary breaking change. TargetContainer becomes mandatory for Alternate Location Restore.
• Removed Set-AzRecoveryServicesBackupProperties cmdlet alias, Set-AzRecoveryServicesBackupProperty is supported.
• Removed Get-AzRecoveryServicesBackupJobDetails cmdlet alias, Get-AzRecoveryServicesBackupJobDetail is supported.
• Added support for cross subscription DS Move.
• Azure Site Recovery support for VMware to Azure disaster recovery scenarios using RCM as the control plane.

Az.Resources

• Changed '-IdentifierUris' in 'New-AzADApplication' to optional parameter
• Removed generated 'DisplayName' of ADApplication created by 'New-AzADServicePrincipal'
• Updated SDK to 3.13.1-preview to use GA TemplateSpecs API version
• Added 'AdditionalProperties' to PSADUser and PSADGroup [#14568]
• Supported 'CustomKeyIdentifier' in 'New-AzADAppCredential' and 'Get-AzADAppCredential' [#11457], [#13723]
• Changed 'MainTemplate' to be shown by the default formatter for Template Spec Versions

Az.SecurityInsights

• GA release for Az.SecurityInsights

Az.ServiceFabric

• Removed deprecated cluster certificate commands:
  • 'Add-AzServiceFabricClusterCertificate'
  • 'Remove-AzServiceFabricClusterCertificate'
• Changed PSManagedService model to avoid using the properties parameter directly from sdk.
• Removed deprecated parameters for managed cmdlets:
  • 'ReverseProxyEndpointPort'
  • 'InstanceCloseDelayDuration'
  • 'ServiceDnsName'
  • 'InstanceCloseDelayDuration'
  • 'DropSourceReplicaOnMove'
• Fixed 'Update-AzServiceFabricReliability' to update correctly the vm instance count of the primary node type on the cluster resource.

Az.Sql

• Updated 'Set-AzSqlDatabaseVulnerabilityAssessmentRuleBaseline' documentation to include example of define array of array with one inner array.
• Added cmdlet 'Copy-AzSqlDatabaseLongTermRetentionBackup'
  • Copy LTR backups to different servers
• Added cmdlet 'Update-AzSqlDatabaseLongTermRetentionBackup'
  • Update Backup Storage Redundancy values for LTR backups
• Added CurrentBackupStorageRedundancy, RequestedBackupStorageRedundancy to 'Get-AzSqlDatabase', 'New-AzSqlDatabase', 'Set-AzSqlDatabase', 'New-AzSqlDatabaseSecondary', 'Set-AzSqlDatabaseSecondary', 'New-AzSqlDatabaseCopy'
  • Changed BackupStorageRedundancy value to CurrentBackupStorageRedundancy, RequestedBackupStorageRedundancy to reflect both the current value and what has been requested if a change was made

Az.Storage

• Supported file share snapshot
  • 'New-AzRmStorageShare'
  • 'Get-AzRmStorageShare'
  • 'Remove-AzRmStorageShare'
• Supported remove file share with it's snapshot (leased and not leased), by default remove file share will fail when share has snapshot
  • 'Remove-AzRmStorageShare'
• Supported Set/Get/Remove blob inventory policy
  • 'New-AzStorageBlobInventoryPolicyRule'
  • 'Set-AzStorageBlobInventoryPolicy'
  • 'Get-AzStorageBlobInventoryPolicy'
  • 'Remove-AzStorageBlobInventoryPolicy'
• Supported DefaultSharePermission in create/update storage account
  • 'New-AzStorageAccount'
  • 'Set-AzStorageAccount'
• Supported AllowCrossTenantReplication in create/update storage account
  • 'New-AzStorageAccount'
  • 'Set-AzStorageAccount'
• Supported Set Object Replication Policy with SourceAccount/DestinationAccount as Storage account resource Id
  • 'Set-AzStorageObjectReplicationPolicy'
• Supported set SasExpirationPeriod as TimeSpan.Zero
  • 'New-AzStorageAccount'
  • 'Set-AzStorageAccount
• Make sure the correct account name is used when create account credential
  • 'New-AzStorageContext'

Az.StorageSync

• Deprecated 'Invoke-AzStorageSyncFileRecall'
  • Customers should instead use 'Invoke-StorageSyncFileRecall', a cmdlet that is shipped with the Azure File Sync agent.
• Removed offline data transfer feature in 'New-AzStorageSyncServerEndpoint'.

Az.StreamAnalytics

• Bumped API version to 2017-04-01-preview
• Added StreamAnalytics Cluster support

Az.Websites

• updated 'Set-AzAppServicePlan' to keep existing Tags when adding new Tags
• Fixed 'Set-AzWebApp' to set the AppSettings
• updated 'Set-AzWebAppSlot' to set FtpsState
• Added support for StaticSites.

Thanks to our community contributors

• @corichte, Update New-AzVirutalNetworkGatewayConnection Ex 1 (#14858)
• Hiroshi Yoshioka (@hyoshioka0128)
  • Typo "Azure SQL database"→"Azure SQL Database" (#14883)
  • Typo "Azure SQL managed instance"→"Azure SQL Managed Instance" (#14891)
  • Typo "Azure SQL managed instance"→"Azure SQL Managed Instance" (#14892)
  • Typo "Azure SQL managed instance"→"Azure SQL Managed Instance" (#14902)
  • Typo "Azure SQL managed instance"→"Azure SQL Managed Instance" (#14901)
  • Typo "Azure SQL managed instance"→"Azure SQL Managed Instance" (#14900)
  • Typo "Azure SQL managed instance"→"Azure SQL Managed Instance" (#14898)
  • Typo "Azure SQL managed instance"→"Azure SQL Managed Instance" (#14899)
• Jay Zelos (@jzelos), Updated example 3 to use correct parameter (#14852)
• @StevePantol, Update New-AzVMwarePrivateCloud.md (#14996)

Gallery Module for Azure PowerShell : https://www.powershellgallery.com/packages/Az/5.9.0

To install Az from the PowerShell Gallery, run the following command:

Install-Module -Name Az -Repository PSGallery -Force

To update from an older version of Az, run the following command:

Update-Module -Name Az

Docker images

• mcr.microsoft.com/azure-powershell:latest
• mcr.microsoft.com/azure-powershell:ubuntu-18.04
• mcr.microsoft.com/azure-powershell:5.9.0-ubuntu-18.04
• mcr.microsoft.com/azure-powershell:debian-9
• mcr.microsoft.com/azure-powershell:5.9.0-debian-9
• mcr.microsoft.com/azure-powershell:centos-7
• mcr.microsoft.com/azure-powershell:5.9.0-centos-7
• mcr.microsoft.com/azure-powershell:alpine-3.10
• mcr.microsoft.com/azure-powershell:5.9.0-alpine-3.10

5.9.0 - May 2021

Az.Aks

• Added support 'AcrNameToAttach' in 'Set-AzAksCluster'. [#14692]
• Added support 'AcrNameToDetach' in 'Set-AzAksCluster'. [#14693]
• Added 'Set-AzAksClusterCredential' to reset the ServicePrincipal of an existing AKS cluster.

Az.Automation

• Added support for User Assigned Identities and PublicNetworkAccess flag

Az.Cdn

• Added cmdlets to support new AFD Premium / Standard SKUs

Az.Compute

• Updated the 'Set-AzVMDiskEncryptionExtension' cmdlet to support ADE extension migration from two pass (version with AAD input parameters) to single pass (version without AAD input parameters).
  • Added a switch parameter '-Migrate' to trigger migration workflow.
  • Added a switch parameter '-MigrationRecovery' to trigger recovery workflow for VMs experiencing failures after migration from two pass ADE.

Az.DataFactory

• Added User Assigned Identities to Data Factory.
• Updated ADF .Net SDK version to 4.18.0

Az.FrontDoor

• Allowed Enable-AzFrontDoorCustomDomainHttps's SecretVersion parameter to be optional to support bring-your-own-certificate auto-rotation

Az.KeyVault

• Fixed a bug for 'Get-AzKeyVaultSecret -IncludeVersions' when current version is disabled [#14740]
• Displayed error code and message when updating purged secret [#14800]

Az.RecoveryServices

• Azure Site Recovery support for Multiple IP per NIC for Azure to Azure provider.
• Azure Site Recovery support for SqlServerLicenseType for VMware to Azure and HyperV to Azure providers.
• Azure Site Recovery support for Availability set for VMware to Azure and HyperV to Azure providers.
• Azure Site Recovery support for TargetVmSize for VMware to Azure and HyperV to Azure providers.
• Azure Site Recovery support for ResourceTagging for VMware to Azure and HyperV to Azure providers.
• Azure Site Recovery support for Virtual Machine Scale Set for Azure to Azure provider.
• Added support for restoring unmanaged disks vm as managed disks.

Az.Resources

• Added parameter 'ObjectType' for 'New-AzRoleAssignment'

Az.ServiceFabric

• Upgraded Managed Cluster commands to use Service Fabric Managed Cluster SDK version 1.0.0 which uses service fabric resource provider api-version 2021-05-01.
• 'New-AzServiceFabricManagedCluster' add parameters UpgradeCadence and ZonalResiliency.
• 'New-AzServiceFabricManagedNodeType' add parameters DiskType, VmUserAssignedIdentity, IsStateless and MultiplePlacementGroup.
• 'New-AzServiceFabricManagedClusterService' and 'Set-AzServiceFabricManagedClusterService' mark parameters for deprecation: InstanceCloseDelayDuration, DropSourceReplicaOnMove and ServiceDnsName. They are not supported.

Az.ResourceMover

• General availability of 'Az.ResourceMover' module

Az.Storage

• Supported create/update storage account with KeyExpirationPeriod and SasExpirationPeriod
  • 'New-AzStorageAccount'
  • 'Set-AzStorageAccount'
• Supported create/update storage account with keyvault encryption and access keyvault with user assigned identity
  • 'New-AzStorageAccount'
  • 'Set-AzStorageAccount'
• Supported EdgeZone in create storage account
  • 'New-AzStorageAccount'
• Fixed an issue that delete immutable blob will prompt incorrect message.
  • 'Remove-AzStorageAccount'
• Allowed update Storage Account KeyVault properties by cleanup Keyversion to enable key auto rotation [#14769]
  • 'Set-AzStorageAccount'
• Added breaking change warning message for upcoming cmdlet breaking change
  • 'Remove-AzRmStorageShare'

Thanks to our community contributors

• Thomas Lee (@doctordns), Update Get-AzEnvironment.md (#14704)
• Fabian (@FullByte), Example with wrong parameter (typo) (#14743)
• @gradinDotCom, Update Get-AzNetworkWatcherNextHop.md (#14813)
• Dr Greg Low (@greglow-sdu), Update Get-AzSqlServerDnsAlias.md (#14737)
• Prateek Singh (@PrateekKumarSingh)
  • fixing a typo (#14779)
  • fixing typo (#14773)
• Remco Eissing (@remcoeissing)
  • Fixed typos in Restore-AzApiManagement (#14770)
  • Example 2 to use New-AzPolicyExemption (#14716)
• @sharma224
  • User identity changes (#14803)
  • Supporting Customer managed key (#14680)
• Yannick Dils (@yannickdils), Update Location explanation (#14719)

Release Notes

• Add Open-AzPredictorSurvey to welcome feedback.

https://www.powershellgallery.com/packages/Az.Tools.Predictor/0.3.0

Gallery Module for Azure PowerShell : https://www.powershellgallery.com/packages/Az/5.8.0

To install Az from the PowerShell Gallery, run the following command:

Install-Module -Name Az -Repository PSGallery -Force

To update from an older version of Az, run the following command:

Update-Module -Name Az

Docker images

• mcr.microsoft.com/azure-powershell:latest
• mcr.microsoft.com/azure-powershell:ubuntu-18.04
• mcr.microsoft.com/azure-powershell:5.8.0-ubuntu-18.04
• mcr.microsoft.com/azure-powershell:debian-9
• mcr.microsoft.com/azure-powershell:5.8.0-debian-9
• mcr.microsoft.com/azure-powershell:centos-7
• mcr.microsoft.com/azure-powershell:5.8.0-centos-7
• mcr.microsoft.com/azure-powershell:alpine-3.10
• mcr.microsoft.com/azure-powershell:5.8.0-alpine-3.10

5.8.0 - April 2021

Az.Accounts

• Fallback to first valid context if current default context key is 'Default' which is invalid

Az.Automation

• Added support for Customer Managed Key Encryption with System Assigned Identity
• Fixed issue that disables the schedule for update deployment if schedule was re-created with same name

Az.Compute

• Fixed a bug when 1 data disk attached to VMSS for Remove-AzVmssDataDisk [#13368]
• Added new cmdlets to support TrustedLaunch related cmdlets:
  • 'Set-AzVmSecurityProfile'
  • 'Set-AzVmUefi'
  • 'Set-AzVmssSecurityProfile'
  • 'Set-AzVmssUefi'
• Edited default value for Size parameter in New-AzVM cmdlet from Standard_DS1_v2 to Standard_D2s_v3.

Az.ContainerRegistry

• Fixed bug in 'Get-AzContainerRegistryManifest' showing incorrect image name

Az.HDInsight

• Supported getting default vmsize from backend if customer does not provide the related parameters: '-WorkerNodeSize', '-HeadNodeSize', '-ZookeeperNodeSize', '-EdgeNodeSize', '-KafkaManagementNodeSize'.

Az.HealthcareApis

• Added support for Acr LoginServers

Az.KeyVault

• Fixed a bug for 'Get-AzKeyVaultSecret -AsPlainText' if the secret is not found [#14645]

Az.Migrate

• Nullref Bug fixed in get discovered server and initialize replication infrastructure commandlets.

Az.Monitor

• Added cmdlet to get diagnostic setting categories for subscription
  • 'Get-AzSubscriptionDiagnosticSettingCategory'
• Supported subscription diagnostic setting operations with new parameter: SubscriptionId
  • 'Get-AzDiagnosticSetting'
  • 'New-AzDiagnosticSetting'
  • 'Remove-AzDiagnosticSetting'
• Supported 'AutoMitigate' parameter in metric alert rule properties. The flag indicates whether the alert should be auto resolved or not.

Az.Resources

• Added upcoming breaking change warnings on below cmdlets, because the value of 'IdentifierUris' parameter will need verified domain.
  • 'New-AzADApplication'
  • 'Update-AzADApplication'
  • 'New-AzADServicePrincipal'
  • 'Update-AzADServicePrincipal'
• Ignored Bicep warning message in error stream if exitcode equals zero.

Az.Sql

• Added cmdlet output breaking change warnings to the following:
  • 'New-AzSqlDatabase'
  • 'Get-AzSqlDatabase'
  • 'Set-AzSqlDatabase'
  • 'Remove-AzSqlDatabase'
  • 'New-AzSqlDatabaseSecondary'
  • 'Remove-AzSqlDatabaseSecondary'
  • 'Get-AzSqlDatabaseReplicationLink'
  • 'New-AzSqlDatabaseCopy'
  • 'Set-AzSqlDatabaseSecondary'

Az.Storage

• Fixed copy blob fail with source context as Oauth [#14662]
  • 'Start-AzStorageBlobCopy'

Az.StreamAnalytics

• Added upcoming breaking change warning message to all cmdlets because of upcoming changes on parameters.

Thanks to our community contributors

• Andrei Zhukouski (@BurgerZ), Fix typo (#14575)
• Mark Allison (@markallisongit), Update Invoke-AzSqlInstanceFailover.md (#14603)

Release Notes

• Bumped API version to stable 2021-03-01
• Supported OSFamily and OSVersion

Release Notes

• Added cmdlet Copy-AzSqlDatabaseLongTermRetentionBackup
  • Copy LTR backups to different servers
• Added cmdlet Update-AzSqlDatabaseLongTermRetentionBackup
  • Update Backup Storage Redundancy values for LTR backups
• Added CurrentBackupStorageRedundancy, RequestedBackupStorageRedundancy to Get-AzSqlDatabase, New-AzSqlDatabase, Set-AzSqlDatabase, New-AzSqlDatabaseSecondary, Set-AzSqlDatabaseSecondary, New-AzSqlDatabaseCopy
  • Changed BackupStorageRedundancy value to CurrentBackupStorageRedundancy, RequestedBackupStorageRedundancy to reflect both the current value and what has been requested if a change was made

Release Notes

• Nullref Bug fixed in get discovered server and initialize replication infrastructure cmdlets.

Install

Gallery Module for ARM Cmdlets: link

To install AzureRM from the PowerShell Gallery, run the following command:

Install-Module -Name AzureRM -Repository PSGallery -Force

To update from an older version of AzureRM, run the following command:

Update-Module -Name AzureRM

Changes since last release

6.13.2 - March 2021

Azure Resource Manager Module

This module is outdated and will go out of support on 29 February 2024.

The Az PowerShell Module provides the following improvements:

• Greater security with token cache encryption and improved authentication.
• Availability in Azure Cloud Shell and on Linux and macOS.
• Support for all Azure services.
• Allows use of Azure access tokens.

We encourage you to start using the Az module as soon as possible to take advantage of these improvements.

Update your scripts that use AzureRM PowerShell modules to use Az PowerShell modules by 29 February 2024. To automatically update your scripts, follow the quickstart guide.

Gallery Module for Azure PowerShell : https://www.powershellgallery.com/packages/Az/5.7.0

To install Az from the PowerShell Gallery, run the following command:

Install-Module -Name Az -Repository PSGallery -Force

To update from an older version of Az, run the following command:

Update-Module -Name Az

Docker images

• mcr.microsoft.com/azure-powershell:latest
• mcr.microsoft.com/azure-powershell:ubuntu-18.04
• mcr.microsoft.com/azure-powershell:5.7.0-ubuntu-18.04
• mcr.microsoft.com/azure-powershell:debian-9
• mcr.microsoft.com/azure-powershell:5.7.0-debian-9
• mcr.microsoft.com/azure-powershell:centos-7
• mcr.microsoft.com/azure-powershell:5.7.0-centos-7
• mcr.microsoft.com/azure-powershell:alpine-3.10
• mcr.microsoft.com/azure-powershell:5.7.0-alpine-3.10

5.7.0 - March 2021

Az.Accounts

• Fixed incorrect warning message on Windows PowerShell [#14556]
• Set Azure Environment variable 'AzureKeyVaultServiceEndpointResourceId' according to the value of 'AzureKeyVaultDnsSuffix' when discovering environment

Az.Automation

• Fixed the issue for starting Python3 runbooks with parameters

Az.DataFactory

• Updated ADF .Net SDK version to 4.15.0

Az.EventHub

• Fixed that 'New-AzServiceBusAuthorizationRuleSASToken' returns invalid token. [#12975]

Az.IotHub

• Updated IoT Hub Management SDK and models to version 3.0.0 (api-version 2020-03-01)

Az.KeyVault

• Supported upcoming new API design for 'Export-AzKeyVaultSecurityDomain'
• Fixed several typos in cmdlet messages [#14341]

Az.Network

• Added new cmdlets to replace old product name 'virtual router' with new name 'route server' in the future.
  • 'Get-AzRouteServerPeerAdvertisedRoute'
  • 'Get-AzRouteServerPeerAdvertisedRoute'
  • Added deprecation attribute warning to the old cmdlets.
• Updated 'set-azExpressRouteGateway' to allow parameter -MinScaleUnits without specifying -MaxScaleUnits
• Updated cmdlets to enable setting of VpnLinkConnectionMode on VpnSiteLinkConnections.
  • 'New-AzVpnSiteLinkConnection'
  • 'Update-AzVpnConnection'
• Added new cmdlet to fetch IKE Security Associations for VPN Site Link Connections.
  • 'Get-VpnSiteLinkConnectionIkeSa'
• Added new cmdlet to reset a Virtual Network Gateway Connection.
  • 'Reset-AzVirtualNetworkGatewayConnection'
• Added new cmdlet to reset a Vpn Site Link Connection.
  • 'Reset-VpnSiteLinkConnection'
• Updated cmdlets to enable setting an optional parameter -TrafficSelectorPolicies
  • 'New-AzVpnConnection'
  • 'Update-AzVpnConnection'
• Bug fix for update vpnServerConfiguration.
• Add scenarioTest for p2s multi auth VWAN.
• Added multi auth feature support for VNG
  • 'Get-AzVpnClientConfiguration'
  • 'New-AzVirtualNetworkGateway'
  • 'Set-AzVirtualNetworkGateway'

Az.RecoveryServices

• Added Cross Zonal Restore for managed virtual machines.

Az.RedisEnterpriseCache

• GA version of Az.RedisEnterpriseCache

Az.Resources

• Redirected bicep message to verbose stream
• Removed the logic of copying Bicep template file to temp folder.
• Add support of policy exemption resource type
• Fixed what-if functionality when using '-QueryString' parameter.
• Normalized '-QueryString' starting with '?' for scenarios involving dynamic parameters.

Az.ServiceBus

• Fixed that 'New-AzServiceBusAuthorizationRuleSASToken' returns invalid token. [#12975]

Az.ServiceFabric

• Added parameters 'VMImagePublisher', 'VMImageOffer', 'VMImageSku', 'VMImageVersion' to 'Add-AzServiceFabricNodeType' to facilitate easy alternate OS image creation for new node type.
• Added parameter 'IsPrimaryNodeType' to 'Add-AzServiceFabricNodeType' to be able to create an additional primary node type, for the purpose of transitioning the primary node type to another one in the case of OS migration.
• 'Add-AzServiceFabricNodeType' now correctly copies the LinuxDiagnostic extension. This was previously not working for Linux.
• 'Add-AzServiceFabricNodeType' now correctly copies the RDP/SSH load balancer inbound NAT port mapping to the new node type.
• Added template for 'UbuntuServer1804' for creating Ubuntu 18.04 clusters using 'New-AzServiceFabricCluster'.
• 'Remove-AzServiceFabricNodeType' was incorrectly blocking Bronze durability node types for removal, and this has been updated to only block when the Bronze durability level differs between the SF node type and VMSS setting.
• Added cmdlet 'Update-AzServiceFabricVmImage' to update the delivered SF runtime package type. This must be changed when migrating from Ubuntu 16 to 18.
• Added cmdlet 'Update-AzServiceFabricNodeType' to update the properties of a cluster node type. For now this is solely used to update whether the node type is primary via bool parameter '-IsPrimaryNodeType False'.
• 'Update-AzServiceFabricReliability' is now able to update reliability level when the cluster has more than one primary node type. To do this, the name of the node type is supplied via the new -NodeType parameter.
• Added new cmdlets for managed applications:
  • 'New-AzServiceFabricManagedClusterApplication'
  • 'Get-AzServiceFabricManagedClusterApplication'
  • 'Set-AzServiceFabricManagedClusterApplication'
  • 'Remove-AzServiceFabricManagedClusterApplication'
  • 'New-AzServiceFabricManagedClusterApplicationType'
  • 'Get-AzServiceFabricManagedClusterApplicationType'
  • 'Set-AzServiceFabricManagedClusterApplicationType'
  • 'Remove-AzServiceFabricManagedClusterApplicationType'
  • 'New-AzServiceFabricManagedClusterApplicationTypeVersion'
  • 'Get-AzServiceFabricManagedClusterApplicationTypeVersion'
  • 'Set-AzServiceFabricManagedClusterApplicationTypeVersion'
  • 'Remove-AzServiceFabricManagedClusterApplicationTypeVersion'
  • 'New-AzServiceFabricManagedClusterService'
  • 'Get-AzServiceFabricManagedClusterService'
  • 'Set-AzServiceFabricManagedClusterService'
  • 'Remove-AzServiceFabricManagedClusterService'
• Upgraded Managed Cluster commands to use Service Fabric Managed Cluster SDK version 1.0.0-beta.1 which uses service fabric resource provider api-version 2021-01-01-preview.

Az.Sql

• Added cmdlet 'New-AzSqlServerTrustGroup'
• Added cmdlet 'Remove-AzSqlServerTrustGroup'
• Added cmdlet 'Get-AzSqlServerTrustGroup'

Az.Storage

• Fixed an issue that list account from resource group won't use nextlink
  • 'Get-AzStorageAccount'
• Supported ChangeFeedRetentionInDays when Enable ChangeFeed on Blob service
  • 'Update-AzStorageBlobServiceProperty'

Az.Websites

• Updated 'Add-AzWebAppAccessRestrictionRule' to allow all supported Service Tags and validate against Service Tag API.

Thanks to our community contributors

• Freddie Sackur (@fsackur), Fix invalid SAS token from New-AzServiceBusAuthorizationRuleSASToken and New-AzEventHubAuthorizationRuleSASToken (#14535)
• Serafín Martín (@infoTrainingym), Unkown parameter (#14515)
• João Carlos Ferra de Almeida (@Jalmeida1994), Update Get-AzAksNodePool.md (#14503)
• Liam Barnett (@liambarnett), Fixed 3 typos in the document (#14335)
• @sbojjawar-Msft, Update Set-AzSqlDatabaseVulnerabilityAssessmentRuleBaseline.md (#14432)
• Yannick Dils (@yannickdils), Remove resource group from get-azloadbalancer this results in a region / zone update. (#14417)

https://www.powershellgallery.com/packages/Az.Tools.Predictor/0.2.0

• Second preview release
• Add Enable-AzPredictor and Disable-AzPredictor cmdlet to simplify configuration
• Use PSReadline new API

Gallery Module for Azure PowerShell : https://www.powershellgallery.com/packages/Az/5.6.0

To install Az from the PowerShell Gallery, run the following command:

Install-Module -Name Az -Repository PSGallery -Force

To update from an older version of Az, run the following command:

Update-Module -Name Az

Docker images

• mcr.microsoft.com/azure-powershell:latest
• mcr.microsoft.com/azure-powershell:ubuntu-18.04
• mcr.microsoft.com/azure-powershell:5.6.0-ubuntu-18.04
• mcr.microsoft.com/azure-powershell:debian-9
• mcr.microsoft.com/azure-powershell:5.6.0-debian-9
• mcr.microsoft.com/azure-powershell:centos-7
• mcr.microsoft.com/azure-powershell:5.6.0-centos-7
• mcr.microsoft.com/azure-powershell:alpine-3.10
• mcr.microsoft.com/azure-powershell:5.6.0-alpine-3.10

5.6.0 - March 2021

Az.Accounts

• Upgrade Azure.Identity to fix the issue that Connect-AzAccount fails when ADFS credential is used [#13560]

Az.Automation

• Fixed the issue that string cannot be serialized correctly. [#14215]
• Added Support for Python3 Runbook Type

Az.Compute

• Added parameter '-EnableHotpatching' to the 'Set-AzVMOperatingSystem' cmdlet for Windows machines.
• Added parameter '-PatchMode' to the Linux parameter sets in the cmdlet 'Set-AzVMOperatingSystem'.
• [Breaking Change] Breaking changes for users in the public preview for the VM Guest Patching feature.
  • Removed property 'RebootStatus' from the 'Microsoft.Azure.Management.Compute.Models.LastPatchInstallationSummary' object.
  • Removed property 'StartedBy' from the 'Microsoft.Azure.Management.Compute.Models.LastPatchInstallationSummary' object.
  • Renamed property 'Kbid' to 'KbId' in the 'Microsoft.Azure.Management.Compute.Models.VirtualMachineSoftwarePatchProperties' object.
  • Renamed property 'patches' to 'availablePatches' in the 'Microsoft.Azure.Management.Compute.Models.VirtualMachineAssessPatchesResult' object.
  • Renamed object 'Microsoft.Azure.Management.Compute.Models.SoftwareUpdateRebootBehavior' to 'Microsoft.Azure.Management.Compute.Models.VMGuestPatchRebootBehavior'.
  • Renamed object 'Microsoft.Azure.Management.Compute.Models.InGuestPatchMode' to 'Microsoft.Azure.Management.Compute.Models.WindowsVMGuestPatchMode'.
• [Breaking Change] Removed all 'ContainerService' cmdlets. The Container Service API was deprecated in January 2020.
  • 'Add-AzContainerServiceAgentPoolProfile'
  • 'Get-AzContainerService'
  • 'New-AzContainerService'
  • 'New-AzContainerServiceConfig'
  • 'Remove-AzContainerService'
  • 'Remove-AzContainerServiceAgentPoolProfile'
  • 'Update-AzContainerService'

Az.ContainerRegistry

• Fixed authentication for Connect-AzContainerRegistry

Az.CosmosDB

• Introduced NetworkAclBypass and NetworkAclBypassResourceIds for Database Account cmdlets.
• Introduced ServerVersion parameter to Update-AzCosmosDBAccount.
• Introduced BackupInterval and BackupRetention for Database Account cmdlets

Az.DataFactory

• Updated ADF .Net SDK version to 4.14.0

Az.Migrate

• Az.Migrate GA
• Incorporated Initialize-AzMigrateReplicationInfrastructure as a cmdlet in the Az.Migrate module, from the external script that is run currently today.
• Made some parameters of New-AzMigrateServerReplication, New-AzMigrateDiskMapping case insensitive.
• Added support for scale appliance change, to handle new V3 keys.

Az.RecoveryServices

• Added null check for target storage account in FileShare restore.

Az.Resources

• Added support for Azure resources deployment in Bicep language
• Fixed issues with TemplateSpec deployments in 'New-AzTenantDeployment' and 'New-AzManagementGroupDeployment'
• Added support for '-QueryString' parameter in 'Test-Az*Deployments' cmdlets
• Fixed issue with dynamic parameters when 'New-Az*Deployments' is used with '-QueryString'
• Added support for '-TemplateParameterObject' parameter while using '-TemplateSpecId' parameter in 'New-Az*Deployments' cmdlets
• Fixed the inaccurate error message received on trying to deploy a non-existent template spec

Az.Storage

• Upgraded to Microsoft.Azure.Management.Storage 19.0.0, to support new API version 2021-01-01.
• Supported resource access rule in NetworkRuleSet
  • 'Update-AzStorageAccountNetworkRuleSet'
  • 'Add-AzStorageAccountNetworkRule'
  • 'Remove-AzStorageAccountNetworkRule'
• Supported Blob version and Append Blob type in Management Policy
  • 'Add-AzStorageAccountManagementPolicyAction'
  • 'New-AzStorageAccountManagementPolicyFilter'
  • 'Set-AzStorageAccountManagementPolicy'
• Supported create/update account with AllowSharedKeyAccess
  • 'New-AzStorageAccount'
  • 'Set-AzStorageAccount'
• Supported create Encryption Scope with RequireInfrastructureEncryption
  • 'New-AzStorageEncryptionScope'
• Supported copy block blob synchronously, with encryption scope
  • 'Copy-AzStorageBlob'
• Fixed issue that Get-AzStorageBlobContent use wrong directory separator char on Linux and MacOS [#14234]

Az.Websites

• Introduced an option to give custom timeout for 'Publish-AzWebApp'
• Added support for App Service Environment
  • 'New-AzAppServiceEnvironment'
  • 'Remove-AzAppServiceEnvironment'
  • 'Get-AzAppServiceEnvironment'
  • 'New-AzAppServiceEnvironmentInboundServices'

Thanks to our community contributors

• @alunmj, Small spelling, formatting changes (#14155)
• @chakra146, Update Add-AzLoadBalancerInboundNatPoolConfig.md (#14231)
• Martin Ehrnst (@ehrnst), Fixed a typo in the cmdlet (#14112)
• Jan David Narkiewicz (@jdnark)
  • Examples used New-AzAks which is legacy cmdlet and the alias for New-AzAksCluster. Changed examples to use New-AzAksCluster which is the cmdlet this documentation page targets. (#14088)
  • Type fox: changed SshKeyVaule to SshKeyValue (#14087)
• Ivan Kulezic (@kukislav), Add sql mi maintenance configuration examples (#14216)
• @webguynj, Update Set-AzNetworkSecurityRuleConfig.md (#14176)
• Yannick Dils (@yannickdils), Added an additional cmdline to the example which applies the changes to the load balancer (#14185)

This release fixes the issue with error propagation for failed requests in case of PITR and RBAC cmdlets.

Release Notes

• Az.Migrate GA
• Incorporated Initialize-AzMigrateReplicationInfrastructure as a cmdlet in the Az.Migrate module, from the external script that is run currently today.
• Made some parameters of New-AzMigrateServerReplication, New-AzMigrateDiskMapping case insensitive.
• Added support for scale appliance change, to handle new V3 keys.

Release Notes

• Fixed authentication for Connect-AzContainerRegistry