你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

az vmss extension

管理 VM 规模集上的扩展。

命令

名称 说明 类型 Status
az vmss extension delete

从 VMSS 中删除扩展。

核心 GA
az vmss extension image

查找订阅和区域的可用 VM 扩展。

核心 GA
az vmss extension image list

列出有关可用扩展的信息。

核心 GA
az vmss extension image list-names

列出虚拟机扩展映像类型。

核心 GA
az vmss extension image list-versions

列出虚拟机扩展映像版本。

核心 GA
az vmss extension image show

获取虚拟机扩展映像。

核心 GA
az vmss extension list

列出与 VMSS 关联的扩展。

核心 GA
az vmss extension set

将扩展添加到 VMSS 或更新现有扩展。

核心 GA
az vmss extension show

显示 VMSS 扩展的详细信息。

核心 GA
az vmss extension upgrade

将所有 VMSS 实例的所有扩展升级到最新版本。

核心 GA

az vmss extension delete

从 VMSS 中删除扩展。

az vmss extension delete --name
                         --resource-group
                         --vmss-name
                         [--no-wait]

示例

从 VMSS 中删除扩展。 (自动生成)

az vmss extension delete --name MyExtension --resource-group MyResourceGroup --vmss-name MyVmss

必需参数

--name -n

扩展名。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--vmss-name

规模集名称。 可以使用 < a0/a0> 配置默认值 az configure --defaults vmss=<name>

可选参数

--no-wait

不等待长时间运行的操作完成。

默认值: False
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az vmss extension list

列出与 VMSS 关联的扩展。

az vmss extension list --resource-group
                       --vmss-name

示例

列出与 VMSS 关联的扩展。 (自动生成)

az vmss extension list --resource-group MyResourceGroup --vmss-name MyVmss

必需参数

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--vmss-name

规模集名称。 可以使用 < a0/a0> 配置默认值 az configure --defaults vmss=<name>

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az vmss extension set

将扩展添加到 VMSS 或更新现有扩展。

az vmss extension image list中获取扩展详细信息。

az vmss extension set --name
                      --publisher
                      --resource-group
                      --vmss-name
                      [--enable-auto-upgrade {false, true}]
                      [--extension-instance-name]
                      [--force-update]
                      [--no-auto-upgrade {false, true}]
                      [--no-auto-upgrade-minor-version {false, true}]
                      [--no-wait]
                      [--protected-settings]
                      [--provision-after-extensions]
                      [--settings]
                      [--version]

示例

设置依赖于前面设置的两个扩展的扩展。 也就是说,创建或重新映像 VMSS 实例时,只有在预配了它依赖的所有扩展之后,才会预配 customScript 扩展。 该扩展不需要依赖于其他扩展才能进行先决条件配置。

az vmss extension set --vmss-name my-vmss --name customScript --resource-group my-group \
    --version 2.0 --publisher Microsoft.Azure.Extensions \
    --provision-after-extensions NetworkWatcherAgentLinux VMAccessForLinux  \
    --settings '{"commandToExecute": "echo testing"}'

添加扩展并启用平台的自动升级(如果有较新版本的扩展可用)。

az vmss extension set -n extName --publisher publisher --vmss-name my-vmss -g my-group \ --enable-auto-upgrade true

必需参数

--name -n

扩展名。

值来源: az vm extension image list
--publisher

扩展发布者的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--vmss-name

规模集名称。 可以使用 < a0/a0> 配置默认值 az configure --defaults vmss=<name>

可选参数

--enable-auto-upgrade

指示如果有较新版本的扩展可用,平台应自动升级扩展。

接受的值: false, true
--extension-instance-name

可以自定义的扩展实例的名称。 默认值:扩展的名称。

--force-update

即使扩展配置未更改,也强制更新。

默认值: False
--no-auto-upgrade
已放弃

选项“--no-auto-upgrade”已弃用,将在将来的版本中删除。 请改用“--no-auto-upgrade-minor-version”。

如果设置,即使重新部署扩展,扩展服务也不会自动选取或升级到最新的次要版本。

接受的值: false, true
默认值: False
--no-auto-upgrade-minor-version

如果设置,即使重新部署扩展,扩展服务也不会自动选取或升级到最新的次要版本。

接受的值: false, true
默认值: False
--no-wait

不等待长时间运行的操作完成。

默认值: False
--protected-settings

用于敏感信息(如凭据)的 JSON 格式保护设置。 也接受 JSON 文件路径。

--provision-after-extensions

扩展名称的空格分隔列表,之后应预配此扩展。 必须在 VM 上设置这些扩展。

--settings

JSON 格式的扩展设置。 也接受 JSON 文件路径。

--version

扩展的版本。 若要将扩展版本固定到此值,请指定 --no-auto-upgrade-minor-version。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az vmss extension show

显示 VMSS 扩展的详细信息。

az vmss extension show --name
                       --resource-group
                       --vmss-name

示例

显示 VMSS 扩展的详细信息。 (自动生成)

az vmss extension show --name MyExtension --resource-group MyResourceGroup --vmss-name MyVmss

必需参数

--name -n

扩展名。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--vmss-name

规模集名称。 可以使用 < a0/a0> 配置默认值 az configure --defaults vmss=<name>

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az vmss extension upgrade

将所有 VMSS 实例的所有扩展升级到最新版本。

az vmss extension upgrade [--ids]
                          [--name]
                          [--no-wait]
                          [--resource-group]
                          [--subscription]

示例

将所有扩展升级到最新版本。

az vmss extension upgrade -g MyResourceGroup -n MyVmss

可选参数

--ids

一个或多个资源 ID(空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--name -n

规模集名称。 可以使用 < a0/a0> 配置默认值 az configure --defaults vmss=<name>

--no-wait

不等待长时间运行的操作完成。

默认值: False
--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。