az vm extension

命令

名称	说明	类型	Status
az vm extension delete	用于删除扩展的删除操作。	Core	GA
az vm extension image	查找订阅和区域的可用 VM 扩展。	Core	GA
az vm extension image list	列出有关可用扩展的信息。	Core	GA
az vm extension image list-names	列出可用扩展的名称。	Core	GA
az vm extension image list-versions	列出可用扩展的版本。	Core	GA
az vm extension image show	显示扩展的信息。	Core	GA
az vm extension list	列出附加到 VM 的扩展。	Core	GA
az vm extension set	设置 VM 的扩展。	Core	GA
az vm extension show	显示有关附加到 VM 的扩展的信息。	Core	GA
az vm extension wait	将 CLI 置于等待状态，直到满足条件。	Core	GA

az vm extension delete [--ids]
                       [--name --vm-extension-name]
                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                       [--resource-group]
                       [--subscription]
                       [--vm-name]

示例

使用 VM 名称和扩展从 VM 中删除扩展。

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

从 VM 中删除包含字符串“MyExtension”的 ID 的扩展。

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

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

属性	值
默认值:	False

az vm extension list [--ids]
                     [--resource-group]
                     [--subscription]
                     [--vm-name]

示例

列出命名 VM 的附加扩展。

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

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

属性	值
默认值:	False

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 VM。

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 指定的 VM（s）。

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

必需参数

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

属性	值
默认值:	False

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

示例

使用 VM 名称和扩展名称显示附加到 VM 的扩展。

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

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

属性	值
默认值:	False

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

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

属性	值
默认值:	False