VMware UpdateVm

VMware UpdateVm

Certified
Enterprise Edition

Reconfigure a VM on an ESXi host

Updates CPU, memory, network PortGroup, and/or expands disks for an existing VM. Optionally resets the VM afterward (default true when powered on); disks can only be increased.

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

Update a VM

yaml
id: update_vm
namespace: company.team

tasks:
  - id: update
    type: io.kestra.plugin.ee.vmware.esxi.UpdateVm
    server: "esxi.mycompany.com"
    username: "{{ secret('VMWARE_ESXI_USERNAME') }}"
    password: "{{ secret('VMWARE_ESXI_PASSWORD') }}"
    vmName: "esxi-vm"
    cpuCount: 4
    memorySize: 8192
    networkName: "VM Network 2"
    diskSize: 20480
    resetAfterUpdate: true
Properties

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

Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.

Definitions
assetFailureBehaviorstring
Possible Values
IGNOREFAILWARN

Asset failure behavior

Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.

enableAutobooleanstring

Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.

inputsarray

The assets consumed as inputs.

id*string
Min length1
typestring
outputs

The assets produced as outputs.

id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*string
Min length1

Custom asset type

descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150

vCPU count

New vCPU total; leave empty to keep current.

Disk size (MB)

Expands the first disk to this size; must be larger than current.

Memory size (MB)

New memory in MB; leave empty to keep current.

Network name (PortGroup)

PortGroup to attach the NIC to; replaces the first existing NIC.

Default443

Server port

Defaults to 443.

Reset after update

Default: true. Resets the VM if it is powered on once changes apply.

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.