Microsoft.ConnectedVMwarevSphere virtualMachineInstances 2023-12-01
Bicep resource definition
The virtualMachineInstances resource type is an extension resource, which means you can apply it to another resource.
Use the scope
property on this resource to set the scope for this resource. See Set scope on extension resources in Bicep.
The virtualMachineInstances resource type can be deployed with operations that target:
- Resource groups - See resource group deployment commands
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.
resource symbolicname 'Microsoft.ConnectedVMwarevSphere/virtualMachineInstances@2023-12-01' = {
name: 'default'
scope: resourceSymbolicName
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
virtualMachineInstances
Name | Description | Value |
---|---|---|
name | The resource name | 'default' |
scope | Use when creating an extension resource at a scope that is different than the deployment scope. | Target resource For Bicep, set this property to the symbolic name of the resource to apply the extension resource. |
extendedLocation | Gets or sets the extended location. | ExtendedLocation |
properties | Resource properties. | VirtualMachineInstanceProperties (required) |
ExtendedLocation
Name | Description | Value |
---|---|---|
name | The extended location name. | string |
type | The extended location type. | string |
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 |
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 |
NetworkProfile
Name | Description | Value |
---|---|---|
networkInterfaces | Gets or sets the list of network interfaces associated with the virtual machine. | NetworkInterface[] |
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' |
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 |
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 |
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 |
UefiSettings
Name | Description | Value |
---|---|---|
secureBootEnabled | Specifies whether secure boot should be enabled on the virtual machine. | bool |
StorageProfile
Name | Description | Value |
---|---|---|
disks | Gets or sets the list of virtual disks associated with the virtual machine. | VirtualDisk[] |
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 |
ARM template resource definition
The virtualMachineInstances resource type is an extension resource, which means you can apply it to another resource.
Use the scope
property on this resource to set the scope for this resource. See Set scope on extension resources in ARM templates.
The virtualMachineInstances resource type can be deployed with operations that target:
- Resource groups - See resource group deployment commands
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.
{
"type": "Microsoft.ConnectedVMwarevSphere/virtualMachineInstances",
"apiVersion": "2023-12-01",
"name": "default",
"scope": "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
virtualMachineInstances
Name | Description | Value |
---|---|---|
type | The resource type | 'Microsoft.ConnectedVMwarevSphere/virtualMachineInstances' |
apiVersion | The resource api version | '2023-12-01' |
name | The resource name | 'default' |
scope | Use when creating an extension resource at a scope that is different than the deployment scope. | Target resource For JSON, set the value to the full name of the resource to apply the extension resource to. |
extendedLocation | Gets or sets the extended location. | ExtendedLocation |
properties | Resource properties. | VirtualMachineInstanceProperties (required) |
ExtendedLocation
Name | Description | Value |
---|---|---|
name | The extended location name. | string |
type | The extended location type. | string |
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 |
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 |
NetworkProfile
Name | Description | Value |
---|---|---|
networkInterfaces | Gets or sets the list of network interfaces associated with the virtual machine. | NetworkInterface[] |
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' |
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 |
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 |
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 |
UefiSettings
Name | Description | Value |
---|---|---|
secureBootEnabled | Specifies whether secure boot should be enabled on the virtual machine. | bool |
StorageProfile
Name | Description | Value |
---|---|---|
disks | Gets or sets the list of virtual disks associated with the virtual machine. | VirtualDisk[] |
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 |
Terraform (AzAPI provider) resource definition
The virtualMachineInstances resource type is an extension resource, which means you can apply it to another resource.
Use the parent_id
property on this resource to set the scope for this resource.
The virtualMachineInstances resource type can be deployed with operations that target:
- Resource groups
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.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ConnectedVMwarevSphere/virtualMachineInstances@2023-12-01"
name = "default"
parent_id = "string"
body = jsonencode({
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
}
]
}
}
extendedLocation = {
name = "string"
type = "string"
}
})
}
Property values
virtualMachineInstances
Name | Description | Value |
---|---|---|
type | The resource type | "Microsoft.ConnectedVMwarevSphere/virtualMachineInstances@2023-12-01" |
name | The resource name | "default" |
parent_id | The ID of the resource to apply this extension resource to. | string (required) |
extendedLocation | Gets or sets the extended location. | ExtendedLocation |
properties | Resource properties. | VirtualMachineInstanceProperties (required) |
ExtendedLocation
Name | Description | Value |
---|---|---|
name | The extended location name. | string |
type | The extended location type. | string |
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 |
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 |
NetworkProfile
Name | Description | Value |
---|---|---|
networkInterfaces | Gets or sets the list of network interfaces associated with the virtual machine. | NetworkInterface[] |
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" |
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 |
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 |
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 |
UefiSettings
Name | Description | Value |
---|---|---|
secureBootEnabled | Specifies whether secure boot should be enabled on the virtual machine. | bool |
StorageProfile
Name | Description | Value |
---|---|---|
disks | Gets or sets the list of virtual disks associated with the virtual machine. | VirtualDisk[] |
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 |