CmdID / az / az vm

az vm create

Create an Azure Virtual Machine. Azure CLI reference

121 options Its page in the Azure CLI reference

Options

121 in the Azure CLI reference

Show its 121 options

--accelerated-networkingenable accelerated networking.

--accept-termAccept the license agreement and privacy statement.

--add-proxy-agent-extension, --add-proxy-agent-extSpecify whether to implicitly install the ProxyAgent Extension.

--additional-scheduled-events, --additional-eventsThe configuration parameter used while creating event grid and resource graph scheduled event setting.

--admin-passwordPassword for the VM if authentication type is 'Password'.

--admin-usernameUsername for the VM.

--align-regional-disks-to-vm-zone, --align-regional-disksSpecify whether the regional disks should be aligned/moved to the VM zone.

--asgsSpace-separated list of existing application security groups to associate with the VM.

--assign-identityaccept system or user assigned identities separated by spaces.

--attach-data-disksAttach existing data disks to the VM.

--attach-os-diskAttach an existing OS disk to the VM.

--authentication-typeType of authentication to use with the VM.

--availability-setName or ID of an existing availability set to add the VM to.

--boot-diagnostics-storagepre-existing storage account name or its blob uri to capture boot diagnostics.

--capacity-reservation-group, --crgThe ID or name of the capacity reservation group that is used to allocate.

--computer-nameThe host OS name of the virtual machine.

--countNumber of virtual machines to create.

--custom-dataCustom init script file or text (cloud-init, cloud-config, etc..)

--data-disk-cachingstorage caching type for data disk(s), including 'None', 'ReadOnly', 'ReadWrite', etc.

--data-disk-delete-optionSpecify whether data disk should be deleted or detached upon VM deletion.

--data-disk-encryption-setsNames or IDs (space delimited) of disk encryption sets for data disks.

--data-disk-iopsSpecify the Read-Write IOPS for the managed disk when storage account type is UltraSSD_LRS.

--data-disk-mbpsSpecify the bandwidth in MB per second for the managed disk when storage account type is UltraSSD_LRS.

--data-disk-sizes-gbspace-separated empty managed data disk sizes in GB to create

--data-disk-storage-fd-alignment, --data-disk-fdaSpecifies the storage fault domain alignment type for data disks.

--disable-capacity-reservation-assignment, --no-cap-reservationExplicitly opt out the VM from being associated with any capacity reservation.

--disable-integrity-monitoring-autoupgradeDisable auto upgrade of guest attestation extension for Trusted Launch enabled VMs and VMSS.

--disable-integrity-monitoringDisable installing guest attestation extension and enabling System Assigned Identity for Trusted Launch enabled VMs and VMSS.

--disk-controller-typeSpecify the disk controller type configured for the VM or VMSS.

--edge-zoneThe name of edge zone.

--enable-agentIndicates whether virtual machine agent should be provisioned on the virtual machine.

--enable-all-instance-down, --all-instance-downSpecifies if Scheduled Events should be auto-approved when all instances are down.

--enable-auto-updateIndicate whether Automatic Updates is enabled for the Windows virtual machine

--enable-hibernationThe flag that enable or disable hibernation capability on the VM.

--enable-hotpatchingPatch VMs without requiring a reboot.

--enable-integrity-monitoringEnable installing Microsoft propietary and not security supported guest attestation extension and enabling System Assigned Identity for Trusted Launch enabled VMs and VMSS.

--enable-proxy-agentSpecify whether metadata security protoco (proxy agent) feature should be enabled on the virtual machine or virtual machine scale set.

--enable-secure-bootEnable secure boot.

--enable-user-reboot-scheduled-events, --enable-rebootThe configuration parameter used while publishing scheduled events additional publishing targets.

--enable-user-redeploy-scheduled-events, --enable-redeployThe configuration parameter used while creating user initiated redeploy scheduled event setting creation.

--enable-vtpmEnable vTPM.

--encryption-at-hostEnable Host Encryption for the VM or VMSS.

--encryption-identityResource Id of the user managed identity which can be used for Azure disk encryption

--ephemeral-os-disk-enable-full-caching, --ephemeral-full-cachingSpecify whether or not to enable full caching for this VM/VMSS which will cache the OS disk locally on the host and make this VM/VMSS more resilient to storage outages

--ephemeral-os-disk-placement, --ephemeral-placementOnly applicable when used with --ephemeral-os-disk.

--ephemeral-os-diskAllows you to create an OS disk directly on the host node, providing local disk performance and faster VM/VMSS reimage time.

--eviction-policyThe eviction policy for the Spot priority virtual machine.

--exclude-zonesIf "--zone-placement-policy" is set to "Any", availability zone selected by the system must not be present in the list of availability zones passed with "excludeZones".

--generate-ssh-keysGenerate SSH public and private key files if missing.

--host-groupName or resource ID of the dedicated host group that the VM will reside in.

--hostResource ID of the dedicated host that the VM will reside in.

--imageThe name of the operating system image as a URN alias, URN, custom image name or ID, custom image version ID, or VHD blob URI.

--imds-access-control-profile-reference-id, --imds-profile-idSpecify the access control profile version resource id resource id of imds.

--include-zonesIf "--zone-placement-policy" is set to "Any", availability zone selected by the system must be present in the list of availability zones passed with "--include-zones".

--key-incarnation-idIncrease the value of this property allows user to reset the key used for securing communication channel between guest and host.

--license-typeSpecifies that the Windows image or disk was licensed on-premises.

--location, -lLocation in which to create VM and related resources.

--max-priceThe maximum price (in US Dollars) you are willing to pay for a Spot VM/VMSS.

--name, -nName of the virtual machine.

--nic-delete-optionSpecify what happens to the network interface when the VM is deleted.

--nicsNames or IDs of existing NICs to attach to the VM.

--no-waitDo not wait for the long-running operation to finish.

--nsg-ruleNSG rule to create when creating a new NSG.

--nsgThe name to use when creating a new Network Security Group (default) or referencing an existing one.

--os-disk-cachingStorage caching type for the VM OS disk.

--os-disk-delete-optionSpecify the behavior of the managed disk when the VM gets deleted i.e whether the managed disk is deleted or detached.

--os-disk-encryption-setName or ID of disk encryption set for OS disk.

--os-disk-nameThe name of the new VM OS disk.

--os-disk-secure-vm-disk-encryption-setSpecify the customer managed disk encryption set resource ID or name for the managed disk that is used for customer managed key encrypted Confidential VM OS disk and VM guest blob.

--os-disk-security-encryption-typeSpecify the encryption type of the OS managed disk.

--os-disk-size-gbthe size of the os disk in GB

--os-disk-storage-fd-alignment, --os-disk-fdaSpecifies the storage fault domain alignment type for the OS disk.

--os-typeType of OS installed on a custom VHD.

--patch-modeMode of in-guest patching to IaaS virtual machine.

--plan-nameplan name

--plan-productplan product

--plan-promotion-codeplan promotion code

--plan-publisherplan publisher

--platform-fault-domainSpecify the scale set logical fault domain into which the virtual machine will be created.

--ppgThe name or ID of the proximity placement group the VM should be associated with.

--preferred-sizePreferred VM size for Flow VMs.

--priorityPriority.

--private-ip-addressStatic private IP address (e.g. 10.0.0.5).

--processor-modeSpecifies the processor mode for the virtual machine or virtual machine scale set.

--proxy-agent-mode, --wire-server-mode, --imds-modeSpecify the mode that proxy agent will execute on if the feature is enabled.

--public-ip-address-allocation, --storage-sku

--public-ip-address-dns-nameGlobally unique DNS name for a newly created public IP.

--public-ip-addressName of the public IP address when creating one (default) or referencing an existing one.

--public-ip-skuPublic IP SKU.

--roleRole name or id the system assigned identity will have.

--scheduled-events-api-version, --se-api-versionSpecifies the api-version to determine which Scheduled Events configuration schema version will be delivered.

--scopeScope that the system assigned identity can access.

--secretsOne or many Key Vault secrets as JSON strings or files via @{path} containing [{ "sourceVault": { "id": "value" }, "vaultCertificates": [{ "certificateUrl": "value", "certificateStore": "cert store name (only on windows)"}] }]

--security-typeSpecify the security type of the virtual machine.

--sizeThe VM size to be created.

--source-disk-restore-point, --source-disk-rpcreate a data disk from a disk restore point.

--source-disk-restore-point-size-gb, --source-rp-sizeThe size of the source disk restore point in GB

--source-snapshots-or-disks, --source-resourceCreate a data disk from a snapshot or another disk.

--source-snapshots-or-disks-size-gb, --source-resource-sizeThe size of the source disk in GB

--specializedIndicate whether the source image is specialized.

--ssh-dest-key-pathDestination file path on the VM for the SSH key.

--ssh-key-nameUse it as public key in virtual machine.

--ssh-key-typeSpecify the type of SSH public and private key files to be generated if missing.

--ssh-key-valuesSpace-separated list of SSH public keys or public key file paths.

--storage-container-name, --storage-accountOnly applicable when used with --use-unmanaged-disk.

--subnet-address-prefixThe subnet IP address prefix to use when creating a new VNet in CIDR format.

--subnetThe name of the subnet when creating a new VNet or referencing an existing one.

--tagsspace-separated tags: key[=value] [key[=value] ...].

--ultra-ssd-enabledEnables or disables the capability to have 1 or more managed data disks with UltraSSD_LRS storage account

--use-unmanaged-diskDo not use managed disk to persist VM

--user-dataUserData for the VM.

--v-cpus-availableSpecify the number of vCPUs available

--v-cpus-per-coreSpecify the ratio of vCPU to physical core.

--validateGenerate and validate the ARM template without creating any resources.

--vmssName or ID of an existing virtual machine scale set that the virtual machine should be assigned to.

--vnet-address-prefixThe IP address prefix to use when creating a new VNet in CIDR format.

--vnet-nameName of the virtual network when creating a new one or referencing an existing one.

--wire-server-access-control-profile-reference-id, --wire-server-profile-idSpecify the access control profile version resource id of wire server.

--wire-server-use-local-file-rules, --wire-local-rulesWhen set to true, instructs the GuestProxyAgent inside the VM to load additional access control rules defined in a local file on the VM.

--zone-movementIndicates if zone movement is enabled.

--zone-placement-policySpecify the policy for virtual machine's placement in availability zone