az vm extension

Управление расширениями на виртуальных машинах.

Расширения — это небольшие приложения, которые предоставляют задачи настройки и автоматизации, выполняемые после развертывания на виртуальных машинах Azure. Например, если на виртуальной машине нужно установить программное обеспечение, настроить антивирусную защиту или конфигурацию Docker, это можно сделать с помощью расширения виртуальной машины (далее — расширение ВМ). Расширения можно использовать при развертывании новой виртуальной машины или запускать на любой из существующих систем.

Команды

az vm extension delete

Удаление расширения, подключенного к виртуальной машине.

az vm extension image

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

az vm extension image list

Перечислите сведения о доступных расширениях.

az vm extension image list-names

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

az vm extension image list-versions

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

az vm extension image show

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

az vm extension list

Список расширений, подключенных к виртуальной машине.

az vm extension set

Задание расширений для виртуальной машины.

az vm extension show

Отображение сведений о расширениях, подключенных к виртуальной машине.

az vm extension wait

Разместите интерфейс командной строки в состоянии ожидания, пока не будет выполнено условие расширения виртуальной машины.

az vm extension delete

Удаление расширения, подключенного к виртуальной машине.

az vm extension delete [--ids]
                       [--name]
                       [--no-wait]
                       [--resource-group]
                       [--subscription]
                       [--vm-name]

Примеры

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

az vm extension delete -g MyResourceGroup --vm-name MyVm -n extension_name

Удаление расширений с идентификаторами, содержащими строку "Мекстенсион", из виртуальной машины.

az vm extension delete --ids \
    $(az resource list --query "[?contains(name, 'MyExtension')].id" -o tsv)

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

--ids

Один или несколько идентификаторов ресурсов (с разделителями-пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения об аргументах "Resource id". Необходимо указать идентификаторы или другие аргументы "Resource id".

--name -n

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

--no-wait

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

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--subscription

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

--vm-name

Имя виртуальной машины. Можно настроить по умолчанию с помощью az configure --defaults vm=<name> .

az vm extension list

Список расширений, подключенных к виртуальной машине.

az vm extension list --resource-group
                     --vm-name
                     [--query-examples]
                     [--subscription]

Примеры

Перечисление подключенных расширений в именованную виртуальную машину.

az vm extension list -g MyResourceGroup --vm-name MyVm

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

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--vm-name

Имя виртуальной машины. Можно настроить по умолчанию с помощью az configure --defaults vm=<name> .

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

--query-examples

Рекомендуемая строка JMESPath. Можно скопировать один из запросов и вставить его после параметра--query в двойных кавычках, чтобы увидеть результаты. Можно добавить одно или несколько позиций ключевых слов, чтобы мы могли предоставлять предложения на основе этих ключевых слов.

--subscription

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

az vm extension set

Задание расширений для виртуальной машины.

Получение сведений о расширении из az vm extension image list .

az vm extension set --name
                    --publisher
                    [--enable-auto-upgrade {false, true}]
                    [--extension-instance-name]
                    [--force-update]
                    [--ids]
                    [--no-auto-upgrade {false, true}]
                    [--no-auto-upgrade-minor-version {false, true}]
                    [--no-wait]
                    [--protected-settings]
                    [--resource-group]
                    [--settings]
                    [--subscription]
                    [--version]
                    [--vm-name]

Примеры

Добавьте учетную запись пользователя на виртуальную машину Linux.

az vm extension set -n VMAccessForLinux --publisher Microsoft.OSTCExtensions --version 1.4 \
    --vm-name MyVm --resource-group MyResourceGroup \
    --protected-settings '{"username":"user1", "ssh_key":"ssh_rsa ..."}'

Добавьте расширение customScript для виртуальных машин, заданных параметром--IDS.

az vm extension set -n customScript --publisher Microsoft.Azure.Extensions --ids {vm_id}

Добавьте расширение и включите автоматическое обновление платформы, если доступна более новая версия расширения.

az vm extension set -n extName --publisher publisher --vm-name MyVM -g MyResourceGroup \
--enable-auto-upgrade true

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

--name -n

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

значение из: az vm extension image list
--publisher

Имя издателя расширения.

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

--enable-auto-upgrade

Указывает, что расширение должно автоматически обновляться платформой, если доступна более новая версия расширения.

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

Имя экземпляра расширения, которое можно настроить. По умолчанию: имя расширения.

--force-update

Принудительно обновить, даже если конфигурация расширения не изменилась.

--ids

Один или несколько идентификаторов ресурсов (с разделителями-пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения об аргументах "Resource id". Необходимо указать идентификаторы или другие аргументы "Resource id".

--no-auto-upgrade

Если этот параметр задан, служба расширений не будет автоматически выбирать или обновлять ее до последней дополнительной версии, даже если расширение развернуто повторно.

допустимые значения: false, true
--no-auto-upgrade-minor-version

Если этот параметр задан, служба расширений не будет автоматически выбирать или обновлять ее до последней дополнительной версии, даже если расширение развернуто повторно.

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

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

--protected-settings

Защищенные параметры в формате JSON для конфиденциальной информации, такой как учетные данные. Также принимается путь к файлу JSON.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--settings

Параметры расширения в формате JSON. Также принимается путь к файлу JSON.

--subscription

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

--version

Версия расширения. Чтобы закрепить это значение в версии расширения, укажите параметр--No-Auto-Upgrade-Minor-Version.

--vm-name

Имя виртуальной машины. Можно настроить по умолчанию с помощью az configure --defaults vm=<name> .

az vm extension show

Отображение сведений о расширениях, подключенных к виртуальной машине.

az vm extension show [--expand]
                     [--ids]
                     [--name]
                     [--query-examples]
                     [--resource-group]
                     [--subscription]
                     [--vm-name]

Примеры

Используйте имя виртуальной машины и имя расширения, чтобы отобразить расширения, подключенные к виртуальной машине.

az vm extension show -g MyResourceGroup --vm-name MyVm -n extension_name

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

--expand

Выражение развертывания, применяемое к операции.

--ids

Один или несколько идентификаторов ресурсов (с разделителями-пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения об аргументах "Resource id". Необходимо указать идентификаторы или другие аргументы "Resource id".

--name -n

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

--query-examples

Рекомендуемая строка JMESPath. Можно скопировать один из запросов и вставить его после параметра--query в двойных кавычках, чтобы увидеть результаты. Можно добавить одно или несколько позиций ключевых слов, чтобы мы могли предоставлять предложения на основе этих ключевых слов.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--subscription

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

--vm-name

Имя виртуальной машины. Можно настроить по умолчанию с помощью az configure --defaults vm=<name> .

az vm extension wait

Разместите интерфейс командной строки в состоянии ожидания, пока не будет выполнено условие расширения виртуальной машины.

az vm extension wait [--created]
                     [--custom]
                     [--deleted]
                     [--exists]
                     [--expand]
                     [--ids]
                     [--interval]
                     [--name]
                     [--resource-group]
                     [--subscription]
                     [--timeout]
                     [--updated]
                     [--vm-name]

Примеры

Разместите интерфейс командной строки в состоянии ожидания, пока не будет выполнено условие расширения виртуальной машины. автоматически сформированный

az vm extension wait --created --name MyExtension --resource-group MyResourceGroup --vm-name MyVm

Разместите интерфейс командной строки в состоянии ожидания, пока не будет выполнено условие расширения виртуальной машины. автоматически сформированный

az vm extension wait --exists --name MyExtension --resource-group MyResourceGroup --vm-name MyVm

Разместите интерфейс командной строки в состоянии ожидания, пока не будет выполнено условие расширения виртуальной машины. автоматически сформированный

az vm extension wait --ids @- --name MyExtension --subscription MySubscription --updated --vm-name MyVm

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

--created

Дождитесь создания "provisioningState" в "выполнено".

--custom

Дождитесь, пока условие не будет удовлетворять пользовательскому запросу JMESPath. Пример: provisioningState! = ' Progress ', instanceView. statuss [? code = = ' PowerState/выполняется '].

--deleted

Дождитесь удаления.

--exists

Дождитесь существования ресурса.

--expand

Выражение развертывания, применяемое к операции.

--ids

Один или несколько идентификаторов ресурсов (с разделителями-пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения об аргументах "Resource id". Необходимо указать идентификаторы или другие аргументы "Resource id".

--interval

Интервал опроса в секундах.

значение по умолчанию: 30
--name -n

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

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--subscription

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

--timeout

Максимальное время ожидания в секундах.

значение по умолчанию: 3600
--updated

Дождитесь обновления с provisioningState в "выполнено".

--vm-name

Имя виртуальной машины. Можно настроить по умолчанию с помощью az configure --defaults vm=<name> .