Share via

Microsoft.ConnectedVMwarevSphere virtualMachineInstances 2023-12-01

  • Article
Choose a deployment language

Bicep resource definition

The virtualMachineInstances resource type can be deployed with operations that target:

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.ConnectedVMwarevSphere/virtualMachineInstances resource, add the following Bicep to your template.

Bicep 
resource symbolicname 'Microsoft.ConnectedVMwarevSphere/virtualMachineInstances@2023-12-01' = {
  scope: resourceSymbolicName or scope
  extendedLocation: {
    name: 'string'
    type: 'string'
  }
  name: 'default'
  properties: {
    hardwareProfile: {
      memorySizeMB: int
      numCoresPerSocket: int
      numCPUs: int
    }
    infrastructureProfile: {
      firmwareType: 'string'
      inventoryItemId: 'string'
      smbiosUuid: 'string'
      templateId: 'string'
      vCenterId: 'string'
    }
    networkProfile: {
      networkInterfaces: [
        {
          deviceKey: int
          ipSettings: {
            allocationMethod: 'string'
            dnsServers: [
              'string'
            ]
            gateway: [
              'string'
            ]
            ipAddress: 'string'
            subnetMask: 'string'
          }
          name: 'string'
          networkId: 'string'
          nicType: 'string'
          powerOnBoot: 'string'
        }
      ]
    }
    osProfile: {
      adminPassword: 'string'
      adminUsername: 'string'
      computerName: 'string'
      guestId: 'string'
      osType: 'string'
      windowsConfiguration: {
        autoLogon: bool
        autoLogonCount: int
        domainName: 'string'
        domainUsername: 'string'
        domainUserPassword: 'string'
        firstLogonCommands: [
          'string'
        ]
        fullName: 'string'
        orgName: 'string'
        productId: 'string'
        timeZone: 'string'
        workGroupName: 'string'
      }
    }
    placementProfile: {
      clusterId: 'string'
      datastoreId: 'string'
      hostId: 'string'
      resourcePoolId: 'string'
    }
    securityProfile: {
      uefiSettings: {
        secureBootEnabled: bool
      }
    }
    storageProfile: {
      disks: [
        {
          controllerKey: int
          deviceKey: int
          deviceName: 'string'
          diskMode: 'string'
          diskSizeGB: int
          diskType: 'string'
          name: 'string'
          unitNumber: int
        }
      ]
    }
  }
}

Property Values

ExtendedLocation

Name Description Value
name The extended location name. string
type The extended location type. string

HardwareProfile

Name Description Value
memorySizeMB Gets or sets memory size in MBs for the vm. int
numCoresPerSocket Gets or sets the number of cores per socket for the vm. Defaults to 1 if unspecified. int
numCPUs Gets or sets the number of vCPUs for the vm. int

InfrastructureProfile

Name Description Value
firmwareType Firmware type 'bios'
'efi'
inventoryItemId Gets or sets the inventory Item ID for the virtual machine. string
smbiosUuid Gets or sets the SMBIOS UUID of the vm. string
templateId Gets or sets the ARM Id of the template resource to deploy the virtual machine. string
vCenterId Gets or sets the ARM Id of the vCenter resource in which this resource pool resides. string

Microsoft.ConnectedVMwarevSphere/virtualMachineInstances

Name Description Value
extendedLocation Gets or sets the extended location. ExtendedLocation
name The resource name 'default' (required)
properties Resource properties. VirtualMachineInstanceProperties (required)
scope Use when creating a resource at a scope that is different than the deployment scope. Set this property to the symbolic name of a resource to apply the extension resource.

NetworkInterface

Name Description Value
deviceKey Gets or sets the device key value. int
ipSettings Gets or sets the ipsettings. NicIPSettings
name Gets or sets the name of the network interface. string
networkId Gets or sets the ARM Id of the network resource to connect the virtual machine. string
nicType NIC type 'e1000'
'e1000e'
'pcnet32'
'vmxnet'
'vmxnet2'
'vmxnet3'
powerOnBoot Gets or sets the power on boot. 'disabled'
'enabled'

NetworkProfile

Name Description Value
networkInterfaces Gets or sets the list of network interfaces associated with the virtual machine. NetworkInterface[]

NicIPSettings

Name Description Value
allocationMethod Gets or sets the nic allocation method. 'dynamic'
'linklayer'
'other'
'random'
'static'
'unset'
dnsServers Gets or sets the dns servers. string[]
gateway Gets or sets the gateway. string[]
ipAddress Gets or sets the ip address for the nic. string
subnetMask Gets or sets the mask. string

OsProfileForVMInstance

Name Description Value
adminPassword Sets administrator password. string

Constraints:
Sensitive value. Pass in as a secure parameter.
adminUsername Gets or sets administrator username. string
computerName Gets or sets computer name. string
guestId Gets or sets the guestId. string
osType Gets or sets the type of the os. 'Linux'
'Other'
'Windows'
windowsConfiguration Windows Configuration. WindowsConfiguration

PlacementProfile

Name Description Value
clusterId Gets or sets the ARM Id of the cluster resource on which this virtual machine will deploy. string
datastoreId Gets or sets the ARM Id of the datastore resource on which the data for the virtual machine will be kept. string
hostId Gets or sets the ARM Id of the host resource on which this virtual machine will deploy. string
resourcePoolId Gets or sets the ARM Id of the resourcePool resource on which this virtual machine will deploy. string

SecurityProfile

Name Description Value
uefiSettings Specifies the security settings like secure boot used while creating the virtual machine. UefiSettings

StorageProfile

Name Description Value
disks Gets or sets the list of virtual disks associated with the virtual machine. VirtualDisk[]

UefiSettings

Name Description Value
secureBootEnabled Specifies whether secure boot should be enabled on the virtual machine. bool

VirtualDisk

Name Description Value
controllerKey Gets or sets the controller id. int
deviceKey Gets or sets the device key value. int
deviceName Gets or sets the device name. string
diskMode Gets or sets the disk mode. 'independent_nonpersistent'
'independent_persistent'
'persistent'
diskSizeGB Gets or sets the disk total size. int
diskType Gets or sets the disk backing type. 'flat'
'pmem'
'rawphysical'
'rawvirtual'
'sesparse'
'sparse'
'unknown'
name Gets or sets the name of the virtual disk. string
unitNumber Gets or sets the unit number of the disk on the controller. int

VirtualMachineInstanceProperties

Name Description Value
hardwareProfile Hardware properties. HardwareProfile
infrastructureProfile Gets the infrastructure profile. InfrastructureProfile
networkProfile Network properties. NetworkProfile
osProfile OS properties. OsProfileForVMInstance
placementProfile Placement properties. PlacementProfile
securityProfile Gets the security profile. SecurityProfile
storageProfile Storage properties. StorageProfile

WindowsConfiguration

Name Description Value
autoLogon Sets a value indicating whether auto logon is enabled. bool
autoLogonCount Sets auto logon count. int
domainName Sets domain name that vm should join. string
domainUsername Sets domain username. string
domainUserPassword Sets domain user password. string

Constraints:
Sensitive value. Pass in as a secure parameter.
firstLogonCommands Sets first logon commands string[]
fullName Sets full name of the owner of the vm. string
orgName Sets org name to which the owner of the vm belongs. string
productId Sets product id of the vm. string
timeZone Specifies the time zone of the virtual machine. e.g. "Pacific Standard Time". Time zone name correspond to time zones listed at Microsoft Time Zone name values(/previous-versions/windows/embedded/ms912391(v=winembedded.11)). string
workGroupName Sets work group name that vm should join. string

ARM template resource definition

The virtualMachineInstances resource type can be deployed with operations that target:

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.ConnectedVMwarevSphere/virtualMachineInstances resource, add the following JSON to your template.

JSON 
{
  "type": "Microsoft.ConnectedVMwarevSphere/virtualMachineInstances",
  "apiVersion": "2023-12-01",
  "name": "string",
  "extendedLocation": {
    "name": "string",
    "type": "string"
  },
  "properties": {
    "hardwareProfile": {
      "memorySizeMB": "int",
      "numCoresPerSocket": "int",
      "numCPUs": "int"
    },
    "infrastructureProfile": {
      "firmwareType": "string",
      "inventoryItemId": "string",
      "smbiosUuid": "string",
      "templateId": "string",
      "vCenterId": "string"
    },
    "networkProfile": {
      "networkInterfaces": [
        {
          "deviceKey": "int",
          "ipSettings": {
            "allocationMethod": "string",
            "dnsServers": [ "string" ],
            "gateway": [ "string" ],
            "ipAddress": "string",
            "subnetMask": "string"
          },
          "name": "string",
          "networkId": "string",
          "nicType": "string",
          "powerOnBoot": "string"
        }
      ]
    },
    "osProfile": {
      "adminPassword": "string",
      "adminUsername": "string",
      "computerName": "string",
      "guestId": "string",
      "osType": "string",
      "windowsConfiguration": {
        "autoLogon": "bool",
        "autoLogonCount": "int",
        "domainName": "string",
        "domainUsername": "string",
        "domainUserPassword": "string",
        "firstLogonCommands": [ "string" ],
        "fullName": "string",
        "orgName": "string",
        "productId": "string",
        "timeZone": "string",
        "workGroupName": "string"
      }
    },
    "placementProfile": {
      "clusterId": "string",
      "datastoreId": "string",
      "hostId": "string",
      "resourcePoolId": "string"
    },
    "securityProfile": {
      "uefiSettings": {
        "secureBootEnabled": "bool"
      }
    },
    "storageProfile": {
      "disks": [
        {
          "controllerKey": "int",
          "deviceKey": "int",
          "deviceName": "string",
          "diskMode": "string",
          "diskSizeGB": "int",
          "diskType": "string",
          "name": "string",
          "unitNumber": "int"
        }
      ]
    }
  }
}

Property Values

ExtendedLocation

Name Description Value
name The extended location name. string
type The extended location type. string

HardwareProfile

Name Description Value
memorySizeMB Gets or sets memory size in MBs for the vm. int
numCoresPerSocket Gets or sets the number of cores per socket for the vm. Defaults to 1 if unspecified. int
numCPUs Gets or sets the number of vCPUs for the vm. int

InfrastructureProfile

Name Description Value
firmwareType Firmware type 'bios'
'efi'
inventoryItemId Gets or sets the inventory Item ID for the virtual machine. string
smbiosUuid Gets or sets the SMBIOS UUID of the vm. string
templateId Gets or sets the ARM Id of the template resource to deploy the virtual machine. string
vCenterId Gets or sets the ARM Id of the vCenter resource in which this resource pool resides. string

Microsoft.ConnectedVMwarevSphere/virtualMachineInstances

Name Description Value
apiVersion The api version '2023-12-01'
extendedLocation Gets or sets the extended location. ExtendedLocation
name The resource name 'default' (required)
properties Resource properties. VirtualMachineInstanceProperties (required)
type The resource type 'Microsoft.ConnectedVMwarevSphere/virtualMachineInstances'

NetworkInterface

Name Description Value
deviceKey Gets or sets the device key value. int
ipSettings Gets or sets the ipsettings. NicIPSettings
name Gets or sets the name of the network interface. string
networkId Gets or sets the ARM Id of the network resource to connect the virtual machine. string
nicType NIC type 'e1000'
'e1000e'
'pcnet32'
'vmxnet'
'vmxnet2'
'vmxnet3'
powerOnBoot Gets or sets the power on boot. 'disabled'
'enabled'

NetworkProfile

Name Description Value
networkInterfaces Gets or sets the list of network interfaces associated with the virtual machine. NetworkInterface[]

NicIPSettings

Name Description Value
allocationMethod Gets or sets the nic allocation method. 'dynamic'
'linklayer'
'other'
'random'
'static'
'unset'
dnsServers Gets or sets the dns servers. string[]
gateway Gets or sets the gateway. string[]
ipAddress Gets or sets the ip address for the nic. string
subnetMask Gets or sets the mask. string

OsProfileForVMInstance

Name Description Value
adminPassword Sets administrator password. string

Constraints:
Sensitive value. Pass in as a secure parameter.
adminUsername Gets or sets administrator username. string
computerName Gets or sets computer name. string
guestId Gets or sets the guestId. string
osType Gets or sets the type of the os. 'Linux'
'Other'
'Windows'
windowsConfiguration Windows Configuration. WindowsConfiguration

PlacementProfile

Name Description Value
clusterId Gets or sets the ARM Id of the cluster resource on which this virtual machine will deploy. string
datastoreId Gets or sets the ARM Id of the datastore resource on which the data for the virtual machine will be kept. string
hostId Gets or sets the ARM Id of the host resource on which this virtual machine will deploy. string
resourcePoolId Gets or sets the ARM Id of the resourcePool resource on which this virtual machine will deploy. string

SecurityProfile

Name Description Value
uefiSettings Specifies the security settings like secure boot used while creating the virtual machine. UefiSettings

StorageProfile

Name Description Value
disks Gets or sets the list of virtual disks associated with the virtual machine. VirtualDisk[]

UefiSettings

Name Description Value
secureBootEnabled Specifies whether secure boot should be enabled on the virtual machine. bool

VirtualDisk

Name Description Value
controllerKey Gets or sets the controller id. int
deviceKey Gets or sets the device key value. int
deviceName Gets or sets the device name. string
diskMode Gets or sets the disk mode. 'independent_nonpersistent'
'independent_persistent'
'persistent'
diskSizeGB Gets or sets the disk total size. int
diskType Gets or sets the disk backing type. 'flat'
'pmem'
'rawphysical'
'rawvirtual'
'sesparse'
'sparse'
'unknown'
name Gets or sets the name of the virtual disk. string
unitNumber Gets or sets the unit number of the disk on the controller. int

VirtualMachineInstanceProperties

Name Description Value
hardwareProfile Hardware properties. HardwareProfile
infrastructureProfile Gets the infrastructure profile. InfrastructureProfile
networkProfile Network properties. NetworkProfile
osProfile OS properties. OsProfileForVMInstance
placementProfile Placement properties. PlacementProfile
securityProfile Gets the security profile. SecurityProfile
storageProfile Storage properties. StorageProfile

WindowsConfiguration

Name Description Value
autoLogon Sets a value indicating whether auto logon is enabled. bool
autoLogonCount Sets auto logon count. int
domainName Sets domain name that vm should join. string
domainUsername Sets domain username. string
domainUserPassword Sets domain user password. string

Constraints:
Sensitive value. Pass in as a secure parameter.
firstLogonCommands Sets first logon commands string[]
fullName Sets full name of the owner of the vm. string
orgName Sets org name to which the owner of the vm belongs. string
productId Sets product id of the vm. string
timeZone Specifies the time zone of the virtual machine. e.g. "Pacific Standard Time". Time zone name correspond to time zones listed at Microsoft Time Zone name values(/previous-versions/windows/embedded/ms912391(v=winembedded.11)). string
workGroupName Sets work group name that vm should join. string

Usage Examples

Terraform (AzAPI provider) resource definition

The virtualMachineInstances resource type can be deployed with operations that target:

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.ConnectedVMwarevSphere/virtualMachineInstances resource, add the following Terraform to your template.

Terraform 
resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ConnectedVMwarevSphere/virtualMachineInstances@2023-12-01"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    extendedLocation = {
      name = "string"
      type = "string"
    }
    properties = {
      hardwareProfile = {
        memorySizeMB = int
        numCoresPerSocket = int
        numCPUs = int
      }
      infrastructureProfile = {
        firmwareType = "string"
        inventoryItemId = "string"
        smbiosUuid = "string"
        templateId = "string"
        vCenterId = "string"
      }
      networkProfile = {
        networkInterfaces = [
          {
            deviceKey = int
            ipSettings = {
              allocationMethod = "string"
              dnsServers = [
                "string"
              ]
              gateway = [
                "string"
              ]
              ipAddress = "string"
              subnetMask = "string"
            }
            name = "string"
            networkId = "string"
            nicType = "string"
            powerOnBoot = "string"
          }
        ]
      }
      osProfile = {
        adminPassword = "string"
        adminUsername = "string"
        computerName = "string"
        guestId = "string"
        osType = "string"
        windowsConfiguration = {
          autoLogon = bool
          autoLogonCount = int
          domainName = "string"
          domainUsername = "string"
          domainUserPassword = "string"
          firstLogonCommands = [
            "string"
          ]
          fullName = "string"
          orgName = "string"
          productId = "string"
          timeZone = "string"
          workGroupName = "string"
        }
      }
      placementProfile = {
        clusterId = "string"
        datastoreId = "string"
        hostId = "string"
        resourcePoolId = "string"
      }
      securityProfile = {
        uefiSettings = {
          secureBootEnabled = bool
        }
      }
      storageProfile = {
        disks = [
          {
            controllerKey = int
            deviceKey = int
            deviceName = "string"
            diskMode = "string"
            diskSizeGB = int
            diskType = "string"
            name = "string"
            unitNumber = int
          }
        ]
      }
    }
  })
}

Property Values

ExtendedLocation

Name Description Value
name The extended location name. string
type The extended location type. string

HardwareProfile

Name Description Value
memorySizeMB Gets or sets memory size in MBs for the vm. int
numCoresPerSocket Gets or sets the number of cores per socket for the vm. Defaults to 1 if unspecified. int
numCPUs Gets or sets the number of vCPUs for the vm. int

InfrastructureProfile

Name Description Value
firmwareType Firmware type 'bios'
'efi'
inventoryItemId Gets or sets the inventory Item ID for the virtual machine. string
smbiosUuid Gets or sets the SMBIOS UUID of the vm. string
templateId Gets or sets the ARM Id of the template resource to deploy the virtual machine. string
vCenterId Gets or sets the ARM Id of the vCenter resource in which this resource pool resides. string

Microsoft.ConnectedVMwarevSphere/virtualMachineInstances

Name Description Value
extendedLocation Gets or sets the extended location. ExtendedLocation
name The resource name 'default' (required)
parent_id The ID of the resource to apply this extension resource to. string (required)
properties Resource properties. VirtualMachineInstanceProperties (required)
type The resource type "Microsoft.ConnectedVMwarevSphere/virtualMachineInstances@2023-12-01"

NetworkInterface

Name Description Value
deviceKey Gets or sets the device key value. int
ipSettings Gets or sets the ipsettings. NicIPSettings
name Gets or sets the name of the network interface. string
networkId Gets or sets the ARM Id of the network resource to connect the virtual machine. string
nicType NIC type 'e1000'
'e1000e'
'pcnet32'
'vmxnet'
'vmxnet2'
'vmxnet3'
powerOnBoot Gets or sets the power on boot. 'disabled'
'enabled'

NetworkProfile

Name Description Value
networkInterfaces Gets or sets the list of network interfaces associated with the virtual machine. NetworkInterface[]

NicIPSettings

Name Description Value
allocationMethod Gets or sets the nic allocation method. 'dynamic'
'linklayer'
'other'
'random'
'static'
'unset'
dnsServers Gets or sets the dns servers. string[]
gateway Gets or sets the gateway. string[]
ipAddress Gets or sets the ip address for the nic. string
subnetMask Gets or sets the mask. string

OsProfileForVMInstance

Name Description Value
adminPassword Sets administrator password. string

Constraints:
Sensitive value. Pass in as a secure parameter.
adminUsername Gets or sets administrator username. string
computerName Gets or sets computer name. string
guestId Gets or sets the guestId. string
osType Gets or sets the type of the os. 'Linux'
'Other'
'Windows'
windowsConfiguration Windows Configuration. WindowsConfiguration

PlacementProfile

Name Description Value
clusterId Gets or sets the ARM Id of the cluster resource on which this virtual machine will deploy. string
datastoreId Gets or sets the ARM Id of the datastore resource on which the data for the virtual machine will be kept. string
hostId Gets or sets the ARM Id of the host resource on which this virtual machine will deploy. string
resourcePoolId Gets or sets the ARM Id of the resourcePool resource on which this virtual machine will deploy. string

SecurityProfile

Name Description Value
uefiSettings Specifies the security settings like secure boot used while creating the virtual machine. UefiSettings

StorageProfile

Name Description Value
disks Gets or sets the list of virtual disks associated with the virtual machine. VirtualDisk[]

UefiSettings

Name Description Value
secureBootEnabled Specifies whether secure boot should be enabled on the virtual machine. bool

VirtualDisk

Name Description Value
controllerKey Gets or sets the controller id. int
deviceKey Gets or sets the device key value. int
deviceName Gets or sets the device name. string
diskMode Gets or sets the disk mode. 'independent_nonpersistent'
'independent_persistent'
'persistent'
diskSizeGB Gets or sets the disk total size. int
diskType Gets or sets the disk backing type. 'flat'
'pmem'
'rawphysical'
'rawvirtual'
'sesparse'
'sparse'
'unknown'
name Gets or sets the name of the virtual disk. string
unitNumber Gets or sets the unit number of the disk on the controller. int

VirtualMachineInstanceProperties

Name Description Value
hardwareProfile Hardware properties. HardwareProfile
infrastructureProfile Gets the infrastructure profile. InfrastructureProfile
networkProfile Network properties. NetworkProfile
osProfile OS properties. OsProfileForVMInstance
placementProfile Placement properties. PlacementProfile
securityProfile Gets the security profile. SecurityProfile
storageProfile Storage properties. StorageProfile

WindowsConfiguration

Name Description Value
autoLogon Sets a value indicating whether auto logon is enabled. bool
autoLogonCount Sets auto logon count. int
domainName Sets domain name that vm should join. string
domainUsername Sets domain username. string
domainUserPassword Sets domain user password. string

Constraints:
Sensitive value. Pass in as a secure parameter.
firstLogonCommands Sets first logon commands string[]
fullName Sets full name of the owner of the vm. string
orgName Sets org name to which the owner of the vm belongs. string
productId Sets product id of the vm. string
timeZone Specifies the time zone of the virtual machine. e.g. "Pacific Standard Time". Time zone name correspond to time zones listed at Microsoft Time Zone name values(/previous-versions/windows/embedded/ms912391(v=winembedded.11)). string
workGroupName Sets work group name that vm should join. string