Share via


az extension

Manage and update CLI extensions.

Commands

Name Description Type Status
az extension add

Add an extension.

Core GA
az extension list

List the installed extensions.

Core GA
az extension list-available

List publicly available extensions.

Core GA
az extension list-versions

List available versions for an extension.

Core GA
az extension remove

Remove an extension.

Core GA
az extension show

Show an extension.

Core GA
az extension update

Update an extension.

Core GA

az extension add

Add an extension.

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

az extension add [--allow-preview {false, true}]
                 [--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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--allow-preview

Include preview packages for extension installation, if exists.

Property Value
Accepted values: false, true
--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.

Property Value
Parameter group: Experimental Pip Arguments
--pip-proxy

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

Property Value
Parameter group: Experimental Pip Arguments
--source -s

Filepath or URL to an extension.

--system

Use a system directory for the extension.

Default path is azure-cli-extensions folder under the CLI running python environment lib path, configurable by environment variable AZURE_EXTENSION_SYS_DIR. On Windows, you may need to open your shell as Administrator to run with the right permission.

--upgrade

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

--version

The specific version of an extension.

Property Value
Default value: latest
--yes -y

Do not prompt for confirmation.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Property Value
Default value: False

az extension list

List the installed extensions.

az extension list
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Property Value
Default value: False

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--show-details -d

Show the raw data from the extension index.

Property Value
Default value: False
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Property Value
Default value: False

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.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Property Value
Default value: False

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.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Property Value
Default value: False

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.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Property Value
Default value: False

az extension update

Update an extension.

az extension update --name
                    [--allow-preview {false, true}]
                    [--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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--allow-preview

Include preview packages for extension installation, if exists.

Property Value
Accepted values: false, true
--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.

Property Value
Parameter group: Experimental Pip Arguments
--pip-proxy

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

Property Value
Parameter group: Experimental Pip Arguments
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Property Value
Default value: False