VMware CreateVm

VMware CreateVm

Certified
Enterprise Edition

Provision and optionally power on a VM on ESXi

Creates a VM directly on a standalone ESXi host with a mounted ISO. Defaults: 1 vCPU, 4 GB RAM, ~16 GB disk, guest OS ID ubuntu64Guest, and powerOn=true unless overridden.

yaml
type: io.kestra.plugin.ee.vmware.esxi.CreateVm

Create a new virtual machine on an ESXi host

yaml
id: esxi_create_vm
namespace: company.team

tasks:
  - id: create
    type: io.kestra.plugin.ee.vmware.esxi.CreateVm
    server: "esxi.mycompany.com"
    username: "{{ secret('VMWARE_ESXI_USERNAME') }}"
    password: "{{ secret('VMWARE_ESXI_PASSWORD') }}"
    hostname: "esxi.mycompany.com"
    vmName: "esxi-vm"
    networkName: "VM Network"
    datastoreName: "datastore1"
    isoName: "ubuntu-24.04.2-desktop-amd64.iso"
Properties

ESXi host name

Should match the server FQDN or IP used to connect.

ISO path

Path inside the datastore (e.g. ISOs/ubuntu.iso). Must reside on the selected datastore.

Network name

Standard switch PortGroup to attach the NIC to.

Password

Server hostname or IP

FQDN or IP of the vCenter or ESXi endpoint (no scheme or port).

Username

e.g. Administrator@vsphere.local for vCenter or root for ESXi.

VM name

Unique VM name on this ESXi host.

vCPU count

Defaults to 1.

Datastore name

Datastore for VM files; omit to use the host default.

Disk size (MB)

Defaults to ~16000 MB if not provided.

Guest OS ID

e.g. ubuntu64Guest, rhel9_64Guest, windows11_64Guest. Defaults to ubuntu64Guest.

Memory size (MB)

Defaults to 4096 MB.

Reference (ref) of the pluginDefaults to apply to this task.

Default443

Server port

Defaults to 443.

Power on after creation

Defaults to true; set false to leave the VM powered off.

Trust store path

Optional path to a PKCS12 trust store containing the CA certificate(s) used to validate the vCenter/ESXi server's TLS certificate. If omitted (or if the path does not exist), the JVM's default trust store (system CA certificates) is used instead. Certificate validation is always enforced; this plugin never disables TLS certificate validation.