Skip to main content

azVirtualMachine

+++ title = "azVirtualMachine" description = "Azure Virtual Machine" weight = 10 alwaysopen = false +++

Use the resource azVirtualMachine to deploy an Azure Virtual Machine.

Attributes

AttributeTypeMandatoryValuesDefaultNotes
NameStringYes
ResourceGroupNameStringYes
LocationStringYes
AdminUsernameStringYes
AdminPasswordObjectYes
OSDiskNameStringNoDefault: disk-vmname-os
OSDiskSizeInGBNumberYes
ZoneArray
PublisherNameStringYes
OfferStringYes
SkuStringYes
VersionStringNo
SizeStringYes
LicenseTypeStringNoNone (D), Windows_ServerNone
StorageAccountNameString
EnableRemotePSBooleanNoFalse
DisableWindowsUpdateBooleanNoFalse
AvailabilitySetNameStringNo
DisableWindowsUpdateBooleanNo
NetworkInterfaceListNo
IdentityObjectNo
DiskObjectNo
ExtensionObjectNo
TagObjectNo
LockObjectNo

Disk

Please supply a disk object as a list for the virtual machine.

AttributeTypeMandatoryValuesDefaultNotes
NameStringYes
NTFSBlockSizeNumberYes
LetterStringYes
LabelStringYes
LUNNumberYes
CachingStringNoNone, Readonly, ReadWriteNone

Extension

Virtual machine extensions can be specified.

AttributeTypeMandatoryValuesDefaultNotes
NameStringYes
PublisherStringYes
TypeStringYes
TypeHandlerVersionStringYes

Input by YAML

Object model for YAML deployment:

---
azVirtualMachine:
# Mandatory
- Name: 'string'
ResourceGroupName: 'string'
Location: 'string'
AdminUsername: 'string'
AdminPassword:
Location: 'string'
PlainText:
Value: 'string'
AzureVault:
VaultName: 'string'
SecretName: 'string'
OSDiskSizeInGB: number
Zone: [array] # Zone number(s)
PublisherName: 'string'
Offer: 'string'
Sku: 'string'
NetworkInterface:
- Name: 'string'
# Optional
Size: 'string' # Standard_D2s_v3 (D)
ComputerName: 'string' # Default: first 15 chars of name
OSDiskName: 'string' # Default: disk-<name>-os
LicenseType: 'string' # None (D), Windows_Server
StorageAccountName: 'string' # Used for boot diagnostics, diagnostics disabled if not supplied
EnableRemotePS: boolean # True, False (D)
DisableWindowsUpdate: boolean # True, False (D)
AvailabilitySetName: 'string'
Disk:
- Name: 'string'
NTFSBlockSize: number
Letter: 'string'
Label: 'string'
Lun: number
Caching: 'string' # None (D), Readonly, ReadWrite
Extension:
- Name: 'string'
Publisher: 'string'
Type: 'string'
TypeHandlerVersion: 'string'
Identity:
SystemIdentity: boolean # True, False (D)
UserIdentity:
- Name: 'string'
ResourceGroupName: 'string'
Tag:
'keyvalue-pairs'
Lock:
- Name: 'string'
Level: 'string' # CanNotDelete, ReadOnly
Notes: 'string'

Input by JSON

Object model for JSON deployment:

{
"azVirtualMachine": [
{
"Name": "string",
"AdminUsername": "string",
"AdminPassword": {
"Location": "string",
"PlainText": {
"Value": "string"
},
"AzureVault": {
"VaultName": "string",
"SecretName": "string"
}
},
"OSDiskName": "string",
"OSDiskSizeInGB": number,
"ResourceGroupName": "string",
"Location": "string",
"Zone": [array],
"PublisherName": "string",
"Offer": "string",
"Sku": "string",
"Size": "string",
"LicenseType": "string",
"StorageAccountName": "string",
"EnableRemotePS": boolean,
"DisableWindowsUpdate": boolean,
"AvailabilitySetName": "string",
"NetworkInterface": [
{
"Name": "string"
}
],
"Disk": [
{
"Name": "string",
"NTFSBlockSize": number,
"Letter": "string",
"Label": "string",
"Lun": number,
"Caching": "string"
}
],
"Extension": [
{
"Name": "string",
"Publisher": "string",
"Type": "string",
"TypeHandlerVersion": "string"
}
],
"Identity": {
"SystemIdentity": boolean,
"UserIdentity": [
{
"Name": "string",
"ResourceGroupName": "string"
}
]
},
"Tag": {
"key": "value"
},
"Lock": [
{
"Name": "string",
"Level": "string",
"Notes": "string"
}
]
}
]
}