Az
12.0.0
Microsoft Azure PowerShell - Cmdlets to manage resources in Azure. This module is compatible with PowerShell and Windows PowerShell.
For more information about the Az module, please visit the following: https://learn.microsoft.com/powershell/azure/
Minimum PowerShell version
5.1
Installation Options
Owners
Copyright
Microsoft Corporation. All rights reserved.
Package Details
Author(s)
- Microsoft Corporation
 
Tags
Azure ARM ResourceManager Linux AzureAutomationNotSupported
PSEditions
Dependencies
- 
                                        
- Az.Accounts (>= 3.0.0)
 - Az.Advisor (= 2.0.1)
 - Az.Aks (= 6.0.3)
 - Az.AnalysisServices (= 1.1.5)
 - Az.ApiManagement (= 4.0.3)
 - Az.App (= 1.0.0)
 - Az.AppConfiguration (= 1.3.1)
 - Az.ApplicationInsights (= 2.2.5)
 - Az.ArcResourceBridge (= 1.0.1)
 - Az.Attestation (= 2.0.2)
 - Az.Automanage (= 1.0.1)
 - Az.Automation (= 1.10.0)
 - Az.Batch (= 3.6.1)
 - Az.Billing (= 2.0.4)
 - Az.Cdn (= 3.2.0)
 - Az.CloudService (= 2.0.1)
 - Az.CognitiveServices (= 1.14.1)
 - Az.Compute (= 8.0.0)
 - Az.ConfidentialLedger (= 1.0.1)
 - Az.ContainerInstance (= 4.0.1)
 - Az.ContainerRegistry (= 4.2.1)
 - Az.CosmosDB (= 1.14.3)
 - Az.DataBoxEdge (= 1.1.1)
 - Az.Databricks (= 1.7.2)
 - Az.DataFactory (= 1.18.4)
 - Az.DataLakeAnalytics (= 1.0.3)
 - Az.DataLakeStore (= 1.3.1)
 - Az.DataProtection (= 2.4.0)
 - Az.DataShare (= 1.0.2)
 - Az.DesktopVirtualization (= 4.3.1)
 - Az.DevCenter (= 1.1.1)
 - Az.DevTestLabs (= 1.0.3)
 - Az.Dns (= 1.2.1)
 - Az.DnsResolver (= 1.0.0)
 - Az.ElasticSan (= 1.0.2)
 - Az.EventGrid (= 2.0.0)
 - Az.EventHub (= 5.0.0)
 - Az.FrontDoor (= 1.10.1)
 - Az.Functions (= 4.0.8)
 - Az.HDInsight (= 6.1.0)
 - Az.HealthcareApis (= 2.0.1)
 - Az.IotHub (= 2.7.6)
 - Az.KeyVault (= 6.0.0)
 - Az.Kusto (= 2.3.1)
 - Az.LoadTesting (= 1.0.1)
 - Az.LogicApp (= 1.5.1)
 - Az.MachineLearning (= 1.1.4)
 - Az.MachineLearningServices (= 1.0.1)
 - Az.Maintenance (= 1.4.1)
 - Az.ManagedServiceIdentity (= 1.2.1)
 - Az.ManagedServices (= 3.0.1)
 - Az.MarketplaceOrdering (= 2.0.1)
 - Az.Media (= 1.1.2)
 - Az.Migrate (= 2.3.1)
 - Az.Monitor (= 5.2.1)
 - Az.MySql (= 1.1.2)
 - Az.Network (= 7.6.0)
 - Az.NetworkCloud (= 1.0.1)
 - Az.Nginx (= 1.0.1)
 - Az.NotificationHubs (= 1.1.2)
 - Az.OperationalInsights (= 3.2.1)
 - Az.PolicyInsights (= 1.6.5)
 - Az.PostgreSql (= 1.1.1)
 - Az.PowerBIEmbedded (= 2.0.0)
 - Az.PrivateDns (= 1.0.5)
 - Az.RecoveryServices (= 7.0.0)
 - Az.RedisCache (= 1.9.1)
 - Az.RedisEnterpriseCache (= 1.2.1)
 - Az.Relay (= 2.0.1)
 - Az.ResourceGraph (= 1.0.0)
 - Az.ResourceMover (= 1.2.1)
 - Az.Resources (= 7.1.0)
 - Az.Security (= 1.6.2)
 - Az.SecurityInsights (= 3.1.2)
 - Az.ServiceBus (= 4.0.0)
 - Az.ServiceFabric (= 3.3.3)
 - Az.SignalR (= 2.0.1)
 - Az.Sql (= 5.0.0)
 - Az.SqlVirtualMachine (= 2.2.1)
 - Az.StackHCI (= 2.3.2)
 - Az.StackHCIVM (= 1.0.4)
 - Az.Storage (= 7.0.0)
 - Az.StorageMover (= 1.3.1)
 - Az.StorageSync (= 2.1.1)
 - Az.StreamAnalytics (= 2.0.1)
 - Az.Support (= 2.0.0)
 - Az.Synapse (= 3.0.8)
 - Az.TrafficManager (= 1.2.2)
 - Az.Websites (= 3.2.1)
 
 
Release Notes
12.0.0 - May 2024
General
* Fixed CVE-2024-29992.
Az.Accounts
* Web Account Manager (WAM) was set the default experience of interactive login. For more details please refer to https://go.microsoft.com/fwlink/?linkid=2272007
* Enabled secrets detection option by default.
* Fixed a null reference issue during the process of 'Get-AzContext -ListAvailable' [#24854].
* Supported interactive subscription selection for user login flow. See more details at [Announcing a new login experience with Azure PowerShell and Azure CLI
](https://techcommunity.microsoft.com/t5/azure-tools-blog/announcing-a-new-login-experience-with-azure-powershell-and/ba-p/4109357)
* Added config 'LoginExperienceV2' to allow customer to switch the default behavior of context selection back. Check the help document of 'Update-AzConfig' for more details.
* Supported auto-discovery of the endpoint of OperationalInsights (azure-powershell-common/pull/414)
* Updated the reference of Azure PowerShell Common to 1.3.94-preview.
* [Breaking Change] Removed config 'DisableErrorRecordsPersistence' to disable writing error records, error recording is now opt-in
* Added config 'EnableErrorRecordsPersistence' to enable writing error records to file system
Az.AnalysisServices
* Removed the outdated deps.json file.
Az.ApiManagement
* Removed the outdated deps.json file.
Az.Batch
* Removed the out-of-date breaking change message for 'Get-AzBatchCertificate' and 'New-AzBatchCertificate'.
Az.Billing
* Removed the outdated deps.json file.
Az.Compute
* Added new optional parameter 'SecureVMGuestStateSAS' to cmdlet 'Grant-AzDiskAccess'.
* [Breaking Change] Added ValidateNotNullOrEmpty for '-ResourceGroupName' and '-VMScaleSetName' parameters to 'Get-AzVmss' cmdlet. [#20095]
* Added 'Etag' property to PSVirtualMachine and PSVirtualMachineScaleSet objects.   
* Added parameters '-IfMatch' and '-IfNoneMatch' to 'Update-AzVM', 'Update-AzVmss', 'New-AzVm', 'New-AzVmss', 'New-AzVmConfig', and 'New-AzVmssConfig' cmdlets.
* [Breaking Change] Cmdlet 'New-AzGalleryImageDefinition' will default parameter '-HyperVGeneration' to 'V2' if it is not set as 'V1' explicitly, and also default parameter '-Feature' by adding '@{Name='SecurityType';Value='TrustedLaunchSupported'}' if the 'SecurityType' feature is not set explicitly. 
* Resolved the bug with 'New-AzVMConfig' for '-CommunityGalleryImageId' and '-SharedGalleryImageId' parameters.
* [Breaking Change] Added ValidateNotNullOrEmpty for '-ResourceGroupName' and '-VMScaleSetName' parameters to 'Get-AzVmss' cmdlet. [#20095]
* [Breaking Change] Added new business logic to 'New-AzVmss' and 'New-AzVM' cmdlets. When the user explicitly sets the 'SecurityType' to 'Standard', the Image alias defaults to 'Win2022AzureEdition' to make future migrations to Trusted Launch easier.
Az.CosmosDB
* Removed the out-of-date breaking change message for 'Get-AzCosmosDBAccountKey'.
Az.DataBoxEdge
* Removed the outdated deps.json file.
Az.DataFactory
* Updated ADF encryption client SDK version to 5.29.8499.2
Az.DataLakeStore
* Removed the outdated deps.json file.
Az.DataShare
* Removed the outdated deps.json file.
Az.DevTestLabs
* Removed the outdated deps.json file.
Az.DnsResolver
* General availability for module Az.DnsResolver
Az.EventGrid
* Updated to use the 2023-06-01-preview API version.
Az.EventHub
* Moved cmdlets to V4
Az.FrontDoor
* Removed the outdated deps.json file.
Az.IotHub
* Removed the outdated deps.json file.
Az.KeyVault
* [Breaking change] Removed the offline fallback policy if specify parameter 'UseDefaultCVMPolicy' in 'Add-AzKeyVaultKey'. Key creation will fail if unable to get regional default CVM SKR policy from MAA Service Discovery API.
* [Breaking change] Removed parameter 'Value' from 'Invoke-AzKeyVaultKeyOperation'.
* [Breaking change] Removed property 'Result' from the output type 'PSKeyOperationResult' of 'Invoke-AzKeyVaultKeyOperation'.
* [Breaking Change] Replaced parameter 'EnableRbacAuthorization' by 'DisableRbacAuthorization' in 'New-AzKeyVault' and 'Update-AzKeyVault'.
    - RBAC will be enabled by default during the process of key vault creation. 
Az.MachineLearning
* Removed the outdated deps.json file.
Az.MachineLearningServices
* Removed the outdated deps.json file.
Az.Monitor
* Removed breaking change warning messages for Metric Management Plane
    * Get-AzMetric
    * Get-AzMetricDefinition
    * New-AzMetricFilter
Az.Network
* Added cmdlet 'New-AzVirtualApplianceNetworkProfile' to build network profile for network virtual appliance and pass as a parameter.
* Added cmdlet 'New-AzVirtualApplianceNetworkInterfaceConfiguration' and 'New-AzVirtualApplianceIpConfiguration' to build 'New-AzVirtualApplianceNetworkProfile'.
* Added support for ApplicationGatewaySkuFamily 
* Updated cmdlet to add the property of JSChallengeCookieExpirationInMins
    - 'New-AzApplicationGatewayFirewallPolicySetting'
* Added optional property 'HeaderValueMatcher' to 'New-AzApplicationGatewayRewriteRuleHeaderConfiguration'
* Added new cmdlet 'New-AzApplicationGatewayHeaderValueMatcher' to support for the new property 'HeaderValueMatcher'
* Added new cmdlet 'Update-AzVirtualApplianceInboundSecurityRule' to support Inbound Security Rule for Network Virtual Appliance
* Added new cmdlet 'New-AzVirtualApplianceInboundSecurityRulesProperty' to support for the property 'rules' of Inbound Security Rules
* Added AdminState parameter to Load Balancer Backend Address
    - 'New-AzLoadBalancerBackendAddressConfig'
* Updated PS SDK to older SDK removing identity field
Az.OperationalInsights
* Fixed an issue that 'Invoke-AzOperationalInsightsQuery' timed out after 100 seconds. The timeout is now bound to the '-Wait' parameter. (#16553)
* Removed the outdated deps.json file.
Az.PrivateDns
* Removed the outdated deps.json file.
Az.RecoveryServices
* [Breaking Change] Renamed the property 'ResouceType' of 'ASRVaultSettings' to 'ResourceType'. 
Az.RedisCache
* Fixed pattern for access policy resource names
Az.ResourceGraph
* General availability for module Az.ResourceGraph
Az.Resources
* Fixed deployment and deployment stack New/Set cmdlets to fail if template/parameter uri fails to downloads.
* Deployment Stack cmdlets GA release/updates.
* [Breaking Change] Redesigned CRUD cmdlets for 'PolicyAssignment', 'PolicyDefinition', 'PolicyExemption', 'PolicySetDefinition'. Please see Az 12 migration guide https://learn.microsoft.com/en-us/powershell/azure/migrate-az-12.0.0 for more detail.
* Added null check to the permissions object in the ToPSRoleDefinition method to return if the whole permissions object array is null.
Az.ServiceBus
* Moved cmdlets to V4.
Az.ServiceFabric
* Updated location of nodeType to use cluster location in stead of resource group location
Az.Sql
* Added multi-secondary support for 'Get-AzSqlDatabaseFailoverGroup', 'Remove-AzSqlDatabaseFromFailoverGroup' and 'Add-AzSqlDatabaseFromFailoverGroup'
* Changed default FailoverPolicy value for 'New-AzSqlDatabaseFailoverGroup', 'Set-AzSqlDatabaseFailoverGroup' from 'Automatic' to 'Manual'
* Added 'ManualCutover' and 'PerformCutover' parameters to 'Set-AzSqlInstance' for Azure Sql Sterling database to Azure Sql Hyperscale database
* Added 'OperationPhaseDetails' parameter to 'Get-AzSqlDatabaseActivity' and updated 'DatabaseOperations' Api to version '2022-11-01-preview' for .Net Sdk
Az.StackHCIVM
* Fixed the placeholder in psd1 file.
Az.Storage
* Added a prompt that needs confirmation when upgrading a storage account from StorageV1 or BlobStorage to StorageV2. Can be suppressed with -Force.
    - 'Set-AzStorageAccount'
* Removed references to 'Microsoft.Azure.Storage.Queue' in Queue cmdlets 
    - 'Get-AzStorageQueue'
    - 'New-AzStorageQueue'
    - 'New-AzStorageQueueSASToken'
* When uploading an Azure File with write only SAS token, take the parameter -Path as destination file path, instead of destination directory path previously.
    - 'Set-AzStorageFileContent'
Az.Support
* Converted Az.Support to autorest-based module.
Az.Synapse
* Upgraded 'Microsoft.DataTransfer.Gateway.Encryption' to '5.29.8499.2'
FileList
Version History
| Version | Downloads | Last updated | 
|---|---|---|
| 14.6.0 | 86,217 | 11/4/2025 | 
| 14.5.0 | 3,913,682 | 10/14/2025 | 
| 14.4.0 | 7,937,396 | 9/2/2025 | 
| 14.3.0 | 5,027,938 | 8/5/2025 | 
| 14.2.0 | 6,117,172 | 7/1/2025 | 
| 14.1.0 | 4,315,989 | 6/3/2025 | 
| 14.0.0 | 2,270,463 | 5/19/2025 | 
| 13.5.0 | 2,088,369 | 5/6/2025 | 
| 13.4.0 | 4,670,550 | 4/1/2025 | 
| 13.3.0 | 3,235,309 | 3/4/2025 | 
| 13.2.0 | 2,541,387 | 2/11/2025 | 
| 13.1.0 | 4,135,925 | 1/14/2025 | 
| 13.0.0 | 5,419,595 | 11/19/2024 | 
| 12.5.0 | 1,105,812 | 11/11/2024 | 
| 12.4.0 | 3,309,659 | 10/8/2024 | 
| 12.3.0 | 2,527,625 | 9/3/2024 | 
| 12.2.0 | 2,021,335 | 8/6/2024 | 
| 12.1.0 | 2,454,330 | 7/9/2024 | 
| 12.0.0 (current version) | 4,636,472 | 5/21/2024 | 
| 11.6.0 | 1,796,070 | 4/30/2024 | 
| 11.5.0 | 1,763,391 | 4/2/2024 | 
| 11.4.0 | 1,848,070 | 3/5/2024 | 
| 11.3.1 | 1,497,000 | 2/9/2024 | 
| 11.3.0 | 456,021 | 2/6/2024 | 
| 11.2.0 | 1,476,677 | 1/9/2024 | 
| 11.1.0 | 1,570,784 | 12/5/2023 | 
| 11.0.0 | 1,191,404 | 11/14/2023 | 
| 10.4.1 | 3,062,046 | 9/27/2023 | 
| 10.4.0 | 69,494 | 9/26/2023 | 
| 10.3.0 | 3,972,087 | 9/5/2023 | 
| 10.2.0 | 1,282,527 | 8/1/2023 | 
| 10.1.0 | 1,086,190 | 7/4/2023 | 
| 10.0.0 | 1,508,081 | 5/23/2023 | 
| 9.7.1 | 2,392,749 | 4/28/2023 | 
| 9.7.0 | 143,152 | 4/25/2023 | 
| 9.6.0 | 810,524 | 4/4/2023 | 
| 9.5.0 | 1,140,501 | 3/9/2023 | 
| 9.4.0 | 2,311,172 | 2/7/2023 | 
| 9.3.0 | 1,252,131 | 1/10/2023 | 
| 9.2.0 | 1,141,729 | 12/6/2022 | 
| 9.1.1 | 687,406 | 11/17/2022 | 
| 9.1.0 | 555,059 | 11/1/2022 | 
| 9.0.1 | 1,411,630 | 10/17/2022 | 
| 8.3.0 | 1,950,549 | 9/6/2022 | 
| 8.2.0 | 921,615 | 8/2/2022 | 
| 8.1.0 | 685,717 | 7/5/2022 | 
| 8.0.0 | 3,980,962 | 5/24/2022 | 
| 7.5.0 | 4,320,694 | 4/26/2022 | 
| 7.4.0 | 380,969 | 4/5/2022 | 
| 7.3.2 | 467,392 | 3/12/2022 | 
| 7.3.0 | 268,773 | 3/1/2022 | 
| 7.2.1 | 190,191 | 2/18/2022 | 
| 7.2.0 | 295,338 | 2/7/2022 | 
| 7.1.0 | 687,860 | 1/4/2022 | 
| 7.0.0 | 497,758 | 12/7/2021 | 
| 6.6.0 | 2,283,949 | 11/2/2021 | 
| 6.5.0 | 521,741 | 10/12/2021 | 
| 6.4.0 | 758,722 | 9/7/2021 | 
| 6.3.0 | 654,007 | 8/3/2021 | 
| 6.2.1 | 552,146 | 7/9/2021 | 
| 6.2.0 | 69,128 | 7/6/2021 | 
| 6.1.0 | 401,611 | 6/15/2021 | 
| 6.0.0 | 403,396 | 5/25/2021 | 
| 5.9.0 | 3,434,386 | 5/4/2021 | 
| 5.8.0 | 441,027 | 4/13/2021 | 
| 5.7.0 | 670,785 | 3/23/2021 | 
| 5.6.0 | 539,154 | 3/2/2021 | 
| 5.5.0 | 886,869 | 2/9/2021 | 
| 5.4.0 | 1,647,284 | 1/19/2021 | 
| 5.3.0 | 1,474,755 | 12/29/2020 | 
| 5.2.0 | 1,395,753 | 12/8/2020 | 
| 5.1.0 | 1,677,868 | 11/17/2020 | 
| 5.0.0 | 1,713,341 | 10/27/2020 | 
| 4.8.0 | 4,214,674 | 10/13/2020 | 
| 4.7.0 | 266,802 | 9/22/2020 | 
| 4.6.1 | 1,823,717 | 8/28/2020 | 
| 4.6.0 | 119,616 | 8/25/2020 | 
| 4.5.0 | 431,843 | 8/4/2020 | 
| 4.4.0 | 366,166 | 7/14/2020 | 
| 4.3.0 | 410,197 | 6/23/2020 | 
| 4.2.0 | 399,847 | 6/2/2020 | 
| 4.1.0 | 339,394 | 5/19/2020 | 
| 4.0.2-preview | 2,416 | 12/23/2019 | 
| 4.0.1-preview | 1,057 | 10/9/2019 | 
| 3.8.0 | 2,071,975 | 4/21/2020 | 
| 3.7.0 | 299,600 | 3/31/2020 | 
| 3.6.1 | 372,567 | 3/10/2020 | 
| 3.5.0 | 372,859 | 2/18/2020 | 
| 3.4.0 | 204,748 | 2/4/2020 | 
| 3.3.0 | 382,114 | 1/7/2020 | 
| 3.2.0 | 326,416 | 12/17/2019 | 
| 3.1.0 | 579,916 | 11/26/2019 | 
| 3.0.0 | 463,850 | 11/4/2019 | 
| 2.8.0 | 1,118,354 | 10/15/2019 | 
| 2.7.0 | 184,600 | 9/24/2019 | 
| 2.6.0 | 320,182 | 8/27/2019 | 
| 2.5.0 | 415,657 | 7/30/2019 | 
| 2.4.0 | 176,111 | 7/2/2019 | 
| 2.3.2 | 177,405 | 6/18/2019 | 
| 2.2.0 | 78,575 | 6/4/2019 | 
| 2.1.0 | 70,141 | 5/21/2019 | 
| 2.0.1 | 11,414 | 12/15/2021 | 
| 2.0.0 | 114,926 | 5/6/2019 | 
| 1.8.0 | 367,815 | 4/23/2019 | 
| 1.7.0 | 54,757 | 4/9/2019 | 
| 1.6.0 | 83,096 | 3/26/2019 | 
| 1.5.0 | 55,967 | 3/12/2019 | 
| 1.4.0 | 43,798 | 2/26/2019 | 
| 1.3.0 | 33,050 | 2/12/2019 | 
| 1.2.1 | 25,190 | 1/31/2019 | 
| 1.2.0 | 4,840 | 1/29/2019 | 
| 1.1.0 | 20,114 | 1/15/2019 | 
| 1.0.1 | 33,776 | 12/18/2018 | 
| 1.0.0 | 28,213 | 12/18/2018 | 
| 0.10.0-preview | 14,115 | 4/15/2020 | 
| 0.7.0 | 14,746 | 12/4/2018 | 
| 0.6.1 | 9,455 | 11/21/2018 | 
| 0.5.0 | 9,933 | 11/6/2018 | 
| 0.4.0 | 11,300 | 10/23/2018 | 
| 0.3.0 | 11,063 | 10/9/2018 | 
| 0.2.2 | 5,236 | 9/24/2018 | 
| 0.1.0 | 718 | 8/28/2018 |