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

az lab vm

  • 预览
  • 参考

命令组“lab”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

在 Azure 开发测试实验室中管理 VM。

命令

名称 说明 类型 状态
az lab vm apply-artifacts

将项目应用于 Azure 开发测试实验室中的虚拟机。

 核心 预览
az lab vm claim

从实验室中声明虚拟机。

 核心 预览
az lab vm create

在实验室中创建 VM。

 核心 预览
az lab vm delete

删除虚拟机。

 核心 预览
az lab vm list

列出 Azure 开发测试实验室中的 VM。

 核心 预览
az lab vm show

获取虚拟机。

 核心 预览版
az lab vm start

启动虚拟机。

 核心 预览
az lab vm stop

停止虚拟机此操作可能需要一段时间才能完成。

 核心 预览

az lab vm apply-artifacts

编辑
预览

命令组“lab”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

将项目应用于 Azure 开发测试实验室中的虚拟机。

az lab vm apply-artifacts --lab-name
                          --name
                          --resource-group
                          [--artifacts]

示例

将项目应用于 Azure 开发测试实验室中的虚拟机。 （自动生成）

az lab vm apply-artifacts --artifacts '@artifacts.json' --lab-name MyLab --name MyVirtualMachine --resource-group MyResourceGroup

必需参数

--lab-name

实验室的名称。

--name -n

虚拟机名称。

--resource-group -g

实验室资源组的名称。

可选参数

--artifacts

要应用的项目的 JSON 编码数组。 使用“@{file}”从文件加载。

全局参数
--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 lab vm claim

编辑
预览

命令组“lab”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

从实验室中声明虚拟机。

az lab vm claim [--ids]
                [--lab-name]
                [--name]
                [--resource-group]
                [--subscription]

示例

声明实验室中的任何可用虚拟机。

az lab vm claim -g {ResourceGroup} --lab-name {LabName}

在实验室中声明特定的虚拟机。

az lab vm claim -g {ResourceGroup} --lab-name {LabName} --name {VMName}

通过 ID 在实验室中声明多个虚拟机。

az lab vm claim --ids \
    /subscriptions/{SubID}/resourcegroups/{ResourceGroup}/providers/microsoft.devtestlab/labs/{LabName}/virtualmachines/{VMName1} \
    /subscriptions/{SubID}/resourcegroups/{ResourceGroup}/providers/microsoft.devtestlab/labs/{LabName}/virtualmachines/{VMName2}

可选参数

--ids

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

--lab-name

实验室的名称。

--name -n

要声明的虚拟机的名称。

--resource-group -g

实验室资源组的名称。

--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 lab vm create

编辑
预览

命令组“lab”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

在实验室中创建 VM。

az lab vm create --lab-name
                 --name
                 --resource-group
                 [--admin-password]
                 [--admin-username]
                 [--allow-claim]
                 [--artifacts]
                 [--authentication-type]
                 [--disk-type]
                 [--expiration-date]
                 [--formula]
                 [--generate-ssh-keys]
                 [--image]
                 [--image-type]
                 [--ip-configuration]
                 [--notes]
                 [--saved-secret]
                 [--size]
                 [--ssh-key]
                 [--subnet]
                 [--tags]
                 [--vnet-name]

示例

从库映像在实验室中创建 VM。

az lab vm create --lab-name {LabName} -g {ResourceGroup} --name {VMName} --image "Ubuntu Server 16.04 LTS" --image-type gallery --size Standard_DS1_v2

使用 SSH 身份验证在实验室中创建 VM。

az lab vm create --lab-name {LabName} -g {ResourceGroup} --name {VMName} --image "Ubuntu Server 16.04 LTS" --image-type gallery --size Standard_DS1_v2 --authentication-type ssh

使用密码身份验证在实验室中创建可认领 VM。

az lab vm create --lab-name {LabName} -g {ResourceGroup} --name {VMName} --image "Ubuntu Server 16.04 LTS" --image-type gallery --size Standard_DS1_v2 --allow-claim

使用密码身份验证在实验室中创建实验室中的 Windows VM。

az lab vm create --lab-name {LabName} -g {ResourceGroup} --name {VMName} --image "Windows Server 2008 R2 SP1" --image-type gallery --size Standard_DS1_v2

从自定义映像在实验室中创建 VM。

az lab vm create --lab-name {LabName} -g {ResourceGroup} --name {VMName} --image "jenkins_custom" --image-type custom --size Standard_DS1_v2

在实验室中创建具有公共 IP 的 VM。

az lab vm create --lab-name {LabName} -g {ResourceGroup} --name {VMName} --image "Ubuntu Server 16.04 LTS" --image-type gallery --size Standard_DS1_v2 --ip-configuration public

从公式创建 VM。

az lab vm create --lab-name {LabName} -g {ResourceGroup} --name {VMName} --formula MyFormula --artifacts '@artifacts.json'

必需参数

--lab-name

实验室的名称。

--name -n

虚拟机名称。

--resource-group -g

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

可选参数

--admin-password

VM 管理员的密码。

--admin-username

VM 管理员的用户名。

默认值: your_system_user_login_name
--allow-claim

指示是否应将 VM 创建为可认领的标志。

默认值: False
--artifacts

要应用的项目的 JSON 编码数组。 使用“@{file}”从文件加载。

--authentication-type

VM 允许的身份验证类型。 允许的值为：密码、ssh。

默认值: password
--disk-type

要用于虚拟机的存储类型。 允许的值为：高级版、Standard、StandardSSD。

--expiration-date

VM 的到期日期（yyyy-MM-ddTHH：mm：ss）。

--formula

公式的名称。 用于 az lab formula list 可用的公式。

与 az lab formula 标志一起使用 --export-artifacts 以导出和更新项目，然后通过 --artifacts 参数传递结果。

--generate-ssh-keys

生成 SSH 公钥和私钥文件（如果缺少）。

--image

操作系统映像的名称（库映像名称或自定义映像名称/ID）。

用于 az lab gallery-image list 可用的库映像或 az lab custom-image list 可用的自定义映像。

--image-type

图像的类型。 允许的值包括：库、自定义值。

--ip-configuration

要用于 VM 的 IP 配置类型。 允许的值为：共享值、公共值、专用值。

如果省略，将根据 VM 的 vnet 选择。

--notes

虚拟机的说明。

--saved-secret

要用于身份验证的已保存机密的名称。

提供此值后，它将用于代替其他身份验证方法。

--size

要创建的 VM 的大小。 请参阅 https://azure.microsoft.com/pricing/details/virtual-machines/ 大小信息。

--ssh-key

SSH 公钥或公钥文件路径。 用于 --generate-ssh-keys 生成 SSH 密钥。

--subnet

要向其添加 VM 的子网的名称。

--tags

采用空格分隔标记 key[=value] 的格式。

可以通过为标记分配空值“”来清除标记。

--vnet-name

要向其添加 VM 的虚拟网络的名称。

全局参数
--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 lab vm delete

编辑
预览

命令组“lab”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

删除虚拟机。

此操作可能需要一段时间才能完成。

az lab vm delete --lab-name
                 --name
                 --resource-group

必需参数

--lab-name

实验室的名称。

--name

虚拟机的名称。

--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 lab vm list

编辑
预览

命令组“lab”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

列出 Azure 开发测试实验室中的 VM。

az lab vm list --lab-name
               --resource-group
               [--all]
               [--claimable]
               [--environment]
               [--expand]
               [--filters]
               [--object-id]
               [--order-by]
               [--top]

示例

列出 Azure 开发测试实验室中的 VM。 （自动生成）

az lab vm list --lab-name MyLab --resource-group MyResourceGroup

必需参数

--lab-name

实验室的名称。

--resource-group -g

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

可选参数

--all

列出实验室中的所有虚拟机。 不能与 --filters 配合使用。

--claimable

仅列出实验室中可认领的虚拟机。 不能与 --filters 配合使用。

--environment

要在其中列出虚拟机的环境的名称或 ID。 不能与 --filters 配合使用。

--expand

展开查询。

--filters

要应用的筛选器。

--object-id

要列出其 VM 的所有者的对象 ID。

--order-by

使用 OData 表示法的结果的排序表达式。

--top

要返回的最大资源数。

全局参数
--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 lab vm show

编辑
预览

命令组“lab”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

获取虚拟机。

az lab vm show --lab-name
               --name
               --resource-group
               [--expand]

必需参数

--lab-name

实验室的名称。

--name

虚拟机的名称。

--resource-group -g

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

可选参数

--expand

指定$expand查询。 示例：“properties（$expand=artifacts，computeVm，networkInterface，applicableSchedule）”。

全局参数
--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 lab vm start

编辑
预览

命令组“lab”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

启动虚拟机。

此操作可能需要一段时间才能完成。

az lab vm start --lab-name
                --name
                --resource-group

必需参数

--lab-name

实验室的名称。

--name

虚拟机的名称。

--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 lab vm stop

编辑
预览

命令组“lab”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

停止虚拟机此操作可能需要一段时间才能完成。

az lab vm stop --lab-name
               --name
               --resource-group

必需参数

--lab-name

实验室的名称。

--name

虚拟机的名称。

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