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

az azurestackhci virtualmachine

注意

此参考是 Azure CLI（版本 2.15.0 或更高版本）的 azurestackhci 扩展的一部分。 该扩展将在首次运行 az azurestackhci virtualmachine 命令时自动安装。 详细了解扩展。

命令组“azurestackhci”是实验性的，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

使用 azurestackhci 管理 virtualmachine。

命令

名称	说明	类型	状态
az azurestackhci virtualmachine create	创建 VM。	扩展	实验
az azurestackhci virtualmachine delete	删除 VM。	分机	实验
az azurestackhci virtualmachine extension	使用 azurestackhci 管理 virtualmachine 扩展。	分机	实验
az azurestackhci virtualmachine extension create	创建 virtualmachine 扩展。	分机	实验
az azurestackhci virtualmachine extension delete	删除 virtualmachine 扩展。	分机	实验
az azurestackhci virtualmachine extension list	列出 virtualmachine 的所有扩展。	扩展	实验
az azurestackhci virtualmachine extension show	获取 virtualmachine 扩展的详细信息。	分机	实验
az azurestackhci virtualmachine extension update	更新 virtualmachine 扩展。	分机	实验
az azurestackhci virtualmachine extension wait	将 CLI 置于等待状态，直到满足 virtualmachine 扩展的条件。	分机	实验
az azurestackhci virtualmachine list	列出所有 VM。	扩展	实验
az azurestackhci virtualmachine restart	重启 VM。	分机	实验
az azurestackhci virtualmachine show	获取 VM 的详细信息。	扩展	实验
az azurestackhci virtualmachine start	启动已停止的 VM。	分机	实验
az azurestackhci virtualmachine stop	关闭（停止）正在运行的 VM。	分机	实验
az azurestackhci virtualmachine update	更新 VM。	扩展	实验
az azurestackhci virtualmachine vnic	使用 azurestackhci 管理虚拟机的 vNIC。	分机	实验
az azurestackhci virtualmachine vnic add	将现有 vNIC 添加到 VM。	分机	实验
az azurestackhci virtualmachine vnic remove	从 VM 中删除 vNIC。	扩展	实验

az azurestackhci virtualmachine create

实验

命令组“azurestackhci”是实验性的，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

创建 VM。

az azurestackhci virtualmachine create --name
                                       --resource-group
                                       [--admin-password]
                                       [--admin-username]
                                       [--allow-password-auth {false, true}]
                                       [--computer-name]
                                       [--data-disk]
                                       [--disable-vm-management {false, true}]
                                       [--enable-tpm]
                                       [--extended-location]
                                       [--hardware-profile]
                                       [--image-reference]
                                       [--linux-configuration]
                                       [--location]
                                       [--network-profile]
                                       [--nic-id]
                                       [--os-disk]
                                       [--os-profile]
                                       [--security-profile]
                                       [--ssh-public-keys]
                                       [--storage-profile]
                                       [--storagepath-id]
                                       [--tags]
                                       [--vm-size]
                                       [--windows-configuration]

示例

PutVirtualMachine

az azurestackhci virtualmachine create --resource-group "test-rg" --extended-location name="/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.ExtendedLocatio n/customLocations/dogfood-location" type="CustomLocation" --location "West US2" --hardware-profile vm-size="Default" --nic-id "test-nic" --computer-name "test-machine" --admin-username xxx --admin-password xxx --ssh-public-keys /path/to/public_key.pub --image-reference "test-gallery-image" --storagepath-id "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.AzureStackHCI/storagecontainers/test-storagepath" --name "test-vm" --allow-password-auth true --disable-vm-management true

必需参数

--name

虚拟机名称。

--resource-group -g

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

可选参数

--admin-password

管理员Password - 管理员istrator 密码。

--admin-username

管理员Username - 管理员istrator 用户名。

--allow-password-auth

为 Linux VM 启用密码身份验证。

是否为 Linux 虚拟机启用密码身份验证。

注意：此标志对 Windows 虚拟机没有影响。

接受的值: false, true

--computer-name

计算机的名称。

--data-disk

要附加到 VM 的数据磁盘 VHD 的名称。

--disable-vm-management

启用/禁用 VM 管理代理。 默认行为允许预配 VM ARC 代理。

接受的值: false, true

--enable-tpm

启用 tpm - 在 VM 的安全设置中启用 TPM。 如果未提供标志，则默认值为 False。

用法：--enable-tpm=XX。

默认值: False

--extended-location

用法：--extended-location type=XX name=XX

类型：扩展位置类型。 名称：扩展位置名称。

--hardware-profile

HardwareProfile - 指定虚拟机的硬件设置。

使用情况：--hardware-profile vm-size=XX processors=XX memory-mb=XX maximum-memory-mb=XX minimum-memory-mb=XX target-memory-buffer=XX

处理器：虚拟机内存的处理器数-mb：虚拟机最大内存内存 MB 的 RAM（以 mb 为单位）：最大动态内存（以 mb 最小内存-mb 为单位）：最小动态内存（以 mb 为目标内存缓冲区：目标内存缓冲区）。

--image-reference

ImageReference - VM 应用于预配的库映像名称。

--linux-configuration

LinuxConfiguration - 指定虚拟机的安全设置。

--location -l

Location。 az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

--network-profile

NetworkProfile - 描述虚拟机的网络配置。

--nic-id

NicID - 要附加到虚拟机的网络接口 ID。

--os-disk

用于预配 VM 的 VHD 的 ID。

--os-profile

OsProfile - 描述操作系统的配置并设置登录数据预期值：json-string/@json-file。

--security-profile

SecurityProfile - 指定虚拟机的安全设置。

用法：--security-profile secure-boot-enabled=XX。

--ssh-public-keys

SSH 公钥的路径。

--storage-profile

存储Profile - 包含有关虚拟机预期值的磁盘和存储信息的信息：json-string/@json-file。

--storagepath-id

指向 VM 配置文件存储位置的存储路径的 Azure ID。

--tags

空格分隔标记：key[=value] [key[=value] ...]。使用“”清除现有标记。

--vm-size

VMSize - 库存要使用的 VM 硬件配置。

--windows-configuration

WindowsConfiguration - 虚拟机的 Windows 配置。

全局参数

--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 azurestackhci virtualmachine delete

实验

命令组“azurestackhci”是实验性的，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

删除 VM。

az azurestackhci virtualmachine delete [--ids]
                                       [--name]
                                       [--resource-group]
                                       [--subscription]
                                       [--yes]

示例

DeleteVirtualMachine

az azurestackhci virtualmachine delete --resource-group "test-rg" --name "test-vm"

可选参数

--ids

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

--name

虚拟机名称。

--resource-group -g

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

--subscription

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

--yes -y

不提示确认。

默认值: 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 azurestackhci virtualmachine list

实验

命令组“azurestackhci”是实验性的，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

列出所有 VM。

az azurestackhci virtualmachine list [--resource-group]

示例

ListVirtualMachineByResourceGroup

az azurestackhci virtualmachine list --resource-group "test-rg"

ListVirtualMachineBySubscription

az azurestackhci virtualmachine list

可选参数

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<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 azurestackhci virtualmachine restart

实验

命令组“azurestackhci”是实验性的，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

重启 VM。

az azurestackhci virtualmachine restart [--ids]
                                        [--name]
                                        [--resource-group]
                                        [--subscription]

示例

RestartVirtualMachine

az azurestackhci virtualmachine restart --resource-group "test-rg" --name "test-vm"

可选参数

--ids

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

--name

虚拟机名称。

--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 获取完整的调试日志。

az azurestackhci virtualmachine show

实验

命令组“azurestackhci”是实验性的，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

获取 VM 的详细信息。

az azurestackhci virtualmachine show [--ids]
                                     [--name]
                                     [--resource-group]
                                     [--subscription]

示例

GetVirtualMachine

az azurestackhci virtualmachine show --resource-group "test-rg" --name "test-vm"

可选参数

--ids

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

--name

虚拟机名称。

--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 获取完整的调试日志。

az azurestackhci virtualmachine start

实验

命令组“azurestackhci”是实验性的，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

启动已停止的 VM。

az azurestackhci virtualmachine start [--ids]
                                      [--name]
                                      [--resource-group]
                                      [--subscription]

示例

StartVirtualMachine

az azurestackhci virtualmachine start --resource-group "test-rg" --name "test-vm"

可选参数

--ids

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

--name

虚拟机名称。

--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 获取完整的调试日志。

az azurestackhci virtualmachine stop

实验

命令组“azurestackhci”是实验性的，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

关闭（停止）正在运行的 VM。

az azurestackhci virtualmachine stop [--ids]
                                     [--name]
                                     [--resource-group]
                                     [--subscription]

示例

StopVirtualMachine

az azurestackhci virtualmachine stop --resource-group "test-rg" --name "test-vm"

可选参数

--ids

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

--name

虚拟机名称。

--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 获取完整的调试日志。

az azurestackhci virtualmachine update

实验

命令组“azurestackhci”是实验性的，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

更新 VM。

az azurestackhci virtualmachine update [--cpu-count]
                                       [--ids]
                                       [--memory-mb]
                                       [--name]
                                       [--resource-group]
                                       [--subscription]
                                       [--tags]
                                       [--vhd-names]
                                       [--vnic-names]

示例

UpdateVirtualMachine

az azurestackhci virtualmachine update --resource-group "test-rg" --tags additionalProperties="sample" --name "test-vm" --cpu-count XX --memory-mb XX --vhd-names vhd1 vhd2 --vnic-names vnic1 vnic2

可选参数

--cpu-count

处理器数。

--ids

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

--memory-mb

RAM 量（以 mb 为单位）。

--name

虚拟机名称。

--resource-group -g

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

--subscription

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

--tags

空格分隔标记：key[=value] [key[=value] ...]。使用“”清除现有标记。

--vhd-names

vhd 名称列表。

--vnic-names

vnic 名称列表。

全局参数

--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 获取完整的调试日志。