VMware UpdateVm
CertifiedEnterprise EditionReconfigure a VM via vCenter
VMware UpdateVm
Reconfigure a VM via vCenter
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.
type: io.kestra.plugin.ee.vmware.vcenter.UpdateVmExamples
Update a VM via vCenter
id: update_vm
namespace: company.team
tasks:
- id: update
type: io.kestra.plugin.ee.vmware.vcenter.UpdateVm
server: "vcenter.mycompany.com"
username: "{{ secret('VMWARE_VCENTER_USERNAME') }}"
password: "{{ secret('VMWARE_VCENTER_PASSWORD') }}"
vmName: "vcenter-vm"
cpuCount: 4
memorySize: 8192
networkName: "VM Network 2"
diskSize: 20480
resetAfterUpdate: true
Properties
password *Requiredstring
Password
server *Requiredstring
Server hostname or IP
FQDN or IP of the vCenter or ESXi endpoint (no scheme or port).
username *Requiredstring
Username
e.g. Administrator@vsphere.local for vCenter or root for ESXi.
vmName *Requiredstring
VM name
cpuCount integerstring
vCPU count
New vCPU total; leave empty to keep current.
customAttributes object
Custom attributes
Optional map of vCenter custom attribute name to value to set on the VM after reconfiguration. If a field definition does not exist it is created automatically for the VirtualMachine type.
diskSize integerstring
Disk size (MB)
Expands the first disk to this size; must be larger than current.
memorySize integerstring
Memory size (MB)
New memory in MB; leave empty to keep current.
networkName string
Network name (PortGroup)
PortGroup to attach the NIC to; replaces the first existing NIC.
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
port integerstring
443Server port
Defaults to 443.
resetAfterUpdate booleanstring
Reset after update
Default: true. Resets the VM if it is powered on once changes apply.
trustStorePath string
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.
