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

az vmss extension

管理 VM 规模集上的扩展。

命令

az vmss extension delete

从 VMSS 中删除扩展。

az vmss extension image

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

az vmss extension image list

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

az vmss extension image list-names

获取虚拟机扩展映像类型的列表。

az vmss extension image list-versions

获取虚拟机扩展映像版本的列表。

az vmss extension image show

获取虚拟机扩展映像。

az vmss extension list

列出与 VMSS 关联的扩展。

az vmss extension set

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

az vmss extension show

显示 VMSS 扩展的详细信息。

az vmss extension upgrade

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

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

规模集名称。 You can configure the default using az configure --defaults vmss=<name>.

可选参数

--no-wait

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

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

规模集名称。 You can configure the default using az configure --defaults vmss=<name>.

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

规模集名称。 You can configure the default using az configure --defaults 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

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

--provision-after-extensions

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

--settings

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

--version

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

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

规模集名称。 You can configure the default using az configure --defaults vmss=<name>.

az vmss extension upgrade

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

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

示例

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

az vmss extension upgrade -g MyResourceGroup -n MyVmss

可选参数

--ids

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

--name -n

规模集名称。 You can configure the default using az configure --defaults vmss=<name>.

--no-wait

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

--resource-group -g

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