Microsoft Azure Command-Line Tools
Project description
Microsoft Azure CLI 2.0 - Preview
==================================
A great cloud needs great tools; we're excited to introduce *Azure CLI 2.0 - Preview*, our next generation multi-platform command line experience for Azure.
Usage
=====
.. code-block:: console
$ az [ group ] [ subgroup ] [ command ] {parameters}
Getting Started
=====================
After installation, use the ``az configure`` command to help setup your environment.
.. code-block:: console
$ az configure
For usage and help content, pass in the ``-h`` parameter, for example:
.. code-block:: console
$ 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 2.0 Preview
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
.. code-block:: console
# 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.
.. code-block:: console
$ 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``.
.. code-block:: console
$ 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 <http://github.com/Azure/azure-cli-samples>`__.
Reporting issues and feedback
=======================================
If you encounter any bugs with the tool please file an issue in the `Issues <https://github.com/Azure/azure-cli/issues>`__ section of our GitHub repo.
To provide feedback from the command line, try the ``az feedback`` command.
License
=======
`MIT <https://github.com/Azure/azure-cli/blob/master/LICENSE.txt>`__
.. :changelog:
Release History
===============
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.
==================================
A great cloud needs great tools; we're excited to introduce *Azure CLI 2.0 - Preview*, our next generation multi-platform command line experience for Azure.
Usage
=====
.. code-block:: console
$ az [ group ] [ subgroup ] [ command ] {parameters}
Getting Started
=====================
After installation, use the ``az configure`` command to help setup your environment.
.. code-block:: console
$ az configure
For usage and help content, pass in the ``-h`` parameter, for example:
.. code-block:: console
$ 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 2.0 Preview
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
.. code-block:: console
# 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.
.. code-block:: console
$ 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``.
.. code-block:: console
$ 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 <http://github.com/Azure/azure-cli-samples>`__.
Reporting issues and feedback
=======================================
If you encounter any bugs with the tool please file an issue in the `Issues <https://github.com/Azure/azure-cli/issues>`__ section of our GitHub repo.
To provide feedback from the command line, try the ``az feedback`` command.
License
=======
`MIT <https://github.com/Azure/azure-cli/blob/master/LICENSE.txt>`__
.. :changelog:
Release History
===============
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
azure-cli-0.1.2rc1.tar.gz
(6.5 kB
view details)
Built Distribution
File details
Details for the file azure-cli-0.1.2rc1.tar.gz.
File metadata
- Download URL: azure-cli-0.1.2rc1.tar.gz
- Upload date:
- Size: 6.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 694d4faea5a3b70400d903485d0759483c51e9b34f3a0f61f74b8893a2ad7217 |
|
| MD5 | 2da169e7a6003deabb2b5d2ba08697a3 |
|
| BLAKE2b-256 | b385e3cc3c9425b9036a2d99bd9a026ccd07c4a8ba365418384ec8cb46720204 |
File details
Details for the file azure_cli-0.1.2rc1-py2.py3-none-any.whl.
File metadata
- Download URL: azure_cli-0.1.2rc1-py2.py3-none-any.whl
- Upload date:
- Size: 9.3 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 08883cbe6afc071f7e1d176bd97ac5653985fea63e89cc25006aa05815e582b9 |
|
| MD5 | a1b0f1a8ad7b2b26f74777c5e6337c0f |
|
| BLAKE2b-256 | 34b79ef06a4261923e57c4799ae2cdcbde5294b9ca3fc1e6558dd302414f1a24 |
