Skip to main content

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 configure

For usage and help content, pass in the -h parameter, for example:

$ az storage -h
$ az vm create -h

Highlights

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 Bizlogic

Querying

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  Linux

Creating 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

MIT

Release History

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

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.

Project details


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

azure-cli-2.0.67.tar.gz (8.6 kB view details)

Uploaded Source

Built Distribution

azure_cli-2.0.67-py2.py3-none-any.whl (8.3 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file azure-cli-2.0.67.tar.gz.

File metadata

  • Download URL: azure-cli-2.0.67.tar.gz
  • Upload date:
  • Size: 8.6 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.8.0 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.7.3

File hashes

Hashes for azure-cli-2.0.67.tar.gz
Algorithm Hash digest
SHA256 4c7e87f8bb6f6143f5a2c2bc9c2e7e7d56f6836dbb658cca00452cfd09194ec5
MD5 ea5d54977af6d8c601c7bae51d09e75a
BLAKE2b-256 0686fdacfaa0d0b770ae6d2437602f1dd02745e055cebeeba742ba4e07dcd33f

See more details on using hashes here.

File details

Details for the file azure_cli-2.0.67-py2.py3-none-any.whl.

File metadata

  • Download URL: azure_cli-2.0.67-py2.py3-none-any.whl
  • Upload date:
  • Size: 8.3 kB
  • 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.8.0 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.7.3

File hashes

Hashes for azure_cli-2.0.67-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 b1aa8fb64ed8a1c342ae9f1351b71a25c718ee9be8ae8f05d47f5eb18abadf32
MD5 56d5014d7035003f818dbda6c95f9fee
BLAKE2b-256 0c20c1297dad30c6b6d5fa4efe144effcf017a623f1359947350f052bc1f4cdc

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page