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

az extension

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

Команды

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

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

 Core GA
az extension list

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

 Core GA
az extension list-available

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

 Core GA
az extension list-versions

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

 Core GA
az extension remove

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

 Core GA
az extension show

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

 Core GA
az extension update

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

 Core GA

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 репозитория) или локальному каталогу, размещенному в том же формате.

Свойство Значение
Группа параметров: Experimental Pip Arguments
--pip-proxy

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

Свойство Значение
Группа параметров: Experimental Pip Arguments
--source -s

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

--system

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

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

--upgrade

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

--version

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

Свойство Значение
Default value: latest
--yes -y

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

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

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

Свойство Значение
Default value: False
--help -h

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

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Свойство Значение
Default value: False

az extension list

Изменить

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

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

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

Свойство Значение
Default value: False
--help -h

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

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Свойство Значение
Default value: False

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

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

Свойство Значение
Default value: False
--help -h

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

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Свойство Значение
Default value: False

az extension list-versions

Изменить

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

az extension list-versions --name

Примеры

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

az extension list-versions --name anextension

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

--name -n

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

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

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

Свойство Значение
Default value: False
--help -h

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

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Свойство Значение
Default value: False

az extension remove

Изменить

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

az extension remove --name

Примеры

Удалите расширение. (autogenerated)

az extension remove --name MyExtension

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

--name -n

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

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

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

Свойство Значение
Default value: False
--help -h

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

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Свойство Значение
Default value: False

az extension show

Изменить

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

az extension show --name

Примеры

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

az extension show --name MyExtension

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

--name -n

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

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

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

Свойство Значение
Default value: False
--help -h

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

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Свойство Значение
Default value: False

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 репозитория) или локальному каталогу, размещенному в том же формате.

Свойство Значение
Группа параметров: Experimental Pip Arguments
--pip-proxy

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

Свойство Значение
Группа параметров: Experimental Pip Arguments
Глобальные параметры
--debug

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

Свойство Значение
Default value: False
--help -h

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

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Свойство Значение
Default value: False