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

Microsoft.ScVmm 虚拟机实例

Bicep 资源定义

可以使用目标操作部署 virtualMachineInstances 资源类型:

有关每个 API 版本中已更改属性的列表,请参阅 更改日志

资源格式

若要创建 Microsoft.ScVmm/virtualMachineInstances 资源,请将以下 Bicep 添加到模板中。

resource symbolicname 'Microsoft.ScVmm/virtualMachineInstances@2025-03-13' = {
  scope: resourceSymbolicName or scope
  extendedLocation: {
    name: 'string'
    type: 'string'
  }
  name: 'default'
  properties: {
    availabilitySets: [
      {
        id: 'string'
        name: 'string'
      }
    ]
    hardwareProfile: {
      cpuCount: int
      dynamicMemoryEnabled: 'string'
      dynamicMemoryMaxMB: int
      dynamicMemoryMinMB: int
      limitCpuForMigration: 'string'
      memoryMB: int
    }
    infrastructureProfile: {
      biosGuid: 'string'
      checkpointType: 'string'
      cloudId: 'string'
      generation: int
      inventoryItemId: 'string'
      templateId: 'string'
      uuid: 'string'
      vmmServerId: 'string'
      vmName: 'string'
    }
    networkProfile: {
      networkInterfaces: [
        {
          ipv4AddressType: 'string'
          ipv6AddressType: 'string'
          macAddress: 'string'
          macAddressType: 'string'
          name: 'string'
          nicId: 'string'
          virtualNetworkId: 'string'
        }
      ]
    }
    osProfile: {
      adminPassword: 'string'
      adminUsername: 'string'
      computerName: 'string'
      domainName: 'string'
      domainPassword: 'string'
      domainUsername: 'string'
      productKey: 'string'
      runOnceCommands: 'string'
      timezone: int
      workgroup: 'string'
    }
    storageProfile: {
      disks: [
        {
          bus: int
          busType: 'string'
          createDiffDisk: 'string'
          diskId: 'string'
          diskSizeGB: int
          lun: int
          name: 'string'
          storageQoSPolicy: {
            id: 'string'
            name: 'string'
          }
          templateDiskId: 'string'
          vhdType: 'string'
        }
      ]
    }
  }
}

属性值

Microsoft.ScVmm/virtualMachineInstances

名称 DESCRIPTION 价值
extendedLocation 获取或设置扩展位置。 ExtendedLocation (必需)
姓名 资源名称 “default”(必需)
属性 此资源的资源特定属性。 VirtualMachineInstanceProperties
范围 在与部署范围不同的范围内创建资源时使用。 将此属性设置为资源的符号名称,以应用 扩展资源

AvailabilitySetListItem (可用性集列表项)

名称 DESCRIPTION 价值
身份证 获取 microsoft.scvmm/availabilitySets 资源的 ARM ID。 字符串
姓名 获取或设置可用性集的名称。 字符串

扩展位置

名称 DESCRIPTION 价值
姓名 扩展位置名称。 字符串
类型 扩展位置类型。 字符串

硬件配置文件

名称 DESCRIPTION 价值
cpu计数 获取或设置 vm 的 vCPU 数。 整数 (int)
dynamicMemoryEnabled 已启用 获取或设置一个值,该值指示是否启用动态内存。 “false”
dynamicMemoryMaxMB 获取或设置 vm 的最大动态内存。 整数 (int)
dynamicMemoryMinMB 获取或设置 vm 的最小动态内存。 整数 (int)
limitCpuForMigration 获取或设置一个值,该值指示是否为 VM 的实时迁移启用处理器兼容性模式。 “false”
内存MB MemoryMB 是虚拟机内存的大小(以 MB 为单位)。 整数 (int)

InfrastructureProfile

名称 DESCRIPTION 价值
biosGuid 的 获取或设置 VM 的 BIOS GUID。 字符串
检查点类型 VM 支持的检查点类型。 字符串
云 ID 用于部署 VM 的云资源的 ARM ID。 字符串
获取或设置 VM 的生成。 整数 (int)
inventoryItemId 获取或设置资源的清单项 ID。 字符串
模板ID 用于部署 VM 的模板资源的 ARM ID。 字符串
UUID(通用唯一识别码) 虚拟机的唯一 ID。 字符串
vmmServerId 此资源所在的 vmmServer 资源的 ARM ID。 字符串
vm名称 VMName 是 SCVmm 服务器上 VM 的名称。 字符串

约束:
最小长度 = 1

网络接口

名称 DESCRIPTION 价值
ipv4AddressType 获取或设置 ipv4 地址类型。 “Dynamic”
“Static”
ipv6AddressType 获取或设置 ipv6 地址类型。 “Dynamic”
“Static”
mac地址 获取或设置 nic MAC 地址。 字符串
macAddressType 获取或设置 mac 地址类型。 “Dynamic”
“Static”
姓名 获取或设置网络接口的名称。 字符串
nicId 的 获取或设置 nic ID。 字符串
虚拟网络 ID 获取或设置用于连接 nic 的 Microsoft.ScVmm/virtualNetwork 资源的 ARM ID。 字符串

网络简介

名称 DESCRIPTION 价值
网络接口 获取或设置与虚拟机关联的网络接口的列表。 网络接口[]

OsProfileForVmInstance

名称 DESCRIPTION 价值
管理员密码 虚拟机的管理员密码。 字符串

约束:
敏感值。 以安全参数的形式传入。
管理员用户名 获取或设置 admin 用户名。 字符串
计算机名称 获取或设置计算机名称。 字符串
域名 获取或设置域名。 字符串
域密码 VM 必须加入的域的密码。 字符串

约束:
敏感值。 以安全参数的形式传入。
domainUsername 域名 获取或设置域用户名。 字符串
productKey 产品密钥 获取或设置产品密钥。输入格式 xxxxx-xxxxx-xxxxx-xxxxx-xxxxx 字符串

约束:
敏感值。 以安全参数的形式传入。
runOnce命令 Get 或设置命令在创建时运行一次,以分号分隔。 字符串
时区 获取或设置时区的 index 值。 整数 (int)
工作组 获取或设置工作组。 字符串

存储配置文件

名称 DESCRIPTION 价值
磁盘 获取或设置与虚拟机关联的虚拟磁盘的列表。 虚拟磁盘

StorageQosPolicyDetails

名称 DESCRIPTION 价值
身份证 QoS 策略的 ID。 字符串
姓名 策略的名称。 字符串

虚拟磁盘

名称 DESCRIPTION 价值
公交车 获取或设置磁盘总线。 整数 (int)
bus类型 获取或设置磁盘总线类型。 字符串
创建DiffDisk 获取或设置一个值,该值指示差异磁盘。 “false”
diskId 磁盘 ID 获取或设置磁盘 ID。 字符串
diskSizeGB 磁盘大小 获取或设置磁盘总大小。 整数 (int)
获取或设置磁盘 lun。 整数 (int)
姓名 获取或设置磁盘的名称。 字符串
存储QoSPolicy 磁盘的 QoS 策略。 StorageQosPolicyDetails
模板磁盘 ID 获取或设置模板中的磁盘 ID。 字符串
vhd类型 获取或设置磁盘 vhd 类型。 字符串

VirtualMachineInstanceProperties

名称 DESCRIPTION 价值
availabilitySets VM 中的可用性集。 AvailabilitySetListItem[]
hardwareProfile 硬件属性。 硬件配置文件
infrastructure简介 获取基础结构配置文件。 InfrastructureProfile
网络简介 网络属性。 网络简介
osProfile OS 属性。 OsProfileForVmInstance
storageProfile 存储属性。 存储配置文件

ARM 模板资源定义

可以使用目标操作部署 virtualMachineInstances 资源类型:

有关每个 API 版本中已更改属性的列表,请参阅 更改日志

资源格式

要创建 Microsoft.ScVmm/virtualMachineInstances 资源,请将以下 JSON 添加到您的模板中。

{
  "type": "Microsoft.ScVmm/virtualMachineInstances",
  "apiVersion": "2025-03-13",
  "name": "string",
  "extendedLocation": {
    "name": "string",
    "type": "string"
  },
  "properties": {
    "availabilitySets": [
      {
        "id": "string",
        "name": "string"
      }
    ],
    "hardwareProfile": {
      "cpuCount": "int",
      "dynamicMemoryEnabled": "string",
      "dynamicMemoryMaxMB": "int",
      "dynamicMemoryMinMB": "int",
      "limitCpuForMigration": "string",
      "memoryMB": "int"
    },
    "infrastructureProfile": {
      "biosGuid": "string",
      "checkpointType": "string",
      "cloudId": "string",
      "generation": "int",
      "inventoryItemId": "string",
      "templateId": "string",
      "uuid": "string",
      "vmmServerId": "string",
      "vmName": "string"
    },
    "networkProfile": {
      "networkInterfaces": [
        {
          "ipv4AddressType": "string",
          "ipv6AddressType": "string",
          "macAddress": "string",
          "macAddressType": "string",
          "name": "string",
          "nicId": "string",
          "virtualNetworkId": "string"
        }
      ]
    },
    "osProfile": {
      "adminPassword": "string",
      "adminUsername": "string",
      "computerName": "string",
      "domainName": "string",
      "domainPassword": "string",
      "domainUsername": "string",
      "productKey": "string",
      "runOnceCommands": "string",
      "timezone": "int",
      "workgroup": "string"
    },
    "storageProfile": {
      "disks": [
        {
          "bus": "int",
          "busType": "string",
          "createDiffDisk": "string",
          "diskId": "string",
          "diskSizeGB": "int",
          "lun": "int",
          "name": "string",
          "storageQoSPolicy": {
            "id": "string",
            "name": "string"
          },
          "templateDiskId": "string",
          "vhdType": "string"
        }
      ]
    }
  }
}

属性值

Microsoft.ScVmm/virtualMachineInstances

名称 DESCRIPTION 价值
apiVersion API 版本 '2025-03-13'
extendedLocation 获取或设置扩展位置。 ExtendedLocation (必需)
姓名 资源名称 “default”(必需)
属性 此资源的资源特定属性。 VirtualMachineInstanceProperties
类型 资源类型 “Microsoft.ScVmm/virtualMachineInstances”

AvailabilitySetListItem (可用性集列表项)

名称 DESCRIPTION 价值
身份证 获取 microsoft.scvmm/availabilitySets 资源的 ARM ID。 字符串
姓名 获取或设置可用性集的名称。 字符串

扩展位置

名称 DESCRIPTION 价值
姓名 扩展位置名称。 字符串
类型 扩展位置类型。 字符串

硬件配置文件

名称 DESCRIPTION 价值
cpu计数 获取或设置 vm 的 vCPU 数。 整数 (int)
dynamicMemoryEnabled 已启用 获取或设置一个值,该值指示是否启用动态内存。 “false”
dynamicMemoryMaxMB 获取或设置 vm 的最大动态内存。 整数 (int)
dynamicMemoryMinMB 获取或设置 vm 的最小动态内存。 整数 (int)
limitCpuForMigration 获取或设置一个值,该值指示是否为 VM 的实时迁移启用处理器兼容性模式。 “false”
内存MB MemoryMB 是虚拟机内存的大小(以 MB 为单位)。 整数 (int)

InfrastructureProfile

名称 DESCRIPTION 价值
biosGuid 的 获取或设置 VM 的 BIOS GUID。 字符串
检查点类型 VM 支持的检查点类型。 字符串
云 ID 用于部署 VM 的云资源的 ARM ID。 字符串
获取或设置 VM 的生成。 整数 (int)
inventoryItemId 获取或设置资源的清单项 ID。 字符串
模板ID 用于部署 VM 的模板资源的 ARM ID。 字符串
UUID(通用唯一识别码) 虚拟机的唯一 ID。 字符串
vmmServerId 此资源所在的 vmmServer 资源的 ARM ID。 字符串
vm名称 VMName 是 SCVmm 服务器上 VM 的名称。 字符串

约束:
最小长度 = 1

网络接口

名称 DESCRIPTION 价值
ipv4AddressType 获取或设置 ipv4 地址类型。 “Dynamic”
“Static”
ipv6AddressType 获取或设置 ipv6 地址类型。 “Dynamic”
“Static”
mac地址 获取或设置 nic MAC 地址。 字符串
macAddressType 获取或设置 mac 地址类型。 “Dynamic”
“Static”
姓名 获取或设置网络接口的名称。 字符串
nicId 的 获取或设置 nic ID。 字符串
虚拟网络 ID 获取或设置用于连接 nic 的 Microsoft.ScVmm/virtualNetwork 资源的 ARM ID。 字符串

网络简介

名称 DESCRIPTION 价值
网络接口 获取或设置与虚拟机关联的网络接口的列表。 网络接口[]

OsProfileForVmInstance

名称 DESCRIPTION 价值
管理员密码 虚拟机的管理员密码。 字符串

约束:
敏感值。 以安全参数的形式传入。
管理员用户名 获取或设置 admin 用户名。 字符串
计算机名称 获取或设置计算机名称。 字符串
域名 获取或设置域名。 字符串
域密码 VM 必须加入的域的密码。 字符串

约束:
敏感值。 以安全参数的形式传入。
domainUsername 域名 获取或设置域用户名。 字符串
productKey 产品密钥 获取或设置产品密钥。输入格式 xxxxx-xxxxx-xxxxx-xxxxx-xxxxx 字符串

约束:
敏感值。 以安全参数的形式传入。
runOnce命令 Get 或设置命令在创建时运行一次,以分号分隔。 字符串
时区 获取或设置时区的 index 值。 整数 (int)
工作组 获取或设置工作组。 字符串

存储配置文件

名称 DESCRIPTION 价值
磁盘 获取或设置与虚拟机关联的虚拟磁盘的列表。 虚拟磁盘

StorageQosPolicyDetails

名称 DESCRIPTION 价值
身份证 QoS 策略的 ID。 字符串
姓名 策略的名称。 字符串

虚拟磁盘

名称 DESCRIPTION 价值
公交车 获取或设置磁盘总线。 整数 (int)
bus类型 获取或设置磁盘总线类型。 字符串
创建DiffDisk 获取或设置一个值,该值指示差异磁盘。 “false”
diskId 磁盘 ID 获取或设置磁盘 ID。 字符串
diskSizeGB 磁盘大小 获取或设置磁盘总大小。 整数 (int)
获取或设置磁盘 lun。 整数 (int)
姓名 获取或设置磁盘的名称。 字符串
存储QoSPolicy 磁盘的 QoS 策略。 StorageQosPolicyDetails
模板磁盘 ID 获取或设置模板中的磁盘 ID。 字符串
vhd类型 获取或设置磁盘 vhd 类型。 字符串

VirtualMachineInstanceProperties

名称 DESCRIPTION 价值
availabilitySets VM 中的可用性集。 AvailabilitySetListItem[]
hardwareProfile 硬件属性。 硬件配置文件
infrastructure简介 获取基础结构配置文件。 InfrastructureProfile
网络简介 网络属性。 网络简介
osProfile OS 属性。 OsProfileForVmInstance
storageProfile 存储属性。 存储配置文件

用法示例

Terraform (AzAPI 提供程序)资源定义

可以使用目标操作部署 virtualMachineInstances 资源类型:

有关每个 API 版本中已更改属性的列表,请参阅 更改日志

资源格式

要创建 Microsoft.ScVmm/virtualMachineInstances 资源,请将以下 Terraform 添加到您的模板中。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ScVmm/virtualMachineInstances@2025-03-13"
  name = "string"
  parent_id = "string"
  body = {
    extendedLocation = {
      name = "string"
      type = "string"
    }
    properties = {
      availabilitySets = [
        {
          id = "string"
          name = "string"
        }
      ]
      hardwareProfile = {
        cpuCount = int
        dynamicMemoryEnabled = "string"
        dynamicMemoryMaxMB = int
        dynamicMemoryMinMB = int
        limitCpuForMigration = "string"
        memoryMB = int
      }
      infrastructureProfile = {
        biosGuid = "string"
        checkpointType = "string"
        cloudId = "string"
        generation = int
        inventoryItemId = "string"
        templateId = "string"
        uuid = "string"
        vmmServerId = "string"
        vmName = "string"
      }
      networkProfile = {
        networkInterfaces = [
          {
            ipv4AddressType = "string"
            ipv6AddressType = "string"
            macAddress = "string"
            macAddressType = "string"
            name = "string"
            nicId = "string"
            virtualNetworkId = "string"
          }
        ]
      }
      osProfile = {
        adminPassword = "string"
        adminUsername = "string"
        computerName = "string"
        domainName = "string"
        domainPassword = "string"
        domainUsername = "string"
        productKey = "string"
        runOnceCommands = "string"
        timezone = int
        workgroup = "string"
      }
      storageProfile = {
        disks = [
          {
            bus = int
            busType = "string"
            createDiffDisk = "string"
            diskId = "string"
            diskSizeGB = int
            lun = int
            name = "string"
            storageQoSPolicy = {
              id = "string"
              name = "string"
            }
            templateDiskId = "string"
            vhdType = "string"
          }
        ]
      }
    }
  }
}

属性值

Microsoft.ScVmm/virtualMachineInstances

名称 DESCRIPTION 价值
extendedLocation 获取或设置扩展位置。 ExtendedLocation (必需)
姓名 资源名称 “default”(必需)
parent_id 要向其应用此扩展资源的资源的 ID。 string (必需)
属性 此资源的资源特定属性。 VirtualMachineInstanceProperties
类型 资源类型 “Microsoft.ScVmm/virtualMachineInstances@2025-03-13”

AvailabilitySetListItem (可用性集列表项)

名称 DESCRIPTION 价值
身份证 获取 microsoft.scvmm/availabilitySets 资源的 ARM ID。 字符串
姓名 获取或设置可用性集的名称。 字符串

扩展位置

名称 DESCRIPTION 价值
姓名 扩展位置名称。 字符串
类型 扩展位置类型。 字符串

硬件配置文件

名称 DESCRIPTION 价值
cpu计数 获取或设置 vm 的 vCPU 数。 整数 (int)
dynamicMemoryEnabled 已启用 获取或设置一个值,该值指示是否启用动态内存。 “false”
dynamicMemoryMaxMB 获取或设置 vm 的最大动态内存。 整数 (int)
dynamicMemoryMinMB 获取或设置 vm 的最小动态内存。 整数 (int)
limitCpuForMigration 获取或设置一个值,该值指示是否为 VM 的实时迁移启用处理器兼容性模式。 “false”
内存MB MemoryMB 是虚拟机内存的大小(以 MB 为单位)。 整数 (int)

InfrastructureProfile

名称 DESCRIPTION 价值
biosGuid 的 获取或设置 VM 的 BIOS GUID。 字符串
检查点类型 VM 支持的检查点类型。 字符串
云 ID 用于部署 VM 的云资源的 ARM ID。 字符串
获取或设置 VM 的生成。 整数 (int)
inventoryItemId 获取或设置资源的清单项 ID。 字符串
模板ID 用于部署 VM 的模板资源的 ARM ID。 字符串
UUID(通用唯一识别码) 虚拟机的唯一 ID。 字符串
vmmServerId 此资源所在的 vmmServer 资源的 ARM ID。 字符串
vm名称 VMName 是 SCVmm 服务器上 VM 的名称。 字符串

约束:
最小长度 = 1

网络接口

名称 DESCRIPTION 价值
ipv4AddressType 获取或设置 ipv4 地址类型。 “Dynamic”
“Static”
ipv6AddressType 获取或设置 ipv6 地址类型。 “Dynamic”
“Static”
mac地址 获取或设置 nic MAC 地址。 字符串
macAddressType 获取或设置 mac 地址类型。 “Dynamic”
“Static”
姓名 获取或设置网络接口的名称。 字符串
nicId 的 获取或设置 nic ID。 字符串
虚拟网络 ID 获取或设置用于连接 nic 的 Microsoft.ScVmm/virtualNetwork 资源的 ARM ID。 字符串

网络简介

名称 DESCRIPTION 价值
网络接口 获取或设置与虚拟机关联的网络接口的列表。 网络接口[]

OsProfileForVmInstance

名称 DESCRIPTION 价值
管理员密码 虚拟机的管理员密码。 字符串

约束:
敏感值。 以安全参数的形式传入。
管理员用户名 获取或设置 admin 用户名。 字符串
计算机名称 获取或设置计算机名称。 字符串
域名 获取或设置域名。 字符串
域密码 VM 必须加入的域的密码。 字符串

约束:
敏感值。 以安全参数的形式传入。
domainUsername 域名 获取或设置域用户名。 字符串
productKey 产品密钥 获取或设置产品密钥。输入格式 xxxxx-xxxxx-xxxxx-xxxxx-xxxxx 字符串

约束:
敏感值。 以安全参数的形式传入。
runOnce命令 Get 或设置命令在创建时运行一次,以分号分隔。 字符串
时区 获取或设置时区的 index 值。 整数 (int)
工作组 获取或设置工作组。 字符串

存储配置文件

名称 DESCRIPTION 价值
磁盘 获取或设置与虚拟机关联的虚拟磁盘的列表。 虚拟磁盘

StorageQosPolicyDetails

名称 DESCRIPTION 价值
身份证 QoS 策略的 ID。 字符串
姓名 策略的名称。 字符串

虚拟磁盘

名称 DESCRIPTION 价值
公交车 获取或设置磁盘总线。 整数 (int)
bus类型 获取或设置磁盘总线类型。 字符串
创建DiffDisk 获取或设置一个值,该值指示差异磁盘。 “false”
diskId 磁盘 ID 获取或设置磁盘 ID。 字符串
diskSizeGB 磁盘大小 获取或设置磁盘总大小。 整数 (int)
获取或设置磁盘 lun。 整数 (int)
姓名 获取或设置磁盘的名称。 字符串
存储QoSPolicy 磁盘的 QoS 策略。 StorageQosPolicyDetails
模板磁盘 ID 获取或设置模板中的磁盘 ID。 字符串
vhd类型 获取或设置磁盘 vhd 类型。 字符串

VirtualMachineInstanceProperties

名称 DESCRIPTION 价值
availabilitySets VM 中的可用性集。 AvailabilitySetListItem[]
hardwareProfile 硬件属性。 硬件配置文件
infrastructure简介 获取基础结构配置文件。 InfrastructureProfile
网络简介 网络属性。 网络简介
osProfile OS 属性。 OsProfileForVmInstance
storageProfile 存储属性。 存储配置文件