az extension

Manage and update CLI extensions.

Commands

az extension add

Add an extension.

az extension list

List the installed extensions.

az extension list-available

List publicly available extensions.

az extension list-versions

List available versions for an extension.

az extension remove

Remove an extension.

az extension show

Show an extension.

az extension update

Update an extension.

az extension add

Add an extension.

To learn about installing extensions automatically, visit https://aka.ms/AzExtDynamicInstall.

az extension add [--name]
                 [--pip-extra-index-urls]
                 [--pip-proxy]
                 [--source]
                 [--system]
                 [--upgrade]
                 [--version]
                 [--yes]

Examples

Add extension by name

az extension add --name anextension

Add extension from URL

az extension add --source https://contoso.com/anextension-0.0.1-py2.py3-none-any.whl

Add extension from local disk

az extension add --source ~/anextension-0.0.1-py2.py3-none-any.whl

Add extension from local disk and use pip proxy for dependencies

az extension add --source ~/anextension-0.0.1-py2.py3-none-any.whl --pip-proxy https://user:pass@proxy.server:8080

Add extension to system directory

az extension add --name anextension --system

Add a specific version of extension

az extension add --name anextension --version 1.0.0

Upgrade the extension if already installed

az extension add --upgrade --name anextension

Optional Parameters

--name -n

Name of extension.

--pip-extra-index-urls

Space-separated list of extra URLs of package indexes to use. This should point to a repository compliant with PEP 503 (the simple repository API) or a local directory laid out in the same format.

--pip-proxy

Proxy for pip to use for extension dependencies in the form of [user:passwd@]proxy.server:port.

--source -s

Filepath or URL to an extension.

--system

Use a system directory for the extension.

--upgrade

Update the extension if already installed, otherwise just install the extension.

--version

The specific version of an extension.

default value: latest
--yes -y

Do not prompt for confirmation.

az extension list

List the installed extensions.

az extension list [--query-examples]

Optional Parameters

--query-examples

Recommend JMESPath string for you. You can copy one of the query and paste it after --query parameter within double quotation marks to see the results. You can add one or more positional keywords so that we can give suggestions based on these key words.

az extension list-available

List publicly available extensions.

az extension list-available [--show-details]

Examples

List all publicly available extensions

az extension list-available

List details on a particular extension

az extension list-available --show-details --query anextension

Optional Parameters

--show-details -d

Show the raw data from the extension index.

az extension list-versions

List available versions for an extension.

az extension list-versions --name

Examples

List available versions for an extension

az extension list-versions --name anextension

Required Parameters

--name -n

Name of extension.

az extension remove

Remove an extension.

az extension remove --name

Examples

Remove an extension. (autogenerated)

az extension remove --name MyExtension

Required Parameters

--name -n

Name of extension.

az extension show

Show an extension.

az extension show --name
                  [--query-examples]

Examples

Show an extension. (autogenerated)

az extension show --name MyExtension

Required Parameters

--name -n

Name of extension.

Optional Parameters

--query-examples

Recommend JMESPath string for you. You can copy one of the query and paste it after --query parameter within double quotation marks to see the results. You can add one or more positional keywords so that we can give suggestions based on these key words.

az extension update

Update an extension.

az extension update --name
                    [--pip-extra-index-urls]
                    [--pip-proxy]

Examples

Update an extension by name

az extension update --name anextension

Update an extension by name and use pip proxy for dependencies

az extension update --name anextension --pip-proxy https://user:pass@proxy.server:8080

Required Parameters

--name -n

Name of extension.

Optional Parameters

--pip-extra-index-urls

Space-separated list of extra URLs of package indexes to use. This should point to a repository compliant with PEP 503 (the simple repository API) or a local directory laid out in the same format.

--pip-proxy

Proxy for pip to use for extension dependencies in the form of [user:passwd@]proxy.server:port.