Поделиться через


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:[email protected]: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 может потребоваться открыть оболочку от имени администратора, чтобы запустить с правильным разрешением.

--upgrade

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

--version

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

Default value: latest
--yes -y

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

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

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

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

--output -o

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

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: 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
Default value: 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

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

Default value: False
Глобальные параметры
--debug

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

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

--output -o

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

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: 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
Default value: 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
Default value: 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
Default value: 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:[email protected]: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
Default value: json
--query

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

--subscription

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

--verbose

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