az extension

Управление расширениями CLI и их обновление.

Команды

Имя Описание Тип Состояние
az extension add

Добавление расширения.

Основные сведения Общедоступная версия
az extension list

Список установленных расширений.

Основные сведения Общедоступная версия
az extension list-available

Вывод списка общедоступных расширений.

Основные сведения Общедоступная версия
az extension list-versions

Список доступных версий расширения.

Основные сведения Общедоступная версия
az extension remove

Удаление расширения.

Основные сведения Общедоступная версия
az extension show

Показать расширение.

Основные сведения Общедоступная версия
az extension update

Обновите расширение.

Основные сведения Общедоступная версия

az extension add

Добавление расширения.

Чтобы узнать об автоматической установке расширений, посетите сайт https://aka.ms/AzExtDynamicInstall.

az extension add [--allow-preview {false, true}]
                 [--name]
                 [--pip-extra-index-urls]
                 [--pip-proxy]
                 [--source]
                 [--system]
                 [--upgrade]
                 [--version]
                 [--yes]

Примеры

Добавление расширения по имени

az extension add --name anextension

Добавление расширения из URL-адреса

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

Добавление расширения с локального диска

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

Добавление расширения из локального диска и использование прокси-сервера pip для зависимостей

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

Добавление расширения в системный каталог

az extension add --name anextension --system

Добавление определенной версии расширения

az extension add --name anextension --version 1.0.0

Обновление расширения, если оно уже установлено

az extension add --upgrade --name anextension

Необязательные параметры

--allow-preview

Включите предварительные версии пакетов для установки расширений, если существует.

допустимые значения: false, true
--name -n

Имя расширения.

--pip-extra-index-urls

Разделенный пробелами список дополнительных URL-адресов используемых каталогов пакетов. Адрес должен указывать на репозиторий, совместимый со стандартом PEP 503 (простой API-интерфейс репозитория) или локальный каталог в таком же формате.

--pip-proxy

Прокси-сервер для pip, используемый для зависимостей расширений в виде [user:passwd@]proxy.server:port.

--source -s

Файловый путь или URL-адрес расширения.

--system

Используйте системный каталог для расширения.

Путь по умолчанию — это папка azure-cli-extensions под интерфейсом командной строки, на которой выполняется путь lib среды Python, который можно настроить с помощью переменной среды AZURE_EXTENSION_SYS_DIR. В Windows может потребоваться открыть оболочку как Администратор istrator, чтобы запустить с правильным разрешением.

--upgrade

Обновите расширение, если оно уже установлено, в противном случае просто установите расширение.

--version

Конкретная версия расширения.

значение по умолчанию: latest
--yes -y

Не запрашивать подтверждение.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az extension list

Список установленных расширений.

az extension list
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az extension list-available

Вывод списка общедоступных расширений.

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

Примеры

Вывод списка всех общедоступных расширений

az extension list-available

Перечисление сведений о конкретном расширении

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

Необязательные параметры

--show-details -d

Отображение необработанных данных из индекса расширения.

значение по умолчанию: False
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az extension list-versions

Список доступных версий расширения.

az extension list-versions --name

Примеры

Вывод списка доступных версий для расширения

az extension list-versions --name anextension

Обязательные параметры

--name -n

Имя расширения.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az extension remove

Удаление расширения.

az extension remove --name

Примеры

Удаление расширения. (автоматическое создание)

az extension remove --name MyExtension

Обязательные параметры

--name -n

Имя расширения.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az extension show

Показать расширение.

az extension show --name

Примеры

Показать расширение. (автоматическое создание)

az extension show --name MyExtension

Обязательные параметры

--name -n

Имя расширения.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az extension update

Обновите расширение.

az extension update --name
                    [--allow-preview {false, true}]
                    [--pip-extra-index-urls]
                    [--pip-proxy]

Примеры

Обновление расширения по имени

az extension update --name anextension

Обновление расширения по имени и использование прокси-сервера pip для зависимостей

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

Обязательные параметры

--name -n

Имя расширения.

Необязательные параметры

--allow-preview

Включите предварительные версии пакетов для установки расширений, если существует.

допустимые значения: false, true
--pip-extra-index-urls

Разделенный пробелами список дополнительных URL-адресов используемых каталогов пакетов. Адрес должен указывать на репозиторий, совместимый со стандартом PEP 503 (простой API-интерфейс репозитория) или локальный каталог в таком же формате.

--pip-proxy

Прокси-сервер для pip, используемый для зависимостей расширений в виде [user:passwd@]proxy.server:port.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.