Microsoft Azure Command-Line Tools
Project Links
Meta
Author: Microsoft Corporation
Requires Python: >=3.10.0
Classifiers
Development Status
- 5 - Production/Stable
Intended Audience
- Developers
- System Administrators
Programming Language
- Python
- Python :: 3
- Python :: 3.10
- Python :: 3.11
- Python :: 3.12
- Python :: 3.13
- Python :: 3.14
License
- OSI Approved :: MIT License
Microsoft Azure CLI
A great cloud needs great tools; we’re excited to introduce Azure CLI, our next generation multi-platform command line experience for Azure.
Usage
$ az [ group ] [ subgroup ] [ command ] {parameters}Getting Started
After installation, use the az configure command to help setup your environment.
$ az configureFor usage and help content, pass in the -h parameter, for example:
$ az storage -h
$ az vm create -hHighlights
Here are a few features and concepts that can help you get the most out of the Azure CLI.
The following examples are showing using the --output table format, you can change your default using the $ az configure command.
Tab Completion
We support tab-completion for groups, commands, and some parameters
# looking up resource group and name
$ az vm show -g [tab][tab]
AccountingGroup RGOne WebPropertiesRG
$ az vm show -g WebPropertiesRG -n [tab][tab]
StoreVM Bizlogic
$ az vm show -g WebPropertiesRG -n BizlogicQuerying
You can use the --query parameter and the JMESPath query syntax to customize your output.
$ az vm list --query '[].{name:name,os:storageProfile.osDisk.osType}'
Name Os
---------------------- -------
storevm Linux
bizlogic Linux
demo32111vm Windows
dcos-master-39DB807E-0 LinuxCreating a new Linux VM
The following block creates a new resource group in the ‘westus’ region, then creates a new Ubuntu VM. We automatically provide a series of smart defaults, such as setting up SSH with your ~/.ssh/id_rsa.pub key. For more details, try az vm create -h.
$ az group create -l westus -n MyGroup
Name Location
------- ----------
MyGroup westus
$ az vm create -g MyGroup -n MyVM --image ubuntults
MacAddress ResourceGroup PublicIpAddress PrivateIpAddress
----------------- --------------- ----------------- ------------------
00-0D-3A-30-B2-D7 MyGroup 52.160.111.118 10.0.0.4
$ ssh 52.160.111.118
Welcome to Ubuntu 14.04.4 LTS (GNU/Linux 3.19.0-65-generic x86_64)
System information as of Thu Sep 15 20:47:31 UTC 2016
System load: 0.39 Memory usage: 2% Processes: 80
Usage of /: 39.6% of 1.94GB Swap usage: 0% Users logged in: 0
jasonsha@MyVM:~$More Samples and Snippets
For more usage examples, take a look at our GitHub samples repo.
Reporting issues and feedback
If you encounter any bugs with the tool please file an issue in the Issues section of our GitHub repo.
To provide feedback from the command line, try the az feedback command.
License
Release History
2.88.0
Jul 07, 2026
2.87.0
Jun 02, 2026
2.86.0
May 04, 2026
2.85.0
Apr 07, 2026
2.84.0
Mar 03, 2026
2.83.0
Feb 03, 2026
2.82.0
Jan 13, 2026
2.81.0
Dec 02, 2025
2.80.0
Nov 18, 2025
2.79.0
Nov 04, 2025
2.78.0
Oct 14, 2025
2.77.0
Sep 02, 2025
2.76.0
Aug 05, 2025
2.75.0
Jul 01, 2025
2.74.0
Jun 03, 2025
2.73.0
May 19, 2025
2.72.0
May 06, 2025
2.71.0
Apr 01, 2025
2.70.0
Mar 04, 2025
2.69.0
Feb 11, 2025
2.68.0
Jan 14, 2025
2.67.0
Nov 19, 2024
2.66.2
Dec 10, 2025
2.66.1
Mar 04, 2025
2.66.0
Nov 11, 2024
2.65.0
Oct 08, 2024
2.64.0
Sep 03, 2024
2.63.0
Aug 06, 2024
2.62.0
Jul 09, 2024
2.61.0
May 21, 2024
2.60.0
Apr 30, 2024
2.59.0
Apr 02, 2024
2.58.0
Mar 05, 2024
2.57.0
Feb 06, 2024
2.56.0
Jan 09, 2024
2.55.0
Dec 05, 2023
2.54.0
Nov 14, 2023
2.53.1
Oct 24, 2023
2.53.0
Sep 26, 2023
2.52.0
Sep 05, 2023
2.51.0
Aug 01, 2023
2.50.0
Jul 04, 2023
2.49.0
May 23, 2023
2.48.1
Apr 25, 2023
2.48.0
Apr 25, 2023
2.47.0
Apr 04, 2023
2.46.0
Mar 07, 2023
2.45.0
Feb 07, 2023
2.44.1
Jan 11, 2023
2.44.0
Jan 10, 2023
2.43.0
Dec 06, 2022
2.42.0
Nov 01, 2022
2.41.0
Oct 12, 2022
2.40.0
Sep 06, 2022
2.39.0
Aug 02, 2022
2.38.0
Jul 05, 2022
2.37.0
May 24, 2022
2.36.0
Apr 26, 2022
2.35.0
Apr 06, 2022
2.34.1
Mar 03, 2022
2.34.0
Mar 01, 2022
2.33.1
Feb 14, 2022
2.33.0
Feb 08, 2022
2.32.0
Jan 04, 2022
2.31.0
Dec 07, 2021
2.30.0
Nov 02, 2021
2.29.2
Oct 29, 2021
2.29.1
Oct 21, 2021
2.29.0
Oct 12, 2021
2.28.1
Sep 09, 2021
2.28.0
Sep 07, 2021
2.27.2
Aug 23, 2021
2.27.1
Aug 11, 2021
2.27.0
Aug 03, 2021
2.26.1
Jul 14, 2021
2.26.0
Jul 07, 2021
2.25.0
Jun 15, 2021
2.24.2
Jun 02, 2021
2.24.1
Jun 01, 2021
2.24.0
May 25, 2021
2.23.0
May 06, 2021
2.22.1
Apr 19, 2021
2.22.0
Apr 13, 2021
2.21.0
Mar 23, 2021
2.20.0
Mar 02, 2021
2.19.1
Feb 10, 2021
2.19.0
Feb 09, 2021
2.18.0
Jan 19, 2021
2.17.1
Jan 04, 2021
2.17.0
Dec 29, 2020
2.16.0
Dec 08, 2020
2.15.1
Nov 20, 2020
2.15.0
Nov 17, 2020
2.14.2
Nov 09, 2020
2.14.1
Nov 06, 2020
2.14.0
Oct 27, 2020
2.13.0
Oct 13, 2020
2.12.1
Sep 28, 2020
2.12.0
Sep 22, 2020
2.11.1
Aug 28, 2020
2.11.0
Aug 25, 2020
2.10.1
Aug 06, 2020
2.10.0
Aug 04, 2020
2.9.1
Jul 16, 2020
2.9.0
Jul 14, 2020
2.8.0
Jun 23, 2020
2.7.0
Jun 02, 2020
2.6.0
May 19, 2020
2.5.1
Apr 30, 2020
2.5.0
Apr 28, 2020
2.4.0
Apr 21, 2020
2.3.1
Apr 01, 2020
2.3.0
Mar 31, 2020
2.2.0
Mar 10, 2020
2.1.0
Feb 18, 2020
2.0.81
Feb 04, 2020
2.0.80
Jan 13, 2020
2.0.79
Jan 07, 2020
2.0.78
Dec 18, 2019
2.0.77
Nov 26, 2019
2.0.76
Nov 04, 2019
2.0.75
Oct 15, 2019
2.0.74
Sep 24, 2019
2.0.73
Sep 11, 2019
2.0.72
Aug 27, 2019
2.0.71
Aug 13, 2019
2.0.70
Jul 30, 2019
2.0.69
Jul 16, 2019
2.0.68
Jul 02, 2019
2.0.67
Jun 18, 2019
2.0.66
Jun 04, 2019
2.0.65
May 21, 2019
2.0.64
May 06, 2019
2.0.63
Apr 23, 2019
2.0.62
Apr 09, 2019
2.0.61
Mar 26, 2019
2.0.60
Mar 07, 2019
2.0.59
Feb 26, 2019
2.0.58
Feb 12, 2019
2.0.57
Jan 31, 2019
2.0.56
Jan 30, 2019
2.0.55
Jan 15, 2019
2.0.54
Dec 20, 2018
2.0.53
Dec 18, 2018
2.0.52
Dec 04, 2018
2.0.51
Nov 20, 2018
2.0.50
Nov 06, 2018
2.0.49
Oct 23, 2018
2.0.48
Oct 16, 2018
2.0.47
Oct 09, 2018
2.0.46
Sep 21, 2018
2.0.45
Aug 28, 2018
2.0.44
Aug 14, 2018
2.0.43
Jul 31, 2018
2.0.42
Jul 18, 2018
2.0.41
Jul 03, 2018
2.0.40
Jul 03, 2018
2.0.38
Jun 19, 2018
2.0.37
Jun 13, 2018
2.0.35
Jun 05, 2018
2.0.34
Jun 05, 2018
2.0.33
May 22, 2018
2.0.32
May 07, 2018
2.0.31
Apr 10, 2018
2.0.30
Mar 27, 2018
2.0.29
Mar 13, 2018
2.0.28
Feb 27, 2018
2.0.27
Feb 13, 2018
2.0.26
Jan 31, 2018
2.0.25
Jan 17, 2018
2.0.24
Jan 05, 2018
2.0.23
Dec 19, 2017
2.0.22
Dec 05, 2017
2.0.21
Nov 14, 2017
2.0.20
Oct 24, 2017
2.0.19
Oct 09, 2017
2.0.18
Sep 22, 2017
2.0.17
Sep 11, 2017
2.0.16
Aug 31, 2017
2.0.15
Aug 28, 2017
2.0.14
Aug 15, 2017
2.0.13
Aug 11, 2017
2.0.12
Jul 28, 2017
2.0.10
Jul 07, 2017
2.0.9
Jun 21, 2017
2.0.8
Jun 13, 2017
2.0.7
May 30, 2017
2.0.6
May 09, 2017
2.0.5
May 05, 2017
2.0.4
Apr 28, 2017
2.0.3
Apr 17, 2017
2.0.2
Apr 03, 2017
2.0.1
Mar 13, 2017
2.0.0
Feb 27, 2017
0.1.2rc2
Feb 23, 2017
0.1.2rc1
Feb 17, 2017
0.1.1b3
Jan 30, 2017
0.1.1b2
Jan 19, 2017
0.1.1b1
Jan 17, 2017
0.1.0b11
Dec 12, 2016
0.1.0b10
Nov 28, 2016
0.1.0b9
Nov 14, 2016
0.1.0b8
Oct 24, 2016
0.1.0b7
Sep 24, 2016
0.1.0b4
Sep 20, 2016
Wheel compatibility matrix
Files in release
Extras:
None
Dependencies:
antlr4-python3-runtime
(~=4.13.1)
azure-appconfiguration
(~=1.7.2)
azure-ai-projects
(~=1.0.0)
azure-batch
(==15.0.0b1)
azure-cli-core
(==2.88.0)
azure-cosmos
(>=3.0.2,~=3.0)
azure-data-tables
(==12.4.0)
azure-datalake-store
(~=1.0.1)
azure-keyvault-administration
(==4.8.0b1)
azure-keyvault-certificates
(==4.7.0)
azure-keyvault-keys
(==4.12.0b2)
azure-keyvault-secrets
(==4.7.0)
azure-keyvault-securitydomain
(==1.0.0b1)
azure-mgmt-advisor
(==9.0.0)
azure-mgmt-apimanagement
(==4.0.0)
azure-mgmt-appconfiguration
(==6.0.0b2)
azure-mgmt-appcontainers
(==2.0.0)
azure-mgmt-applicationinsights
(~=1.0.0)
azure-mgmt-authorization
(==5.0.0b2)
azure-mgmt-batchai
(==7.0.0b1)
azure-mgmt-batch
(~=17.3.0)
azure-mgmt-billing
(==6.0.0)
azure-mgmt-botservice
(~=2.0.0b3)
azure-mgmt-cdn
(==12.0.0)
azure-mgmt-cognitiveservices
(~=15.0.0b2)
azure-mgmt-compute
(~=34.1.0)
azure-mgmt-containerinstance
(==10.2.0b1)
azure-mgmt-containerregistry
(==15.1.0b1)
azure-mgmt-containerregistrytasks
(==1.0.0b1)
azure-mgmt-containerservice
(~=41.3.0)
azure-mgmt-cosmosdb
(==9.9.0)
azure-mgmt-datalake-store
(~=1.1.0b1)
azure-mgmt-datamigration
(~=10.0.0)
azure-mgmt-domainregistration
(==1.0.0b1)
azure-mgmt-eventgrid
(==10.2.0b2)
azure-mgmt-eventhub
(~=12.0.0b1)
azure-mgmt-extendedlocation
(==1.0.0b2)
azure-mgmt-hdinsight
(==9.1.0b2)
azure-mgmt-imagebuilder
(~=1.3.0)
azure-mgmt-iotcentral
(~=10.0.0b1)
azure-mgmt-iothub
(==5.0.0b1)
azure-mgmt-iothubprovisioningservices
(==1.1.0)
azure-mgmt-keyvault
(==13.0.0)
azure-mgmt-loganalytics
(==13.0.0b4)
azure-mgmt-managementgroups
(~=1.0.0)
azure-mgmt-maps
(~=2.0.0)
azure-mgmt-marketplaceordering
(==1.1.0)
azure-mgmt-media
(~=9.0)
azure-mgmt-monitor
(~=7.0.0b1)
azure-mgmt-msi
(~=7.1.0)
azure-mgmt-netapp
(~=10.1.0)
azure-mgmt-policyinsights
(==1.1.0b4)
azure-mgmt-postgresqlflexibleservers
(==3.0.0b2)
azure-mgmt-privatedns
(~=1.0.0)
azure-mgmt-rdbms
(==10.2.0b17)
azure-mgmt-mysqlflexibleservers
(==1.1.0b2)
azure-mgmt-recoveryservicesbackup
(~=9.2.0)
azure-mgmt-recoveryservices
(~=4.0.0)
azure-mgmt-redhatopenshift
(~=3.0.0)
azure-mgmt-redis
(~=14.5.0)
azure-mgmt-resource
(==24.0.0)
azure-mgmt-resource-deployments
(==1.0.0b1)
azure-mgmt-resource-deploymentscripts
(==1.0.0b1)
azure-mgmt-resource-deploymentstacks
(==1.0.0)
azure-mgmt-resource-templatespecs
(==1.0.0b1)
azure-mgmt-search
(~=9.2)
azure-mgmt-security
(==6.0.0)
azure-mgmt-servicebus
(~=10.0.0b1)
azure-mgmt-servicefabricmanagedclusters
(==2.1.0b3)
azure-mgmt-servicelinker
(==1.2.0b3)
azure-mgmt-servicefabric
(~=2.1.0)
azure-mgmt-signalr
(==2.0.0b2)
azure-mgmt-sqlvirtualmachine
(==1.0.0b5)
azure-mgmt-sql
(==4.0.0b22)
azure-mgmt-storage
(==25.0.0)
azure-mgmt-synapse
(==2.1.0b5)
azure-mgmt-trafficmanager
(~=1.0.0)
azure-mgmt-web
(==11.0.0)
azure-monitor-query
(==1.2.0)
azure-storage-common
(~=1.4)
azure-storage-blob
(==12.29.0b1)
azure-storage-file-datalake
(==12.24.0b1)
azure-storage-file-share
(==12.25.0b1)
azure-storage-queue
(==12.16.0b1)
azure-synapse-accesscontrol
(~=0.5.0)
azure-synapse-artifacts
(~=0.22.0)
azure-synapse-managedprivateendpoints
(~=0.4.0)
azure-synapse-spark
(~=0.7.0)
chardet
(~=5.2.0)
colorama
(~=0.4.4)
distro
fabric
(~=3.2.2)
javaproperties
(~=0.5.1)
jsondiff
(~=2.0.0)
packaging
(>=20.9)
paramiko
(<4.0.0,>=2.0.8)
pycomposefile
(>=0.0.34)
PyGithub
(~=1.38)
PyNaCl
(~=1.6.2)
scp
(~=0.13.2)
semver
(~=3.0)
setuptools
six
(>=1.10.0)
sshtunnel
(~=0.1.4)
tabulate
urllib3
websocket-client
(~=1.8.0)
xmltodict
(~=0.12)