Microsoft Azure Command-Line Tools
Project description
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.0.68
ACR
Support Timer Triggers for Task.
Appservice
functionapp: az functionapp create enables application insights by default
BREAKING CHANGE: (functionapp) removes deprecated az functionapp devops-build command. Please use the new command az functionapp devops-pipeline instead.
functionapp: az functionapp deployment config-zip now works for Linux Consumption Function app plans
Cosmos DB
Added support for disabling TTL
DLS
Update ADLS version (0.0.45).
Feedback
When reporting a failed extension command, az feedback now attempts to open the browser to the project/repo url of the extension from the index.
HDInsight
BREAKING CHANGE: Changed “oms” command group name to “monitor”
BREAKING CHANGE: Made “–http-password/-p” a required parameter
Added completers for “–cluster-admin-account” and “cluster-users-group-dns” parameters completer
“cluster-users-group-dns” parameter is now required when “—esp” is present
Added a timeout for all existing argument auto-completers
Added a timeout for transforming resource name to resource id
Auto-completers can now select resources from any resource group. It can be a different resource group than the one specified with “-g”
Added support for “–sub-domain-suffix” and “–disable_gateway_auth” parameters in the “az hdinsight application create” command
Managed Services
Introducing managed service command module in preview.
Profile * Suppress –subscription argument for logout command.
RBAC
[BREAKING CHANGE] create-for-rbac: remove –password
- role assignment: expose –assignee-principal-type from create command to avoid intermittent
failures caused by AAD graph server replication latency
ad signed-in-user: fix a crash on listing owned objects
ad sp: use the right approach to find the application from a service principal
RDBMS
Support replication for MariaDB.
SQL
Document allowed values for sql db create –sample-name
VM
vmss create: Fix bug where command returns an error message when run with –no-wait. The command succesfully sends the request but returns failure status code and returns an error mesage.
vm/vmss extension image list: Fix bug where command fails when used with –latest
VM
vmss create –single-placement-group: Removed client-side validation. Does not fail if –single-placement-group is set to true and`–instance-count` is greater than 100 or availability zones are specified, but leaves this validation to the compute service.
Storage
storage blob generate-sas: User delegation SAS token support with –as-user
storage container generate-sas: User delegation SAS token support with –as-user
2.0.67
Introduced a new [Preview] status to tag to more clearly communicate to customers when a command group, command or argument is in preview status. This was previously called out in help text or communicated implicitly by the command module version number. The CLI will be removing version numbers for individual packages in the future, so this mechanism will be the sole way to communicate that a feature is in preview. Items which are not labeled as being in preview can be considered to be GA. Not that if a command is in preview, all of its arguments are as well, and, by extension, if a command group is labeled as being in preview, then all commands and arguments are considered to be in preview as well.
As a result of this change, several command groups may seem to “suddenly” appear to be in a preview status with this release. What actually happened is that most packages were in a preview status, but are being deemed GA with this release.
2.0.66
Minor fixes.
2.0.65
Minor fixes.
2.0.64
Minor fixes.
2.0.63
Minor fixes.
2.0.62
Minor fixes.
2.0.61
Minor fixes.
2.0.60
Minor fixes.
2.0.59
Minor fixes.
2.0.58
Pinning versions of command modules for pip install.
2.0.57
Hot fix for issue 8399.
2.0.56
Minor fixes
2.0.55
Minor fixes
2.0.54
Minor fixes
2.0.53
Minor fixes
2.0.52
Minor fixes
2.0.51
Minor fixes
2.0.50
Minor fixes
2.0.49
Minor fixes
2.0.48
Fix Homebrew
2.0.47
Minor fixes
2.0.46
Minor fixes
2.0.45
Minor fixes
2.0.44
Minor fixes
2.0.43
Minor fixes
2.0.42
Minor fixes
2.0.41
Minor fixes
2.0.40
Minor fixes
2.0.39
MSI packaging change
2.0.38
Minor fixes
2.0.37
Minor fixes
2.0.36
Minor fixes
2.0.35
Minor fixes
2.0.34
Minor fixes
2.0.33
Minor fixes
2.0.32
Minor fixes
2.0.31
Minor fixes
2.0.30
Minor fixes
2.0.29
Minor fixes
2.0.28
Bug fix for ‘ValueError: field 6 out of range (need a 48-bit value)’ - https://github.com/Azure/azure-cli/issues/5184
2.0.27
Minor fixes
2.0.26
Minor fixes
2.0.25
Minor fixes
2.0.24
Minor fixes
2.0.23
Minor fixes
2.0.22
Remove az component commands. Use az extension instead. az component has been deprecated for several months now.
2.0.21
Minor fixes
2.0.20
2.0.19 (2017-10-09)
no changes
2.0.18 (2017-09-22)
no changes
2.0.17 (2017-09-11)
no changes
2.0.16 (2017-08-31)
no changes
2.0.15 (2017-08-28)
no changes
2.0.14 (2017-08-15)
no changes
2.0.13 (2017-08-11)
no changes
2.0.12 (2017-07-28)
no changes
2.0.11 (2017-07-27)
Allow finer grained chunking for Data Lake Store transfer (#4014)
2.0.10 (2017-07-07)
no changes
2.0.9 (2017-06-21)
no changes
2.0.8 (2017-06-13)
no changes
2.0.7 (2017-05-30)
Add billing modules to setup (#3465)
2.0.6 (2017-05-09)
documentdb renamed to cosmosdb
Add rdbms
2.0.5 (2017-05-05)
Include Data Lake Analytics and Data Lake Store modules.
Include Cognitive Services module.
Include Service Fabric module.
Include Interactive module.
Remove Container module
2.0.4 (2017-04-28)
Add ‘az -v’ as shortcut for ‘az –version’ (#2926)
2.0.3 (2017-04-17)
Improve performance of package load and command execution (#2819)
Alter JSON string parsing from shell (#2705)
2.0.2 (2017-04-03)
Add acr, lab and monitor modules to default list.
2.0.1 (2017-03-13)
Add ‘az find’ module
2.0.0 (2017-02-27)
GA release.
0.1.2rc2 (2017-02-22)
Fix format of package readme on PyPI.
0.1.2rc1 (2017-02-17)
Handle cloud switching in more user friendly way + remove context
Include the following command modules by default:
azure-cli-acs azure-cli-appservice azure-cli-batch azure-cli-cloud azure-cli-component azure-cli-configure azure-cli-container azure-cli-documentdb azure-cli-feedback azure-cli-iot azure-cli-keyvault azure-cli-network azure-cli-profile azure-cli-redis azure-cli-resource azure-cli-role azure-cli-sql azure-cli-storage azure-cli-vm
0.1.1b3 (2017-01-30)
Support Python 3.6.
0.1.1b2 (2017-01-19)
Modify telemetry code to be compatible with the change to azure-cli-core 0.1.1b2.
0.1.1b1 (2017-01-17)
[Tab completion] Enable zsh compatibility mode for zsh shell for ‘pip’ installed CLI.
Modify telemetry code to be compatible with the change to azure-cli-core.
0.1.0b11 (2016-12-12)
Preview release.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file azure-cli-2.0.68.tar.gz.
File metadata
- Download URL: azure-cli-2.0.68.tar.gz
- Upload date:
- Size: 965.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/40.6.2 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 58164319e207c8435f67b364a1e0d1de3416e2ba6589e28fea728f9f799c98e9 |
|
| MD5 | 270bb812c1000b63502911ad395adf62 |
|
| BLAKE2b-256 | f7f613735caf0bd3941ef81027f771e699cc1c09461b84c6cdf8c135461b8f3d |
File details
Details for the file azure_cli-2.0.68-py2.py3-none-any.whl.
File metadata
- Download URL: azure_cli-2.0.68-py2.py3-none-any.whl
- Upload date:
- Size: 1.2 MB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/40.6.2 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 6c16507165adfdc3a80cf697946d2454804a50127a9e3e8f3da1849ec410b33f |
|
| MD5 | 7b0d88ea0f740ad828024507f3e3d83e |
|
| BLAKE2b-256 | 4507dcfbda2615849f019047cd674ca226f2c3257bd3b75bd3dac08b2434897c |
