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.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az extension list

List the installed extensions.

az extension list

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

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.

default value: False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

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.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

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.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az extension show

Show an extension.

az extension show --name

Examples

Show an extension. (autogenerated)

az extension show --name MyExtension

Required Parameters

--name -n

Name of extension.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

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.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.