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

az scvmm vm extension

  • Ссылка

Примечание.

Эта ссылка является частью расширения scvmm для Azure CLI (версия 2.15.0 или более поздней). Расширение автоматически установит команду расширения виртуальной машины az scvmm при первом запуске. Подробнее о расширениях.

Управление расширением виртуальной машины с помощью scvmm.

Команды

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

Операция создания расширения.

 Расширение Общедоступная версия
az scvmm vm extension delete

Операция удаления расширения.

 Расширение Общедоступная версия
az scvmm vm extension list

Операция получения всех расширений виртуальной машины, отличной от Azure.

 Расширение Общедоступная версия
az scvmm vm extension show

Операция получения расширения.

 Расширение Общедоступная версия
az scvmm vm extension update

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

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

az scvmm vm extension create

Операция создания расширения.

az scvmm vm extension create --location
                             --name
                             --resource-group
                             --vm-name
                             [--auto-upgrade-minor {false, true}]
                             [--enable-auto-upgrade {false, true}]
                             [--force-update-tag]
                             [--no-wait]
                             [--protected-settings]
                             [--publisher]
                             [--settings]
                             [--tags]
                             [--type]
                             [--type-handler-version]

Примеры

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

az scvmm vm extension create --name contoso-extension --location eastus2euap --type CustomScriptExtension --publisher Microsoft.Compute --settings "{\"commandToExecute\":\"powershell.exe -c \\\"Get-Process | Where-Object { $_.CPU -gt 10000 }\\\"\"}" --type-handler-version 1.10 --vm-name contoso-vm --resource-group contoso-rg

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

--location -l

Location. Значения из az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>.

--name

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

--resource-group -g

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

--vm-name

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

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

--auto-upgrade-minor

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

Допустимые значения: false, true
--enable-auto-upgrade

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

Допустимые значения: false, true
--force-update-tag

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

--no-wait

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

Default value: False
--protected-settings

Расширение может содержать защищенные Параметры или защищенные Параметры FromKeyVault или не защищенные параметры. Ожидаемое значение: json-string/json-file/@json-file.

--publisher

Имя издателя обработчика расширений.

--settings

Форматированные общедоступные параметры json для расширения. Ожидаемое значение: json-string/json-file/@json-file.

--tags

Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.

--type

Укажите тип расширения; примером является CustomScriptExtension.

--type-handler-version

Указывает версию обработчика скрипта.

Глобальные параметры
--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 scvmm vm extension delete

Операция удаления расширения.

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

Примеры

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

az scvmm vm extension delete --name contoso-extension --vm-name contoso-vm --resource-group contoso-rg

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

--ids

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

--name

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

--no-wait

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

Default value: False
--resource-group -g

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

--subscription

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

--vm-name

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

--yes -y

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

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 scvmm vm extension list

Операция получения всех расширений виртуальной машины, отличной от Azure.

az scvmm vm extension list --resource-group
                           --vm-name
                           [--expand]

Примеры

Получение всех расширений виртуальных машин

az scvmm vm extension list --vm-name contoso-vm --resource-group contoso-rg

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

--resource-group -g

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

--vm-name

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

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

--expand

Выражение расширения, применяемое к операции.

Глобальные параметры
--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 scvmm vm extension show

Операция получения расширения.

az scvmm vm extension show [--ids]
                           [--name]
                           [--resource-group]
                           [--subscription]
                           [--vm-name]

Примеры

Получение расширения виртуальной машины

az scvmm vm extension show --name contoso-extension --vm-name contoso-vm --resource-group contoso-rg

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

--ids

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

--name

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

--resource-group -g

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

--subscription

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

--vm-name

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

Глобальные параметры
--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 scvmm vm extension update

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

az scvmm vm extension update --name
                             --resource-group
                             --vm-name
                             [--auto-upgrade-minor {false, true}]
                             [--enable-auto-upgrade {false, true}]
                             [--force-update-tag]
                             [--no-wait]
                             [--protected-settings]
                             [--publisher]
                             [--settings]
                             [--tags]
                             [--type]
                             [--type-handler-version]

Примеры

Обновление расширения виртуальной машины

az scvmm vm extension update --name contoso-extension --type CustomScriptExtension --publisher Microsoft.Compute --settings "{\"commandToExecute\":\"powershell.exe -c \\\"Get-Process | Where-Object { $_.CPU -lt 100 }\\\"\"}" --type-handler-version 1.10 --vm-name contoso-vm --resource-group contoso-rg

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

--name

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

--resource-group -g

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

--vm-name

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

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

--auto-upgrade-minor

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

Допустимые значения: false, true
--enable-auto-upgrade

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

Допустимые значения: false, true
--force-update-tag

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

--no-wait

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

Default value: False
--protected-settings

Расширение может содержать защищенные Параметры или защищенные Параметры FromKeyVault или не защищенные параметры. Ожидаемое значение: json-string/json-file/@json-file.

--publisher

Имя издателя обработчика расширений.

--settings

Форматированные общедоступные параметры json для расширения. Ожидаемое значение: json-string/json-file/@json-file.

--tags

Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.

--type

Укажите тип расширения; примером является CustomScriptExtension.

--type-handler-version

Указывает версию обработчика скрипта.

Глобальные параметры
--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.