pulumi-vsphere 4.11.0a1__py3-none-any.whl → 4.11.0a1711033215__py3-none-any.whl

pulumi_vsphere/virtual_machine.py

@@ -93,93 +93,122 @@ class VirtualMachineArgs:
                  wait_for_guest_net_timeout: Optional[pulumi.Input[int]] = None):
         """
         The set of arguments for constructing a VirtualMachine resource.
-        :param pulumi.Input[str] resource_pool_id: The ID of a resource pool to put the virtual machine in.
-        :param pulumi.Input[str] alternate_guest_name: The guest name for the operating system when guest_id is otherGuest or otherGuest64.
-        :param pulumi.Input[str] annotation: User-provided description of the virtual machine.
-        :param pulumi.Input[int] boot_delay: The number of milliseconds to wait before starting the boot sequence.
-        :param pulumi.Input[int] boot_retry_delay: The number of milliseconds to wait before retrying the boot sequence. This only valid if boot_retry_enabled is true.
-        :param pulumi.Input[bool] boot_retry_enabled: If set to true, a virtual machine that fails to boot will try again after the delay defined in boot_retry_delay.
-        :param pulumi.Input[Sequence[pulumi.Input['VirtualMachineCdromArgs']]] cdroms: A specification for a CDROM device on this virtual machine.
-        :param pulumi.Input['VirtualMachineCloneArgs'] clone: A specification for cloning a virtual machine from template.
-        :param pulumi.Input[bool] cpu_hot_add_enabled: Allow CPUs to be added to this virtual machine while it is running.
-        :param pulumi.Input[bool] cpu_hot_remove_enabled: Allow CPUs to be added to this virtual machine while it is running.
-        :param pulumi.Input[int] cpu_limit: The maximum amount of memory (in MB) or CPU (in MHz) that this virtual machine can consume, regardless of available
-               resources.
-        :param pulumi.Input[bool] cpu_performance_counters_enabled: Enable CPU performance counters on this virtual machine.
-        :param pulumi.Input[int] cpu_reservation: The amount of memory (in MB) or CPU (in MHz) that this virtual machine is guaranteed.
-        :param pulumi.Input[int] cpu_share_count: The amount of shares to allocate to cpu for a custom share level.
-        :param pulumi.Input[str] cpu_share_level: The allocation level for cpu resources. Can be one of high, low, normal, or custom.
-        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] custom_attributes: A list of custom attributes to set on this resource.
-        :param pulumi.Input[str] datacenter_id: The ID of the datacenter where the VM is to be created.
-        :param pulumi.Input[str] datastore_cluster_id: The ID of a datastore cluster to put the virtual machine in.
-        :param pulumi.Input[str] datastore_id: The ID of the virtual machine's datastore. The virtual machine configuration is placed here, along with any virtual
-               disks that are created without datastores.
-        :param pulumi.Input[Sequence[pulumi.Input['VirtualMachineDiskArgs']]] disks: A specification for a virtual disk device on this virtual machine.
-        :param pulumi.Input[bool] efi_secure_boot_enabled: When the boot type set in firmware is efi, this enables EFI secure boot.
-        :param pulumi.Input[bool] enable_disk_uuid: Expose the UUIDs of attached virtual disks to the virtual machine, allowing access to them in the guest.
-        :param pulumi.Input[bool] enable_logging: Enable logging on this virtual machine.
-        :param pulumi.Input[str] ept_rvi_mode: The EPT/RVI (hardware memory virtualization) setting for this virtual machine. Can be one of automatic, on, or off.
-        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] extra_config: Extra configuration data for this virtual machine. Can be used to supply advanced parameters not normally in
-               configuration, such as instance metadata, or configuration data for OVF images.
-        :param pulumi.Input[bool] extra_config_reboot_required: Allow the virtual machine to be rebooted when a change to `extra_config` occurs.
-        :param pulumi.Input[str] firmware: The firmware interface to use on the virtual machine. Can be one of bios or efi.
-        :param pulumi.Input[str] folder: The name of the folder to locate the virtual machine in.
-        :param pulumi.Input[bool] force_power_off: Set to true to force power-off a virtual machine if a graceful guest shutdown failed for a necessary operation.
-        :param pulumi.Input[str] guest_id: The guest ID for the operating system.
-        :param pulumi.Input[int] hardware_version: The hardware version for the virtual machine.
-        :param pulumi.Input[str] host_system_id: The ID of an optional host system to pin the virtual machine to.
-        :param pulumi.Input[str] hv_mode: The (non-nested) hardware virtualization setting for this virtual machine. Can be one of hvAuto, hvOn, or hvOff.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] ignored_guest_ips: List of IP addresses and CIDR networks to ignore while waiting for an IP
-        :param pulumi.Input[str] latency_sensitivity: Controls the scheduling delay of the virtual machine. Use a higher sensitivity for applications that require lower
-               latency, such as VOIP, media player applications, or applications that require frequent access to mouse or keyboard
-               devices. Can be one of low, normal, medium, or high.
-        :param pulumi.Input[int] memory: The size of the virtual machine's memory, in MB.
-        :param pulumi.Input[bool] memory_hot_add_enabled: Allow memory to be added to this virtual machine while it is running.
-        :param pulumi.Input[int] memory_limit: The maximum amount of memory (in MB) or CPU (in MHz) that this virtual machine can consume, regardless of available
-               resources.
-        :param pulumi.Input[int] memory_reservation: The amount of memory (in MB) or CPU (in MHz) that this virtual machine is guaranteed.
+        :param pulumi.Input[str] resource_pool_id: The managed object reference ID of the resource pool in which to place the virtual machine. See the Virtual Machine Migration section for more information on modifying this value.
+               
+               > **NOTE:** All clusters and standalone hosts have a default root resource pool. This resource argument does not directly accept the cluster or standalone host resource. For more information, see the section on specifying the Root Resource Pool in the `ResourcePool` data source documentation on using the root resource pool.
+        :param pulumi.Input[str] alternate_guest_name: The guest name for the operating system when `guest_id` is `otherGuest` or `otherGuest64`.
+        :param pulumi.Input[str] annotation: A user-provided description of the virtual machine.
+        :param pulumi.Input[int] boot_delay: The number of milliseconds to wait before starting the boot sequence. The default is no delay.
+        :param pulumi.Input[int] boot_retry_delay: The number of milliseconds to wait before retrying the boot sequence. This option is only valid if `boot_retry_enabled` is `true`. Default: `10000` (10 seconds).
+        :param pulumi.Input[bool] boot_retry_enabled: If set to `true`, a virtual machine that fails to boot will try again after the delay defined in `boot_retry_delay`. Default: `false`.
+        :param pulumi.Input[Sequence[pulumi.Input['VirtualMachineCdromArgs']]] cdroms: A specification for a CD-ROM device on the virtual machine. See CD-ROM options for more information.
+        :param pulumi.Input['VirtualMachineCloneArgs'] clone: When specified, the virtual machine will be created as a clone of a specified template. Optional customization options can be submitted for the resource. See creating a virtual machine from a template for more information.
+        :param pulumi.Input[bool] cpu_hot_add_enabled: Allow CPUs to be added to the virtual machine while it is powered on.
+        :param pulumi.Input[bool] cpu_hot_remove_enabled: Allow CPUs to be removed to the virtual machine while it is powered on.
+        :param pulumi.Input[int] cpu_limit: The maximum amount of CPU (in MHz) that the virtual machine can consume, regardless of available resources. The default is no limit.
+        :param pulumi.Input[bool] cpu_performance_counters_enabled: Enable CPU performance counters on the virtual machine. Default: `false`.
+        :param pulumi.Input[int] cpu_reservation: The amount of CPU (in MHz) that the virtual machine is guaranteed. The default is no reservation.
+        :param pulumi.Input[int] cpu_share_count: The number of CPU shares allocated to the virtual machine when the `cpu_share_level` is `custom`.
+        :param pulumi.Input[str] cpu_share_level: The allocation level for the virtual machine CPU resources. One of `high`, `low`, `normal`, or `custom`. Default: `custom`.
+        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] custom_attributes: Map of custom attribute ids to attribute value strings to set for virtual machine. Please refer to the `vsphere_custom_attributes` resource for more information on setting custom attributes.
+               
+               > **NOTE:** Custom attributes requires vCenter Server and is not supported on direct ESXi host connections.
+        :param pulumi.Input[str] datacenter_id: The datacenter ID. Required only when deploying an OVF/OVA template.
+        :param pulumi.Input[str] datastore_cluster_id: The managed object reference ID of the datastore cluster in which to place the virtual machine. This setting applies to entire virtual machine and implies that you wish to use vSphere Storage DRS with the virtual machine. See the section on virtual machine migration for more information on modifying this value.
+               
+               > **NOTE:** One of `datastore_id` or `datastore_cluster_id` must be specified.
+               
+               > **NOTE:** Use of `datastore_cluster_id` requires vSphere Storage DRS to be enabled on the specified datastore cluster.
+               
+               > **NOTE:** The `datastore_cluster_id` setting applies to the entire virtual machine resource. You cannot assign individual individual disks to datastore clusters. In addition, you cannot use the `attach` setting to attach external disks on virtual machines that are assigned to datastore clusters.
+        :param pulumi.Input[str] datastore_id: The datastore ID that on which the ISO is located. Required for using a datastore ISO. Conflicts with `client_device`.
+        :param pulumi.Input[Sequence[pulumi.Input['VirtualMachineDiskArgs']]] disks: A specification for a virtual disk device on the virtual machine. See disk options for more information.
+        :param pulumi.Input[bool] efi_secure_boot_enabled: Use this option to enable EFI secure boot when the `firmware` type is set to is `efi`. Default: `false`.
+               
+               > **NOTE:** EFI secure boot is only available on vSphere 6.5 and later.
+        :param pulumi.Input[bool] enable_disk_uuid: Expose the UUIDs of attached virtual disks to the virtual machine, allowing access to them in the guest. Default: `false`.
+        :param pulumi.Input[bool] enable_logging: Enable logging of virtual machine events to a log file stored in the virtual machine directory. Default: `false`.
+        :param pulumi.Input[str] ept_rvi_mode: The EPT/RVI (hardware memory virtualization) setting for the virtual machine. One of `automatic`, `on`, or `off`. Default: `automatic`.
+        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] extra_config: Extra configuration data for the virtual machine. Can be used to supply advanced parameters not normally in configuration, such as instance metadata and userdata.
+               
+               > **NOTE:** Do not use `extra_config` when working with a template imported from OVF/OVA as your settings may be ignored. Use the `vapp` block `properties` section as described in Using vApp Properties for OVF/OVA Configuration.
+        :param pulumi.Input[bool] extra_config_reboot_required: Allow the virtual machine to be rebooted when a change to `extra_config` occurs. Default: `true`.
+        :param pulumi.Input[str] firmware: The firmware for the virtual machine. One of `bios` or `efi`.
+        :param pulumi.Input[str] folder: The path to the virtual machine folder in which to place the virtual machine, relative to the datacenter path (`/<datacenter-name>/vm`).  For example, `/dc-01/vm/foo`
+        :param pulumi.Input[bool] force_power_off: If a guest shutdown failed or times out while updating or destroying (see `shutdown_wait_timeout`), force the power-off of the virtual machine. Default: `true`.
+        :param pulumi.Input[str] guest_id: The guest ID for the operating system type. For a full list of possible values, see [here][vmware-docs-guest-ids]. Default: `otherGuest64`.
+               
+               [vmware-docs-guest-ids]: https://vdc-repo.vmware.com/vmwb-repository/dcr-public/184bb3ba-6fa8-4574-a767-d0c96e2a38f4/ba9422ef-405c-47dd-8553-e11b619185b2/SDK/vsphere-ws/docs/ReferenceGuide/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html
+        :param pulumi.Input[int] hardware_version: The hardware version number. Valid range is from 4 to 21. The hardware version cannot be downgraded. See virtual machine hardware [versions][virtual-machine-hardware-versions] and [compatibility][virtual-machine-hardware-compatibility] for more information on supported settings.
+               
+               [virtual-machine-hardware-versions]: https://kb.vmware.com/s/article/1003746
+               [virtual-machine-hardware-compatibility]: https://kb.vmware.com/s/article/2007240
+        :param pulumi.Input[str] host_system_id: The managed object reference ID of a host on which to place the virtual machine. See the section on virtual machine migration for more information on modifying this value. When using a vSphere cluster, if a `host_system_id` is not supplied, vSphere will select a host in the cluster to place the virtual machine, according to any defaults or vSphere DRS placement policies.
+        :param pulumi.Input[str] hv_mode: The hardware virtualization (non-nested) setting for the virtual machine. One of `hvAuto`, `hvOn`, or `hvOff`. Default: `hvAuto`.
+        :param pulumi.Input[int] ide_controller_count: The number of IDE controllers that the virtual machine. This directly affects the number of disks you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove controllers. Default: `2`.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] ignored_guest_ips: List of IP addresses and CIDR networks to ignore while waiting for an available IP address using either of the waiters. Any IP addresses in this list will be ignored so that the waiter will continue to wait for a valid IP address. Default: `[]`.
+        :param pulumi.Input[str] latency_sensitivity: Controls the scheduling delay of the virtual machine. Use a higher sensitivity for applications that require lower latency, such as VOIP, media player applications, or applications that require frequent access to mouse or keyboard devices. One of `low`, `normal`, `medium`, or `high`.
+               
+               > **NOTE:** On higher sensitivities, you may need to adjust the `memory_reservation` to the full amount of memory provisioned for the virtual machine.
+        :param pulumi.Input[int] memory: The memory size to assign to the virtual machine, in MB. Default: `1024` (1 GB).
+        :param pulumi.Input[bool] memory_hot_add_enabled: Allow memory to be added to the virtual machine while it is powered on.
+               
+               > **NOTE:** CPU and memory hot add options are not available on all guest operating systems. Please refer to the [VMware Guest OS Compatibility Guide][vmware-docs-compat-guide] to which settings are allow for your guest operating system. In addition, at least one `pulumi up` must be run before you are able to use CPU and memory hot add.
+               
+               [vmware-docs-compat-guide]: http://partnerweb.vmware.com/comp_guide2/pdf/VMware_GOS_Compatibility_Guide.pdf
+               
+               > **NOTE:** For Linux 64-bit guest operating systems with less than or equal to 3GB, the virtual machine must powered off to add memory beyond 3GB. Subsequent hot add of memory does not require the virtual machine to be powered-off to apply the plan. Please refer to [VMware KB 2008405][vmware-kb-2008405].
+               
+               [vmware-kb-2008405]: https://kb.vmware.com/s/article/2008405
+        :param pulumi.Input[int] memory_limit: The maximum amount of memory (in MB) that th virtual machine can consume, regardless of available resources. The default is no limit.
+        :param pulumi.Input[int] memory_reservation: The amount of memory (in MB) that the virtual machine is guaranteed. The default is no reservation.
         :param pulumi.Input[bool] memory_reservation_locked_to_max: If set true, memory resource reservation for this virtual machine will always be equal to the virtual machine's memory
                size;increases in memory size will be rejected when a corresponding reservation increase is not possible. This feature
                may only be enabled if it is currently possible to reserve all of the virtual machine's memory.
-        :param pulumi.Input[int] memory_share_count: The amount of shares to allocate to memory for a custom share level.
-        :param pulumi.Input[str] memory_share_level: The allocation level for memory resources. Can be one of high, low, normal, or custom.
-        :param pulumi.Input[int] migrate_wait_timeout: The amount of time, in minutes, to wait for a vMotion operation to complete before failing.
-        :param pulumi.Input[str] name: The name of this virtual machine.
-        :param pulumi.Input[bool] nested_hv_enabled: Enable nested hardware virtualization on this virtual machine, facilitating nested virtualization in the guest.
-        :param pulumi.Input[Sequence[pulumi.Input['VirtualMachineNetworkInterfaceArgs']]] network_interfaces: A specification for a virtual NIC on this virtual machine.
-        :param pulumi.Input[int] num_cores_per_socket: The number of cores to distribute amongst the CPUs in this virtual machine. If specified, the value supplied to num_cpus
-               must be evenly divisible by this value.
-        :param pulumi.Input[int] num_cpus: The number of virtual processors to assign to this virtual machine.
-        :param pulumi.Input['VirtualMachineOvfDeployArgs'] ovf_deploy: A specification for deploying a virtual machine from ovf/ova template.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] pci_device_ids: A list of PCI passthrough devices
+        :param pulumi.Input[int] memory_share_count: The number of memory shares allocated to the virtual machine when the `memory_share_level` is `custom`.
+        :param pulumi.Input[str] memory_share_level: The allocation level for the virtual machine memory resources. One of `high`, `low`, `normal`, or `custom`. Default: `custom`.
+        :param pulumi.Input[int] migrate_wait_timeout: The amount of time, in minutes, to wait for a virtual machine migration to complete before failing. Default: `10` minutes. See the section on virtual machine migration for more information.
+        :param pulumi.Input[str] name: The name of the virtual machine.
+        :param pulumi.Input[bool] nested_hv_enabled: Enable nested hardware virtualization on the virtual machine, facilitating nested virtualization in the guest operating system. Default: `false`.
+        :param pulumi.Input[Sequence[pulumi.Input['VirtualMachineNetworkInterfaceArgs']]] network_interfaces: A specification for a virtual NIC on the virtual machine. See network interface options for more information.
+        :param pulumi.Input[int] num_cores_per_socket: The number of cores per socket in the virtual machine. The number of vCPUs on the virtual machine will be `num_cpus` divided by `num_cores_per_socket`. If specified, the value supplied to `num_cpus` must be evenly divisible by this value. Default: `1`.
+        :param pulumi.Input[int] num_cpus: The total number of virtual processor cores to assign to the virtual machine. Default: `1`.
+        :param pulumi.Input['VirtualMachineOvfDeployArgs'] ovf_deploy: When specified, the virtual machine will be deployed from the provided OVF/OVA template. See creating a virtual machine from an OVF/OVA template for more information.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] pci_device_ids: List of host PCI device IDs in which to create PCI passthroughs.
+               
+               > **NOTE:** Cloning requires vCenter Server and is not supported on direct ESXi host connections.
         :param pulumi.Input[int] poweron_timeout: The amount of time, in seconds, that we will be trying to power on a VM
         :param pulumi.Input[str] replace_trigger: Triggers replacement of resource whenever it changes.
-        :param pulumi.Input[bool] run_tools_scripts_after_power_on: Enable the run of scripts after virtual machine power-on when VMware Tools is installed.
-        :param pulumi.Input[bool] run_tools_scripts_after_resume: Enable the run of scripts after virtual machine resume when when VMware Tools is installed.
-        :param pulumi.Input[bool] run_tools_scripts_before_guest_reboot: Enable the run of scripts before guest operating system reboot when VMware Tools is installed.
-        :param pulumi.Input[bool] run_tools_scripts_before_guest_shutdown: Enable the run of scripts before guest operating system shutdown when VMware Tools is installed.
-        :param pulumi.Input[bool] run_tools_scripts_before_guest_standby: Enable the run of scripts before guest operating system standby when VMware Tools is installed.
-        :param pulumi.Input[str] scsi_bus_sharing: Mode for sharing the SCSI bus. The modes are physicalSharing, virtualSharing, and noSharing.
-        :param pulumi.Input[str] scsi_type: The type of SCSI bus this virtual machine will have. Can be one of lsilogic, lsilogic-sas or pvscsi.
-        :param pulumi.Input[int] shutdown_wait_timeout: The amount of time, in minutes, to wait for shutdown when making necessary updates to the virtual machine.
-        :param pulumi.Input[str] storage_policy_id: The ID of the storage policy to assign to the virtual machine home directory.
-        :param pulumi.Input[str] swap_placement_policy: The swap file placement policy for this virtual machine. Can be one of inherit, hostLocal, or vmDirectory.
-        :param pulumi.Input[bool] sync_time_with_host: Enable guest clock synchronization with the host. On vSphere 7.0 U1 and above, with only this setting the clock is
-               synchronized on startup and resume. Requires VMware Tools to be installed.
-        :param pulumi.Input[bool] sync_time_with_host_periodically: Enable periodic clock synchronization with the host. Supported only on vSphere 7.0 U1 and above. On prior versions
-               setting `sync_time_with_host` is enough for periodic synchronization. Requires VMware Tools to be installed.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: A list of tag IDs to apply to this object.
-        :param pulumi.Input[str] tools_upgrade_policy: Set the upgrade policy for VMware Tools. Can be one of `manual` or `upgradeAtPowerCycle`.
-        :param pulumi.Input['VirtualMachineVappArgs'] vapp: vApp configuration data for this virtual machine. Can be used to provide configuration data for OVF images.
-        :param pulumi.Input[bool] vbs_enabled: Flag to specify if Virtualization-based security is enabled for this virtual machine.
-        :param pulumi.Input[bool] vvtd_enabled: Flag to specify if I/O MMU virtualization, also called Intel Virtualization Technology for Directed I/O (VT-d) and AMD
-               I/O Virtualization (AMD-Vi or IOMMU), is enabled.
-        :param pulumi.Input[int] wait_for_guest_ip_timeout: The amount of time, in minutes, to wait for an available IP address on this virtual machine. A value less than 1
-               disables the waiter.
-        :param pulumi.Input[bool] wait_for_guest_net_routable: Controls whether or not the guest network waiter waits for a routable address. When false, the waiter does not wait for
-               a default gateway, nor are IP addresses checked against any discovered default gateways as part of its success criteria.
-        :param pulumi.Input[int] wait_for_guest_net_timeout: The amount of time, in minutes, to wait for an available IP address on this virtual machine. A value less than 1
-               disables the waiter.
+               
+               For example, `replace_trigger = sha256(format("%!s(MISSING)-%!s(MISSING)",data.template_file.cloud_init_metadata.rendered,data.template_file.cloud_init_userdata.rendered))` will fingerprint the changes in cloud-init metadata and userdata templates. This will enable a replacement of the resource whenever the dependant template renders a new configuration. (Forces a replacement.)
+        :param pulumi.Input[bool] run_tools_scripts_after_power_on: Enable post-power-on scripts to run when VMware Tools is installed. Default: `true`.
+        :param pulumi.Input[bool] run_tools_scripts_after_resume: Enable ost-resume scripts to run when VMware Tools is installed. Default: `true`.
+        :param pulumi.Input[bool] run_tools_scripts_before_guest_reboot: Enable pre-reboot scripts to run when VMware Tools is installed. Default: `false`.
+        :param pulumi.Input[bool] run_tools_scripts_before_guest_shutdown: Enable pre-shutdown scripts to run when VMware Tools is installed. Default: `true`.
+        :param pulumi.Input[bool] run_tools_scripts_before_guest_standby: Enable pre-standby scripts to run when VMware Tools is installed. Default: `true`.
+        :param pulumi.Input[int] sata_controller_count: The number of SATA controllers that Terraform manages on this virtual machine. This directly affects the amount of disks
+               you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove
+               controllers.
+        :param pulumi.Input[str] scsi_bus_sharing: The type of SCSI bus sharing for the virtual machine SCSI controller. One of `physicalSharing`, `virtualSharing`, and `noSharing`. Default: `noSharing`.
+        :param pulumi.Input[int] scsi_controller_count: The number of SCSI controllers that Terraform manages on this virtual machine. This directly affects the amount of disks
+               you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove
+               controllers.
+        :param pulumi.Input[str] scsi_type: The SCSI controller type for the virtual machine. One of `lsilogic` (LSI Logic Parallel), `lsilogic-sas` (LSI Logic SAS) or `pvscsi` (VMware Paravirtual). Default: `pvscsi`.
+        :param pulumi.Input[int] shutdown_wait_timeout: The amount of time, in minutes, to wait for a graceful guest shutdown when making necessary updates to the virtual machine. If `force_power_off` is set to `true`, the virtual machine will be forced to power-off after the timeout, otherwise an error is returned. Default: `3` minutes.
+        :param pulumi.Input[str] storage_policy_id: The UUID of the storage policy to assign to the virtual disk.
+        :param pulumi.Input[str] swap_placement_policy: The swap file placement policy for the virtual machine. One of `inherit`, `hostLocal`, or `vmDirectory`. Default: `inherit`.
+        :param pulumi.Input[bool] sync_time_with_host: Enable the guest operating system to synchronization its clock with the host when the virtual machine is powered on or resumed. Requires vSphere 7.0 Update 1 and later. Requires VMware Tools to be installed. Default: `true`.
+        :param pulumi.Input[bool] sync_time_with_host_periodically: Enable the guest operating system to periodically synchronize its clock with the host. Requires vSphere 7.0 Update 1 and later. On previous versions, setting `sync_time_with_host` is will enable periodic synchronization. Requires VMware Tools to be installed. Default: `false`.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource. Please refer to the `Tag` resource for more information on applying tags to virtual machine resources.
+               
+               > **NOTE:** Tagging support is unsupported on direct ESXi host connections and requires vCenter Server instance.
+        :param pulumi.Input[str] tools_upgrade_policy: Enable automatic upgrade of the VMware Tools version when the virtual machine is rebooted. If necessary, VMware Tools is upgraded to the latest version supported by the host on which the virtual machine is running. Requires VMware Tools to be installed. One of `manual` or `upgradeAtPowerCycle`. Default: `manual`.
+        :param pulumi.Input['VirtualMachineVappArgs'] vapp: Used for vApp configurations. The only sub-key available is `properties`, which is a key/value map of properties for virtual machines imported from and OVF/OVA. See Using vApp Properties for OVF/OVA Configuration for more information.
+        :param pulumi.Input[bool] vbs_enabled: Enable Virtualization Based Security. Requires `firmware` to be `efi`. In addition, `vvtd_enabled`, `nested_hv_enabled`, and `efi_secure_boot_enabled` must all have a value of `true`. Supported on vSphere 6.7 and later. Default: `false`.
+        :param pulumi.Input[bool] vvtd_enabled: Enable Intel Virtualization Technology for Directed I/O for the virtual machine (_I/O MMU_ in the vSphere Client). Supported on vSphere 6.7 and later. Default: `false`.
+        :param pulumi.Input[int] wait_for_guest_ip_timeout: The amount of time, in minutes, to wait for an available guest IP address on the virtual machine. This should only be used if the version VMware Tools does not allow the `wait_for_guest_net_timeout` waiter to be used. A value less than `1` disables the waiter. Default: `0`.
+        :param pulumi.Input[bool] wait_for_guest_net_routable: Controls whether or not the guest network waiter waits for a routable address. When `false`, the waiter does not wait for a default gateway, nor are IP addresses checked against any discovered default gateways as part of its success criteria. This property is ignored if the `wait_for_guest_ip_timeout` waiter is used. Default: `true`.
+        :param pulumi.Input[int] wait_for_guest_net_timeout: The amount of time, in minutes, to wait for an available guest IP address on the virtual machine. Older versions of VMware Tools do not populate this property. In those cases, this waiter can be disabled and the `wait_for_guest_ip_timeout` waiter can be used instead. A value less than `1` disables the waiter. Default: `5` minutes.
         """
         pulumi.set(__self__, "resource_pool_id", resource_pool_id)
         if alternate_guest_name is not None:
@@ -335,7 +364,9 @@ class VirtualMachineArgs:
     @pulumi.getter(name="resourcePoolId")
     def resource_pool_id(self) -> pulumi.Input[str]:
         """
-        The ID of a resource pool to put the virtual machine in.
+        The managed object reference ID of the resource pool in which to place the virtual machine. See the Virtual Machine Migration section for more information on modifying this value.
+
+        > **NOTE:** All clusters and standalone hosts have a default root resource pool. This resource argument does not directly accept the cluster or standalone host resource. For more information, see the section on specifying the Root Resource Pool in the `ResourcePool` data source documentation on using the root resource pool.
         """
         return pulumi.get(self, "resource_pool_id")
 
@@ -347,7 +378,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="alternateGuestName")
     def alternate_guest_name(self) -> Optional[pulumi.Input[str]]:
         """
-        The guest name for the operating system when guest_id is otherGuest or otherGuest64.
+        The guest name for the operating system when `guest_id` is `otherGuest` or `otherGuest64`.
         """
         return pulumi.get(self, "alternate_guest_name")
 
@@ -359,7 +390,7 @@ class VirtualMachineArgs:
     @pulumi.getter
     def annotation(self) -> Optional[pulumi.Input[str]]:
         """
-        User-provided description of the virtual machine.
+        A user-provided description of the virtual machine.
         """
         return pulumi.get(self, "annotation")
 
@@ -371,7 +402,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="bootDelay")
     def boot_delay(self) -> Optional[pulumi.Input[int]]:
         """
-        The number of milliseconds to wait before starting the boot sequence.
+        The number of milliseconds to wait before starting the boot sequence. The default is no delay.
         """
         return pulumi.get(self, "boot_delay")
 
@@ -383,7 +414,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="bootRetryDelay")
     def boot_retry_delay(self) -> Optional[pulumi.Input[int]]:
         """
-        The number of milliseconds to wait before retrying the boot sequence. This only valid if boot_retry_enabled is true.
+        The number of milliseconds to wait before retrying the boot sequence. This option is only valid if `boot_retry_enabled` is `true`. Default: `10000` (10 seconds).
         """
         return pulumi.get(self, "boot_retry_delay")
 
@@ -395,7 +426,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="bootRetryEnabled")
     def boot_retry_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        If set to true, a virtual machine that fails to boot will try again after the delay defined in boot_retry_delay.
+        If set to `true`, a virtual machine that fails to boot will try again after the delay defined in `boot_retry_delay`. Default: `false`.
         """
         return pulumi.get(self, "boot_retry_enabled")
 
@@ -407,7 +438,7 @@ class VirtualMachineArgs:
     @pulumi.getter
     def cdroms(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['VirtualMachineCdromArgs']]]]:
         """
-        A specification for a CDROM device on this virtual machine.
+        A specification for a CD-ROM device on the virtual machine. See CD-ROM options for more information.
         """
         return pulumi.get(self, "cdroms")
 
@@ -419,7 +450,7 @@ class VirtualMachineArgs:
     @pulumi.getter
     def clone(self) -> Optional[pulumi.Input['VirtualMachineCloneArgs']]:
         """
-        A specification for cloning a virtual machine from template.
+        When specified, the virtual machine will be created as a clone of a specified template. Optional customization options can be submitted for the resource. See creating a virtual machine from a template for more information.
         """
         return pulumi.get(self, "clone")
 
@@ -431,7 +462,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="cpuHotAddEnabled")
     def cpu_hot_add_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        Allow CPUs to be added to this virtual machine while it is running.
+        Allow CPUs to be added to the virtual machine while it is powered on.
         """
         return pulumi.get(self, "cpu_hot_add_enabled")
 
@@ -443,7 +474,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="cpuHotRemoveEnabled")
     def cpu_hot_remove_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        Allow CPUs to be added to this virtual machine while it is running.
+        Allow CPUs to be removed to the virtual machine while it is powered on.
         """
         return pulumi.get(self, "cpu_hot_remove_enabled")
 
@@ -455,8 +486,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="cpuLimit")
     def cpu_limit(self) -> Optional[pulumi.Input[int]]:
         """
-        The maximum amount of memory (in MB) or CPU (in MHz) that this virtual machine can consume, regardless of available
-        resources.
+        The maximum amount of CPU (in MHz) that the virtual machine can consume, regardless of available resources. The default is no limit.
         """
         return pulumi.get(self, "cpu_limit")
 
@@ -468,7 +498,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="cpuPerformanceCountersEnabled")
     def cpu_performance_counters_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        Enable CPU performance counters on this virtual machine.
+        Enable CPU performance counters on the virtual machine. Default: `false`.
         """
         return pulumi.get(self, "cpu_performance_counters_enabled")
 
@@ -480,7 +510,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="cpuReservation")
     def cpu_reservation(self) -> Optional[pulumi.Input[int]]:
         """
-        The amount of memory (in MB) or CPU (in MHz) that this virtual machine is guaranteed.
+        The amount of CPU (in MHz) that the virtual machine is guaranteed. The default is no reservation.
         """
         return pulumi.get(self, "cpu_reservation")
 
@@ -492,7 +522,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="cpuShareCount")
     def cpu_share_count(self) -> Optional[pulumi.Input[int]]:
         """
-        The amount of shares to allocate to cpu for a custom share level.
+        The number of CPU shares allocated to the virtual machine when the `cpu_share_level` is `custom`.
         """
         return pulumi.get(self, "cpu_share_count")
 
@@ -504,7 +534,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="cpuShareLevel")
     def cpu_share_level(self) -> Optional[pulumi.Input[str]]:
         """
-        The allocation level for cpu resources. Can be one of high, low, normal, or custom.
+        The allocation level for the virtual machine CPU resources. One of `high`, `low`, `normal`, or `custom`. Default: `custom`.
         """
         return pulumi.get(self, "cpu_share_level")
 
@@ -516,7 +546,9 @@ class VirtualMachineArgs:
     @pulumi.getter(name="customAttributes")
     def custom_attributes(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]:
         """
-        A list of custom attributes to set on this resource.
+        Map of custom attribute ids to attribute value strings to set for virtual machine. Please refer to the `vsphere_custom_attributes` resource for more information on setting custom attributes.
+
+        > **NOTE:** Custom attributes requires vCenter Server and is not supported on direct ESXi host connections.
         """
         return pulumi.get(self, "custom_attributes")
 
@@ -528,7 +560,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="datacenterId")
     def datacenter_id(self) -> Optional[pulumi.Input[str]]:
         """
-        The ID of the datacenter where the VM is to be created.
+        The datacenter ID. Required only when deploying an OVF/OVA template.
         """
         return pulumi.get(self, "datacenter_id")
 
@@ -540,7 +572,13 @@ class VirtualMachineArgs:
     @pulumi.getter(name="datastoreClusterId")
     def datastore_cluster_id(self) -> Optional[pulumi.Input[str]]:
         """
-        The ID of a datastore cluster to put the virtual machine in.
+        The managed object reference ID of the datastore cluster in which to place the virtual machine. This setting applies to entire virtual machine and implies that you wish to use vSphere Storage DRS with the virtual machine. See the section on virtual machine migration for more information on modifying this value.
+
+        > **NOTE:** One of `datastore_id` or `datastore_cluster_id` must be specified.
+
+        > **NOTE:** Use of `datastore_cluster_id` requires vSphere Storage DRS to be enabled on the specified datastore cluster.
+
+        > **NOTE:** The `datastore_cluster_id` setting applies to the entire virtual machine resource. You cannot assign individual individual disks to datastore clusters. In addition, you cannot use the `attach` setting to attach external disks on virtual machines that are assigned to datastore clusters.
         """
         return pulumi.get(self, "datastore_cluster_id")
 
@@ -552,8 +590,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="datastoreId")
     def datastore_id(self) -> Optional[pulumi.Input[str]]:
         """
-        The ID of the virtual machine's datastore. The virtual machine configuration is placed here, along with any virtual
-        disks that are created without datastores.
+        The datastore ID that on which the ISO is located. Required for using a datastore ISO. Conflicts with `client_device`.
         """
         return pulumi.get(self, "datastore_id")
 
@@ -565,7 +602,7 @@ class VirtualMachineArgs:
     @pulumi.getter
     def disks(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['VirtualMachineDiskArgs']]]]:
         """
-        A specification for a virtual disk device on this virtual machine.
+        A specification for a virtual disk device on the virtual machine. See disk options for more information.
         """
         return pulumi.get(self, "disks")
 
@@ -577,7 +614,9 @@ class VirtualMachineArgs:
     @pulumi.getter(name="efiSecureBootEnabled")
     def efi_secure_boot_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        When the boot type set in firmware is efi, this enables EFI secure boot.
+        Use this option to enable EFI secure boot when the `firmware` type is set to is `efi`. Default: `false`.
+
+        > **NOTE:** EFI secure boot is only available on vSphere 6.5 and later.
         """
         return pulumi.get(self, "efi_secure_boot_enabled")
 
@@ -589,7 +628,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="enableDiskUuid")
     def enable_disk_uuid(self) -> Optional[pulumi.Input[bool]]:
         """
-        Expose the UUIDs of attached virtual disks to the virtual machine, allowing access to them in the guest.
+        Expose the UUIDs of attached virtual disks to the virtual machine, allowing access to them in the guest. Default: `false`.
         """
         return pulumi.get(self, "enable_disk_uuid")
 
@@ -601,7 +640,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="enableLogging")
     def enable_logging(self) -> Optional[pulumi.Input[bool]]:
         """
-        Enable logging on this virtual machine.
+        Enable logging of virtual machine events to a log file stored in the virtual machine directory. Default: `false`.
         """
         return pulumi.get(self, "enable_logging")
 
@@ -613,7 +652,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="eptRviMode")
     def ept_rvi_mode(self) -> Optional[pulumi.Input[str]]:
         """
-        The EPT/RVI (hardware memory virtualization) setting for this virtual machine. Can be one of automatic, on, or off.
+        The EPT/RVI (hardware memory virtualization) setting for the virtual machine. One of `automatic`, `on`, or `off`. Default: `automatic`.
         """
         return pulumi.get(self, "ept_rvi_mode")
 
@@ -625,8 +664,9 @@ class VirtualMachineArgs:
     @pulumi.getter(name="extraConfig")
     def extra_config(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]:
         """
-        Extra configuration data for this virtual machine. Can be used to supply advanced parameters not normally in
-        configuration, such as instance metadata, or configuration data for OVF images.
+        Extra configuration data for the virtual machine. Can be used to supply advanced parameters not normally in configuration, such as instance metadata and userdata.
+
+        > **NOTE:** Do not use `extra_config` when working with a template imported from OVF/OVA as your settings may be ignored. Use the `vapp` block `properties` section as described in Using vApp Properties for OVF/OVA Configuration.
         """
         return pulumi.get(self, "extra_config")
 
@@ -638,7 +678,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="extraConfigRebootRequired")
     def extra_config_reboot_required(self) -> Optional[pulumi.Input[bool]]:
         """
-        Allow the virtual machine to be rebooted when a change to `extra_config` occurs.
+        Allow the virtual machine to be rebooted when a change to `extra_config` occurs. Default: `true`.
         """
         return pulumi.get(self, "extra_config_reboot_required")
 
@@ -650,7 +690,7 @@ class VirtualMachineArgs:
     @pulumi.getter
     def firmware(self) -> Optional[pulumi.Input[str]]:
         """
-        The firmware interface to use on the virtual machine. Can be one of bios or efi.
+        The firmware for the virtual machine. One of `bios` or `efi`.
         """
         return pulumi.get(self, "firmware")
 
@@ -662,7 +702,7 @@ class VirtualMachineArgs:
     @pulumi.getter
     def folder(self) -> Optional[pulumi.Input[str]]:
         """
-        The name of the folder to locate the virtual machine in.
+        The path to the virtual machine folder in which to place the virtual machine, relative to the datacenter path (`/<datacenter-name>/vm`).  For example, `/dc-01/vm/foo`
         """
         return pulumi.get(self, "folder")
 
@@ -674,7 +714,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="forcePowerOff")
     def force_power_off(self) -> Optional[pulumi.Input[bool]]:
         """
-        Set to true to force power-off a virtual machine if a graceful guest shutdown failed for a necessary operation.
+        If a guest shutdown failed or times out while updating or destroying (see `shutdown_wait_timeout`), force the power-off of the virtual machine. Default: `true`.
         """
         return pulumi.get(self, "force_power_off")
 
@@ -686,7 +726,9 @@ class VirtualMachineArgs:
     @pulumi.getter(name="guestId")
     def guest_id(self) -> Optional[pulumi.Input[str]]:
         """
-        The guest ID for the operating system.
+        The guest ID for the operating system type. For a full list of possible values, see [here][vmware-docs-guest-ids]. Default: `otherGuest64`.
+
+        [vmware-docs-guest-ids]: https://vdc-repo.vmware.com/vmwb-repository/dcr-public/184bb3ba-6fa8-4574-a767-d0c96e2a38f4/ba9422ef-405c-47dd-8553-e11b619185b2/SDK/vsphere-ws/docs/ReferenceGuide/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html
         """
         return pulumi.get(self, "guest_id")
 
@@ -698,7 +740,10 @@ class VirtualMachineArgs:
     @pulumi.getter(name="hardwareVersion")
     def hardware_version(self) -> Optional[pulumi.Input[int]]:
         """
-        The hardware version for the virtual machine.
+        The hardware version number. Valid range is from 4 to 21. The hardware version cannot be downgraded. See virtual machine hardware [versions][virtual-machine-hardware-versions] and [compatibility][virtual-machine-hardware-compatibility] for more information on supported settings.
+
+        [virtual-machine-hardware-versions]: https://kb.vmware.com/s/article/1003746
+        [virtual-machine-hardware-compatibility]: https://kb.vmware.com/s/article/2007240
         """
         return pulumi.get(self, "hardware_version")
 
@@ -710,7 +755,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="hostSystemId")
     def host_system_id(self) -> Optional[pulumi.Input[str]]:
         """
-        The ID of an optional host system to pin the virtual machine to.
+        The managed object reference ID of a host on which to place the virtual machine. See the section on virtual machine migration for more information on modifying this value. When using a vSphere cluster, if a `host_system_id` is not supplied, vSphere will select a host in the cluster to place the virtual machine, according to any defaults or vSphere DRS placement policies.
         """
         return pulumi.get(self, "host_system_id")
 
@@ -722,7 +767,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="hvMode")
     def hv_mode(self) -> Optional[pulumi.Input[str]]:
         """
-        The (non-nested) hardware virtualization setting for this virtual machine. Can be one of hvAuto, hvOn, or hvOff.
+        The hardware virtualization (non-nested) setting for the virtual machine. One of `hvAuto`, `hvOn`, or `hvOff`. Default: `hvAuto`.
         """
         return pulumi.get(self, "hv_mode")
 
@@ -733,6 +778,9 @@ class VirtualMachineArgs:
     @property
     @pulumi.getter(name="ideControllerCount")
     def ide_controller_count(self) -> Optional[pulumi.Input[int]]:
+        """
+        The number of IDE controllers that the virtual machine. This directly affects the number of disks you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove controllers. Default: `2`.
+        """
         return pulumi.get(self, "ide_controller_count")
 
     @ide_controller_count.setter
@@ -743,7 +791,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="ignoredGuestIps")
     def ignored_guest_ips(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
         """
-        List of IP addresses and CIDR networks to ignore while waiting for an IP
+        List of IP addresses and CIDR networks to ignore while waiting for an available IP address using either of the waiters. Any IP addresses in this list will be ignored so that the waiter will continue to wait for a valid IP address. Default: `[]`.
         """
         return pulumi.get(self, "ignored_guest_ips")
 
@@ -755,9 +803,9 @@ class VirtualMachineArgs:
     @pulumi.getter(name="latencySensitivity")
     def latency_sensitivity(self) -> Optional[pulumi.Input[str]]:
         """
-        Controls the scheduling delay of the virtual machine. Use a higher sensitivity for applications that require lower
-        latency, such as VOIP, media player applications, or applications that require frequent access to mouse or keyboard
-        devices. Can be one of low, normal, medium, or high.
+        Controls the scheduling delay of the virtual machine. Use a higher sensitivity for applications that require lower latency, such as VOIP, media player applications, or applications that require frequent access to mouse or keyboard devices. One of `low`, `normal`, `medium`, or `high`.
+
+        > **NOTE:** On higher sensitivities, you may need to adjust the `memory_reservation` to the full amount of memory provisioned for the virtual machine.
         """
         return pulumi.get(self, "latency_sensitivity")
 
@@ -769,7 +817,7 @@ class VirtualMachineArgs:
     @pulumi.getter
     def memory(self) -> Optional[pulumi.Input[int]]:
         """
-        The size of the virtual machine's memory, in MB.
+        The memory size to assign to the virtual machine, in MB. Default: `1024` (1 GB).
         """
         return pulumi.get(self, "memory")
 
@@ -781,7 +829,15 @@ class VirtualMachineArgs:
     @pulumi.getter(name="memoryHotAddEnabled")
     def memory_hot_add_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        Allow memory to be added to this virtual machine while it is running.
+        Allow memory to be added to the virtual machine while it is powered on.
+
+        > **NOTE:** CPU and memory hot add options are not available on all guest operating systems. Please refer to the [VMware Guest OS Compatibility Guide][vmware-docs-compat-guide] to which settings are allow for your guest operating system. In addition, at least one `pulumi up` must be run before you are able to use CPU and memory hot add.
+
+        [vmware-docs-compat-guide]: http://partnerweb.vmware.com/comp_guide2/pdf/VMware_GOS_Compatibility_Guide.pdf
+
+        > **NOTE:** For Linux 64-bit guest operating systems with less than or equal to 3GB, the virtual machine must powered off to add memory beyond 3GB. Subsequent hot add of memory does not require the virtual machine to be powered-off to apply the plan. Please refer to [VMware KB 2008405][vmware-kb-2008405].
+
+        [vmware-kb-2008405]: https://kb.vmware.com/s/article/2008405
         """
         return pulumi.get(self, "memory_hot_add_enabled")
 
@@ -793,8 +849,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="memoryLimit")
     def memory_limit(self) -> Optional[pulumi.Input[int]]:
         """
-        The maximum amount of memory (in MB) or CPU (in MHz) that this virtual machine can consume, regardless of available
-        resources.
+        The maximum amount of memory (in MB) that th virtual machine can consume, regardless of available resources. The default is no limit.
         """
         return pulumi.get(self, "memory_limit")
 
@@ -806,7 +861,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="memoryReservation")
     def memory_reservation(self) -> Optional[pulumi.Input[int]]:
         """
-        The amount of memory (in MB) or CPU (in MHz) that this virtual machine is guaranteed.
+        The amount of memory (in MB) that the virtual machine is guaranteed. The default is no reservation.
         """
         return pulumi.get(self, "memory_reservation")
 
@@ -832,7 +887,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="memoryShareCount")
     def memory_share_count(self) -> Optional[pulumi.Input[int]]:
         """
-        The amount of shares to allocate to memory for a custom share level.
+        The number of memory shares allocated to the virtual machine when the `memory_share_level` is `custom`.
         """
         return pulumi.get(self, "memory_share_count")
 
@@ -844,7 +899,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="memoryShareLevel")
     def memory_share_level(self) -> Optional[pulumi.Input[str]]:
         """
-        The allocation level for memory resources. Can be one of high, low, normal, or custom.
+        The allocation level for the virtual machine memory resources. One of `high`, `low`, `normal`, or `custom`. Default: `custom`.
         """
         return pulumi.get(self, "memory_share_level")
 
@@ -856,7 +911,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="migrateWaitTimeout")
     def migrate_wait_timeout(self) -> Optional[pulumi.Input[int]]:
         """
-        The amount of time, in minutes, to wait for a vMotion operation to complete before failing.
+        The amount of time, in minutes, to wait for a virtual machine migration to complete before failing. Default: `10` minutes. See the section on virtual machine migration for more information.
         """
         return pulumi.get(self, "migrate_wait_timeout")
 
@@ -868,7 +923,7 @@ class VirtualMachineArgs:
     @pulumi.getter
     def name(self) -> Optional[pulumi.Input[str]]:
         """
-        The name of this virtual machine.
+        The name of the virtual machine.
         """
         return pulumi.get(self, "name")
 
@@ -880,7 +935,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="nestedHvEnabled")
     def nested_hv_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        Enable nested hardware virtualization on this virtual machine, facilitating nested virtualization in the guest.
+        Enable nested hardware virtualization on the virtual machine, facilitating nested virtualization in the guest operating system. Default: `false`.
         """
         return pulumi.get(self, "nested_hv_enabled")
 
@@ -892,7 +947,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="networkInterfaces")
     def network_interfaces(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['VirtualMachineNetworkInterfaceArgs']]]]:
         """
-        A specification for a virtual NIC on this virtual machine.
+        A specification for a virtual NIC on the virtual machine. See network interface options for more information.
         """
         return pulumi.get(self, "network_interfaces")
 
@@ -904,8 +959,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="numCoresPerSocket")
     def num_cores_per_socket(self) -> Optional[pulumi.Input[int]]:
         """
-        The number of cores to distribute amongst the CPUs in this virtual machine. If specified, the value supplied to num_cpus
-        must be evenly divisible by this value.
+        The number of cores per socket in the virtual machine. The number of vCPUs on the virtual machine will be `num_cpus` divided by `num_cores_per_socket`. If specified, the value supplied to `num_cpus` must be evenly divisible by this value. Default: `1`.
         """
         return pulumi.get(self, "num_cores_per_socket")
 
@@ -917,7 +971,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="numCpus")
     def num_cpus(self) -> Optional[pulumi.Input[int]]:
         """
-        The number of virtual processors to assign to this virtual machine.
+        The total number of virtual processor cores to assign to the virtual machine. Default: `1`.
         """
         return pulumi.get(self, "num_cpus")
 
@@ -929,7 +983,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="ovfDeploy")
     def ovf_deploy(self) -> Optional[pulumi.Input['VirtualMachineOvfDeployArgs']]:
         """
-        A specification for deploying a virtual machine from ovf/ova template.
+        When specified, the virtual machine will be deployed from the provided OVF/OVA template. See creating a virtual machine from an OVF/OVA template for more information.
         """
         return pulumi.get(self, "ovf_deploy")
 
@@ -941,7 +995,9 @@ class VirtualMachineArgs:
     @pulumi.getter(name="pciDeviceIds")
     def pci_device_ids(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
         """
-        A list of PCI passthrough devices
+        List of host PCI device IDs in which to create PCI passthroughs.
+
+        > **NOTE:** Cloning requires vCenter Server and is not supported on direct ESXi host connections.
         """
         return pulumi.get(self, "pci_device_ids")
 
@@ -966,6 +1022,8 @@ class VirtualMachineArgs:
     def replace_trigger(self) -> Optional[pulumi.Input[str]]:
         """
         Triggers replacement of resource whenever it changes.
+
+        For example, `replace_trigger = sha256(format("%!s(MISSING)-%!s(MISSING)",data.template_file.cloud_init_metadata.rendered,data.template_file.cloud_init_userdata.rendered))` will fingerprint the changes in cloud-init metadata and userdata templates. This will enable a replacement of the resource whenever the dependant template renders a new configuration. (Forces a replacement.)
         """
         return pulumi.get(self, "replace_trigger")
 
@@ -977,7 +1035,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="runToolsScriptsAfterPowerOn")
     def run_tools_scripts_after_power_on(self) -> Optional[pulumi.Input[bool]]:
         """
-        Enable the run of scripts after virtual machine power-on when VMware Tools is installed.
+        Enable post-power-on scripts to run when VMware Tools is installed. Default: `true`.
         """
         return pulumi.get(self, "run_tools_scripts_after_power_on")
 
@@ -989,7 +1047,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="runToolsScriptsAfterResume")
     def run_tools_scripts_after_resume(self) -> Optional[pulumi.Input[bool]]:
         """
-        Enable the run of scripts after virtual machine resume when when VMware Tools is installed.
+        Enable ost-resume scripts to run when VMware Tools is installed. Default: `true`.
         """
         return pulumi.get(self, "run_tools_scripts_after_resume")
 
@@ -1001,7 +1059,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="runToolsScriptsBeforeGuestReboot")
     def run_tools_scripts_before_guest_reboot(self) -> Optional[pulumi.Input[bool]]:
         """
-        Enable the run of scripts before guest operating system reboot when VMware Tools is installed.
+        Enable pre-reboot scripts to run when VMware Tools is installed. Default: `false`.
         """
         return pulumi.get(self, "run_tools_scripts_before_guest_reboot")
 
@@ -1013,7 +1071,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="runToolsScriptsBeforeGuestShutdown")
     def run_tools_scripts_before_guest_shutdown(self) -> Optional[pulumi.Input[bool]]:
         """
-        Enable the run of scripts before guest operating system shutdown when VMware Tools is installed.
+        Enable pre-shutdown scripts to run when VMware Tools is installed. Default: `true`.
         """
         return pulumi.get(self, "run_tools_scripts_before_guest_shutdown")
 
@@ -1025,7 +1083,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="runToolsScriptsBeforeGuestStandby")
     def run_tools_scripts_before_guest_standby(self) -> Optional[pulumi.Input[bool]]:
         """
-        Enable the run of scripts before guest operating system standby when VMware Tools is installed.
+        Enable pre-standby scripts to run when VMware Tools is installed. Default: `true`.
         """
         return pulumi.get(self, "run_tools_scripts_before_guest_standby")
 
@@ -1036,6 +1094,11 @@ class VirtualMachineArgs:
     @property
     @pulumi.getter(name="sataControllerCount")
     def sata_controller_count(self) -> Optional[pulumi.Input[int]]:
+        """
+        The number of SATA controllers that Terraform manages on this virtual machine. This directly affects the amount of disks
+        you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove
+        controllers.
+        """
         return pulumi.get(self, "sata_controller_count")
 
     @sata_controller_count.setter
@@ -1046,7 +1109,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="scsiBusSharing")
     def scsi_bus_sharing(self) -> Optional[pulumi.Input[str]]:
         """
-        Mode for sharing the SCSI bus. The modes are physicalSharing, virtualSharing, and noSharing.
+        The type of SCSI bus sharing for the virtual machine SCSI controller. One of `physicalSharing`, `virtualSharing`, and `noSharing`. Default: `noSharing`.
         """
         return pulumi.get(self, "scsi_bus_sharing")
 
@@ -1057,6 +1120,11 @@ class VirtualMachineArgs:
     @property
     @pulumi.getter(name="scsiControllerCount")
     def scsi_controller_count(self) -> Optional[pulumi.Input[int]]:
+        """
+        The number of SCSI controllers that Terraform manages on this virtual machine. This directly affects the amount of disks
+        you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove
+        controllers.
+        """
         return pulumi.get(self, "scsi_controller_count")
 
     @scsi_controller_count.setter
@@ -1067,7 +1135,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="scsiType")
     def scsi_type(self) -> Optional[pulumi.Input[str]]:
         """
-        The type of SCSI bus this virtual machine will have. Can be one of lsilogic, lsilogic-sas or pvscsi.
+        The SCSI controller type for the virtual machine. One of `lsilogic` (LSI Logic Parallel), `lsilogic-sas` (LSI Logic SAS) or `pvscsi` (VMware Paravirtual). Default: `pvscsi`.
         """
         return pulumi.get(self, "scsi_type")
 
@@ -1079,7 +1147,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="shutdownWaitTimeout")
     def shutdown_wait_timeout(self) -> Optional[pulumi.Input[int]]:
         """
-        The amount of time, in minutes, to wait for shutdown when making necessary updates to the virtual machine.
+        The amount of time, in minutes, to wait for a graceful guest shutdown when making necessary updates to the virtual machine. If `force_power_off` is set to `true`, the virtual machine will be forced to power-off after the timeout, otherwise an error is returned. Default: `3` minutes.
         """
         return pulumi.get(self, "shutdown_wait_timeout")
 
@@ -1091,7 +1159,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="storagePolicyId")
     def storage_policy_id(self) -> Optional[pulumi.Input[str]]:
         """
-        The ID of the storage policy to assign to the virtual machine home directory.
+        The UUID of the storage policy to assign to the virtual disk.
         """
         return pulumi.get(self, "storage_policy_id")
 
@@ -1103,7 +1171,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="swapPlacementPolicy")
     def swap_placement_policy(self) -> Optional[pulumi.Input[str]]:
         """
-        The swap file placement policy for this virtual machine. Can be one of inherit, hostLocal, or vmDirectory.
+        The swap file placement policy for the virtual machine. One of `inherit`, `hostLocal`, or `vmDirectory`. Default: `inherit`.
         """
         return pulumi.get(self, "swap_placement_policy")
 
@@ -1115,8 +1183,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="syncTimeWithHost")
     def sync_time_with_host(self) -> Optional[pulumi.Input[bool]]:
         """
-        Enable guest clock synchronization with the host. On vSphere 7.0 U1 and above, with only this setting the clock is
-        synchronized on startup and resume. Requires VMware Tools to be installed.
+        Enable the guest operating system to synchronization its clock with the host when the virtual machine is powered on or resumed. Requires vSphere 7.0 Update 1 and later. Requires VMware Tools to be installed. Default: `true`.
         """
         return pulumi.get(self, "sync_time_with_host")
 
@@ -1128,8 +1195,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="syncTimeWithHostPeriodically")
     def sync_time_with_host_periodically(self) -> Optional[pulumi.Input[bool]]:
         """
-        Enable periodic clock synchronization with the host. Supported only on vSphere 7.0 U1 and above. On prior versions
-        setting `sync_time_with_host` is enough for periodic synchronization. Requires VMware Tools to be installed.
+        Enable the guest operating system to periodically synchronize its clock with the host. Requires vSphere 7.0 Update 1 and later. On previous versions, setting `sync_time_with_host` is will enable periodic synchronization. Requires VMware Tools to be installed. Default: `false`.
         """
         return pulumi.get(self, "sync_time_with_host_periodically")
 
@@ -1141,7 +1207,9 @@ class VirtualMachineArgs:
     @pulumi.getter
     def tags(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
         """
-        A list of tag IDs to apply to this object.
+        The IDs of any tags to attach to this resource. Please refer to the `Tag` resource for more information on applying tags to virtual machine resources.
+
+        > **NOTE:** Tagging support is unsupported on direct ESXi host connections and requires vCenter Server instance.
         """
         return pulumi.get(self, "tags")
 
@@ -1153,7 +1221,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="toolsUpgradePolicy")
     def tools_upgrade_policy(self) -> Optional[pulumi.Input[str]]:
         """
-        Set the upgrade policy for VMware Tools. Can be one of `manual` or `upgradeAtPowerCycle`.
+        Enable automatic upgrade of the VMware Tools version when the virtual machine is rebooted. If necessary, VMware Tools is upgraded to the latest version supported by the host on which the virtual machine is running. Requires VMware Tools to be installed. One of `manual` or `upgradeAtPowerCycle`. Default: `manual`.
         """
         return pulumi.get(self, "tools_upgrade_policy")
 
@@ -1165,7 +1233,7 @@ class VirtualMachineArgs:
     @pulumi.getter
     def vapp(self) -> Optional[pulumi.Input['VirtualMachineVappArgs']]:
         """
-        vApp configuration data for this virtual machine. Can be used to provide configuration data for OVF images.
+        Used for vApp configurations. The only sub-key available is `properties`, which is a key/value map of properties for virtual machines imported from and OVF/OVA. See Using vApp Properties for OVF/OVA Configuration for more information.
         """
         return pulumi.get(self, "vapp")
 
@@ -1177,7 +1245,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="vbsEnabled")
     def vbs_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        Flag to specify if Virtualization-based security is enabled for this virtual machine.
+        Enable Virtualization Based Security. Requires `firmware` to be `efi`. In addition, `vvtd_enabled`, `nested_hv_enabled`, and `efi_secure_boot_enabled` must all have a value of `true`. Supported on vSphere 6.7 and later. Default: `false`.
         """
         return pulumi.get(self, "vbs_enabled")
 
@@ -1189,8 +1257,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="vvtdEnabled")
     def vvtd_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        Flag to specify if I/O MMU virtualization, also called Intel Virtualization Technology for Directed I/O (VT-d) and AMD
-        I/O Virtualization (AMD-Vi or IOMMU), is enabled.
+        Enable Intel Virtualization Technology for Directed I/O for the virtual machine (_I/O MMU_ in the vSphere Client). Supported on vSphere 6.7 and later. Default: `false`.
         """
         return pulumi.get(self, "vvtd_enabled")
 
@@ -1202,8 +1269,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="waitForGuestIpTimeout")
     def wait_for_guest_ip_timeout(self) -> Optional[pulumi.Input[int]]:
         """
-        The amount of time, in minutes, to wait for an available IP address on this virtual machine. A value less than 1
-        disables the waiter.
+        The amount of time, in minutes, to wait for an available guest IP address on the virtual machine. This should only be used if the version VMware Tools does not allow the `wait_for_guest_net_timeout` waiter to be used. A value less than `1` disables the waiter. Default: `0`.
         """
         return pulumi.get(self, "wait_for_guest_ip_timeout")
 
@@ -1215,8 +1281,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="waitForGuestNetRoutable")
     def wait_for_guest_net_routable(self) -> Optional[pulumi.Input[bool]]:
         """
-        Controls whether or not the guest network waiter waits for a routable address. When false, the waiter does not wait for
-        a default gateway, nor are IP addresses checked against any discovered default gateways as part of its success criteria.
+        Controls whether or not the guest network waiter waits for a routable address. When `false`, the waiter does not wait for a default gateway, nor are IP addresses checked against any discovered default gateways as part of its success criteria. This property is ignored if the `wait_for_guest_ip_timeout` waiter is used. Default: `true`.
         """
         return pulumi.get(self, "wait_for_guest_net_routable")
 
@@ -1228,8 +1293,7 @@ class VirtualMachineArgs:
     @pulumi.getter(name="waitForGuestNetTimeout")
     def wait_for_guest_net_timeout(self) -> Optional[pulumi.Input[int]]:
         """
-        The amount of time, in minutes, to wait for an available IP address on this virtual machine. A value less than 1
-        disables the waiter.
+        The amount of time, in minutes, to wait for an available guest IP address on the virtual machine. Older versions of VMware Tools do not populate this property. In those cases, this waiter can be disabled and the `wait_for_guest_ip_timeout` waiter can be used instead. A value less than `1` disables the waiter. Default: `5` minutes.
         """
         return pulumi.get(self, "wait_for_guest_net_timeout")
 
@@ -1329,103 +1393,133 @@ class _VirtualMachineState:
                  wait_for_guest_net_timeout: Optional[pulumi.Input[int]] = None):
         """
         Input properties used for looking up and filtering VirtualMachine resources.
-        :param pulumi.Input[str] alternate_guest_name: The guest name for the operating system when guest_id is otherGuest or otherGuest64.
-        :param pulumi.Input[str] annotation: User-provided description of the virtual machine.
-        :param pulumi.Input[int] boot_delay: The number of milliseconds to wait before starting the boot sequence.
-        :param pulumi.Input[int] boot_retry_delay: The number of milliseconds to wait before retrying the boot sequence. This only valid if boot_retry_enabled is true.
-        :param pulumi.Input[bool] boot_retry_enabled: If set to true, a virtual machine that fails to boot will try again after the delay defined in boot_retry_delay.
-        :param pulumi.Input[Sequence[pulumi.Input['VirtualMachineCdromArgs']]] cdroms: A specification for a CDROM device on this virtual machine.
+        :param pulumi.Input[str] alternate_guest_name: The guest name for the operating system when `guest_id` is `otherGuest` or `otherGuest64`.
+        :param pulumi.Input[str] annotation: A user-provided description of the virtual machine.
+        :param pulumi.Input[int] boot_delay: The number of milliseconds to wait before starting the boot sequence. The default is no delay.
+        :param pulumi.Input[int] boot_retry_delay: The number of milliseconds to wait before retrying the boot sequence. This option is only valid if `boot_retry_enabled` is `true`. Default: `10000` (10 seconds).
+        :param pulumi.Input[bool] boot_retry_enabled: If set to `true`, a virtual machine that fails to boot will try again after the delay defined in `boot_retry_delay`. Default: `false`.
+        :param pulumi.Input[Sequence[pulumi.Input['VirtualMachineCdromArgs']]] cdroms: A specification for a CD-ROM device on the virtual machine. See CD-ROM options for more information.
         :param pulumi.Input[str] change_version: A unique identifier for a given version of the last configuration was applied.
-        :param pulumi.Input['VirtualMachineCloneArgs'] clone: A specification for cloning a virtual machine from template.
-        :param pulumi.Input[bool] cpu_hot_add_enabled: Allow CPUs to be added to this virtual machine while it is running.
-        :param pulumi.Input[bool] cpu_hot_remove_enabled: Allow CPUs to be added to this virtual machine while it is running.
-        :param pulumi.Input[int] cpu_limit: The maximum amount of memory (in MB) or CPU (in MHz) that this virtual machine can consume, regardless of available
-               resources.
-        :param pulumi.Input[bool] cpu_performance_counters_enabled: Enable CPU performance counters on this virtual machine.
-        :param pulumi.Input[int] cpu_reservation: The amount of memory (in MB) or CPU (in MHz) that this virtual machine is guaranteed.
-        :param pulumi.Input[int] cpu_share_count: The amount of shares to allocate to cpu for a custom share level.
-        :param pulumi.Input[str] cpu_share_level: The allocation level for cpu resources. Can be one of high, low, normal, or custom.
-        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] custom_attributes: A list of custom attributes to set on this resource.
-        :param pulumi.Input[str] datacenter_id: The ID of the datacenter where the VM is to be created.
-        :param pulumi.Input[str] datastore_cluster_id: The ID of a datastore cluster to put the virtual machine in.
-        :param pulumi.Input[str] datastore_id: The ID of the virtual machine's datastore. The virtual machine configuration is placed here, along with any virtual
-               disks that are created without datastores.
+        :param pulumi.Input['VirtualMachineCloneArgs'] clone: When specified, the virtual machine will be created as a clone of a specified template. Optional customization options can be submitted for the resource. See creating a virtual machine from a template for more information.
+        :param pulumi.Input[bool] cpu_hot_add_enabled: Allow CPUs to be added to the virtual machine while it is powered on.
+        :param pulumi.Input[bool] cpu_hot_remove_enabled: Allow CPUs to be removed to the virtual machine while it is powered on.
+        :param pulumi.Input[int] cpu_limit: The maximum amount of CPU (in MHz) that the virtual machine can consume, regardless of available resources. The default is no limit.
+        :param pulumi.Input[bool] cpu_performance_counters_enabled: Enable CPU performance counters on the virtual machine. Default: `false`.
+        :param pulumi.Input[int] cpu_reservation: The amount of CPU (in MHz) that the virtual machine is guaranteed. The default is no reservation.
+        :param pulumi.Input[int] cpu_share_count: The number of CPU shares allocated to the virtual machine when the `cpu_share_level` is `custom`.
+        :param pulumi.Input[str] cpu_share_level: The allocation level for the virtual machine CPU resources. One of `high`, `low`, `normal`, or `custom`. Default: `custom`.
+        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] custom_attributes: Map of custom attribute ids to attribute value strings to set for virtual machine. Please refer to the `vsphere_custom_attributes` resource for more information on setting custom attributes.
+               
+               > **NOTE:** Custom attributes requires vCenter Server and is not supported on direct ESXi host connections.
+        :param pulumi.Input[str] datacenter_id: The datacenter ID. Required only when deploying an OVF/OVA template.
+        :param pulumi.Input[str] datastore_cluster_id: The managed object reference ID of the datastore cluster in which to place the virtual machine. This setting applies to entire virtual machine and implies that you wish to use vSphere Storage DRS with the virtual machine. See the section on virtual machine migration for more information on modifying this value.
+               
+               > **NOTE:** One of `datastore_id` or `datastore_cluster_id` must be specified.
+               
+               > **NOTE:** Use of `datastore_cluster_id` requires vSphere Storage DRS to be enabled on the specified datastore cluster.
+               
+               > **NOTE:** The `datastore_cluster_id` setting applies to the entire virtual machine resource. You cannot assign individual individual disks to datastore clusters. In addition, you cannot use the `attach` setting to attach external disks on virtual machines that are assigned to datastore clusters.
+        :param pulumi.Input[str] datastore_id: The datastore ID that on which the ISO is located. Required for using a datastore ISO. Conflicts with `client_device`.
         :param pulumi.Input[str] default_ip_address: The IP address selected by the provider to be used with any provisioners configured on this resource. When possible, this is the first IPv4 address that is reachable through the default gateway configured on the machine, then the first reachable IPv6 address, and then the first general discovered address if neither exists. If  VMware Tools is not running on the virtual machine, or if the virtual machine is powered off, this value will be blank.
-        :param pulumi.Input[Sequence[pulumi.Input['VirtualMachineDiskArgs']]] disks: A specification for a virtual disk device on this virtual machine.
-        :param pulumi.Input[bool] efi_secure_boot_enabled: When the boot type set in firmware is efi, this enables EFI secure boot.
-        :param pulumi.Input[bool] enable_disk_uuid: Expose the UUIDs of attached virtual disks to the virtual machine, allowing access to them in the guest.
-        :param pulumi.Input[bool] enable_logging: Enable logging on this virtual machine.
-        :param pulumi.Input[str] ept_rvi_mode: The EPT/RVI (hardware memory virtualization) setting for this virtual machine. Can be one of automatic, on, or off.
-        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] extra_config: Extra configuration data for this virtual machine. Can be used to supply advanced parameters not normally in
-               configuration, such as instance metadata, or configuration data for OVF images.
-        :param pulumi.Input[bool] extra_config_reboot_required: Allow the virtual machine to be rebooted when a change to `extra_config` occurs.
-        :param pulumi.Input[str] firmware: The firmware interface to use on the virtual machine. Can be one of bios or efi.
-        :param pulumi.Input[str] folder: The name of the folder to locate the virtual machine in.
-        :param pulumi.Input[bool] force_power_off: Set to true to force power-off a virtual machine if a graceful guest shutdown failed for a necessary operation.
-        :param pulumi.Input[str] guest_id: The guest ID for the operating system.
+        :param pulumi.Input[Sequence[pulumi.Input['VirtualMachineDiskArgs']]] disks: A specification for a virtual disk device on the virtual machine. See disk options for more information.
+        :param pulumi.Input[bool] efi_secure_boot_enabled: Use this option to enable EFI secure boot when the `firmware` type is set to is `efi`. Default: `false`.
+               
+               > **NOTE:** EFI secure boot is only available on vSphere 6.5 and later.
+        :param pulumi.Input[bool] enable_disk_uuid: Expose the UUIDs of attached virtual disks to the virtual machine, allowing access to them in the guest. Default: `false`.
+        :param pulumi.Input[bool] enable_logging: Enable logging of virtual machine events to a log file stored in the virtual machine directory. Default: `false`.
+        :param pulumi.Input[str] ept_rvi_mode: The EPT/RVI (hardware memory virtualization) setting for the virtual machine. One of `automatic`, `on`, or `off`. Default: `automatic`.
+        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] extra_config: Extra configuration data for the virtual machine. Can be used to supply advanced parameters not normally in configuration, such as instance metadata and userdata.
+               
+               > **NOTE:** Do not use `extra_config` when working with a template imported from OVF/OVA as your settings may be ignored. Use the `vapp` block `properties` section as described in Using vApp Properties for OVF/OVA Configuration.
+        :param pulumi.Input[bool] extra_config_reboot_required: Allow the virtual machine to be rebooted when a change to `extra_config` occurs. Default: `true`.
+        :param pulumi.Input[str] firmware: The firmware for the virtual machine. One of `bios` or `efi`.
+        :param pulumi.Input[str] folder: The path to the virtual machine folder in which to place the virtual machine, relative to the datacenter path (`/<datacenter-name>/vm`).  For example, `/dc-01/vm/foo`
+        :param pulumi.Input[bool] force_power_off: If a guest shutdown failed or times out while updating or destroying (see `shutdown_wait_timeout`), force the power-off of the virtual machine. Default: `true`.
+        :param pulumi.Input[str] guest_id: The guest ID for the operating system type. For a full list of possible values, see [here][vmware-docs-guest-ids]. Default: `otherGuest64`.
+               
+               [vmware-docs-guest-ids]: https://vdc-repo.vmware.com/vmwb-repository/dcr-public/184bb3ba-6fa8-4574-a767-d0c96e2a38f4/ba9422ef-405c-47dd-8553-e11b619185b2/SDK/vsphere-ws/docs/ReferenceGuide/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html
         :param pulumi.Input[Sequence[pulumi.Input[str]]] guest_ip_addresses: The current list of IP addresses on this machine, including the value of `default_ip_address`. If VMware Tools is not running on the virtual machine, or if the virtul machine is powered off, this list will be empty.
-        :param pulumi.Input[int] hardware_version: The hardware version for the virtual machine.
-        :param pulumi.Input[str] host_system_id: The ID of an optional host system to pin the virtual machine to.
-        :param pulumi.Input[str] hv_mode: The (non-nested) hardware virtualization setting for this virtual machine. Can be one of hvAuto, hvOn, or hvOff.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] ignored_guest_ips: List of IP addresses and CIDR networks to ignore while waiting for an IP
+        :param pulumi.Input[int] hardware_version: The hardware version number. Valid range is from 4 to 21. The hardware version cannot be downgraded. See virtual machine hardware [versions][virtual-machine-hardware-versions] and [compatibility][virtual-machine-hardware-compatibility] for more information on supported settings.
+               
+               [virtual-machine-hardware-versions]: https://kb.vmware.com/s/article/1003746
+               [virtual-machine-hardware-compatibility]: https://kb.vmware.com/s/article/2007240
+        :param pulumi.Input[str] host_system_id: The managed object reference ID of a host on which to place the virtual machine. See the section on virtual machine migration for more information on modifying this value. When using a vSphere cluster, if a `host_system_id` is not supplied, vSphere will select a host in the cluster to place the virtual machine, according to any defaults or vSphere DRS placement policies.
+        :param pulumi.Input[str] hv_mode: The hardware virtualization (non-nested) setting for the virtual machine. One of `hvAuto`, `hvOn`, or `hvOff`. Default: `hvAuto`.
+        :param pulumi.Input[int] ide_controller_count: The number of IDE controllers that the virtual machine. This directly affects the number of disks you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove controllers. Default: `2`.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] ignored_guest_ips: List of IP addresses and CIDR networks to ignore while waiting for an available IP address using either of the waiters. Any IP addresses in this list will be ignored so that the waiter will continue to wait for a valid IP address. Default: `[]`.
         :param pulumi.Input[bool] imported: Indicates if the virtual machine resource has been imported, or if the state has been migrated from a previous version of the resource. It influences the behavior of the first post-import apply operation. See the section on importing below.
-        :param pulumi.Input[str] latency_sensitivity: Controls the scheduling delay of the virtual machine. Use a higher sensitivity for applications that require lower
-               latency, such as VOIP, media player applications, or applications that require frequent access to mouse or keyboard
-               devices. Can be one of low, normal, medium, or high.
-        :param pulumi.Input[int] memory: The size of the virtual machine's memory, in MB.
-        :param pulumi.Input[bool] memory_hot_add_enabled: Allow memory to be added to this virtual machine while it is running.
-        :param pulumi.Input[int] memory_limit: The maximum amount of memory (in MB) or CPU (in MHz) that this virtual machine can consume, regardless of available
-               resources.
-        :param pulumi.Input[int] memory_reservation: The amount of memory (in MB) or CPU (in MHz) that this virtual machine is guaranteed.
+        :param pulumi.Input[str] latency_sensitivity: Controls the scheduling delay of the virtual machine. Use a higher sensitivity for applications that require lower latency, such as VOIP, media player applications, or applications that require frequent access to mouse or keyboard devices. One of `low`, `normal`, `medium`, or `high`.
+               
+               > **NOTE:** On higher sensitivities, you may need to adjust the `memory_reservation` to the full amount of memory provisioned for the virtual machine.
+        :param pulumi.Input[int] memory: The memory size to assign to the virtual machine, in MB. Default: `1024` (1 GB).
+        :param pulumi.Input[bool] memory_hot_add_enabled: Allow memory to be added to the virtual machine while it is powered on.
+               
+               > **NOTE:** CPU and memory hot add options are not available on all guest operating systems. Please refer to the [VMware Guest OS Compatibility Guide][vmware-docs-compat-guide] to which settings are allow for your guest operating system. In addition, at least one `pulumi up` must be run before you are able to use CPU and memory hot add.
+               
+               [vmware-docs-compat-guide]: http://partnerweb.vmware.com/comp_guide2/pdf/VMware_GOS_Compatibility_Guide.pdf
+               
+               > **NOTE:** For Linux 64-bit guest operating systems with less than or equal to 3GB, the virtual machine must powered off to add memory beyond 3GB. Subsequent hot add of memory does not require the virtual machine to be powered-off to apply the plan. Please refer to [VMware KB 2008405][vmware-kb-2008405].
+               
+               [vmware-kb-2008405]: https://kb.vmware.com/s/article/2008405
+        :param pulumi.Input[int] memory_limit: The maximum amount of memory (in MB) that th virtual machine can consume, regardless of available resources. The default is no limit.
+        :param pulumi.Input[int] memory_reservation: The amount of memory (in MB) that the virtual machine is guaranteed. The default is no reservation.
         :param pulumi.Input[bool] memory_reservation_locked_to_max: If set true, memory resource reservation for this virtual machine will always be equal to the virtual machine's memory
                size;increases in memory size will be rejected when a corresponding reservation increase is not possible. This feature
                may only be enabled if it is currently possible to reserve all of the virtual machine's memory.
-        :param pulumi.Input[int] memory_share_count: The amount of shares to allocate to memory for a custom share level.
-        :param pulumi.Input[str] memory_share_level: The allocation level for memory resources. Can be one of high, low, normal, or custom.
-        :param pulumi.Input[int] migrate_wait_timeout: The amount of time, in minutes, to wait for a vMotion operation to complete before failing.
+        :param pulumi.Input[int] memory_share_count: The number of memory shares allocated to the virtual machine when the `memory_share_level` is `custom`.
+        :param pulumi.Input[str] memory_share_level: The allocation level for the virtual machine memory resources. One of `high`, `low`, `normal`, or `custom`. Default: `custom`.
+        :param pulumi.Input[int] migrate_wait_timeout: The amount of time, in minutes, to wait for a virtual machine migration to complete before failing. Default: `10` minutes. See the section on virtual machine migration for more information.
         :param pulumi.Input[str] moid: The managed object reference ID of the created virtual machine.
-        :param pulumi.Input[str] name: The name of this virtual machine.
-        :param pulumi.Input[bool] nested_hv_enabled: Enable nested hardware virtualization on this virtual machine, facilitating nested virtualization in the guest.
-        :param pulumi.Input[Sequence[pulumi.Input['VirtualMachineNetworkInterfaceArgs']]] network_interfaces: A specification for a virtual NIC on this virtual machine.
-        :param pulumi.Input[int] num_cores_per_socket: The number of cores to distribute amongst the CPUs in this virtual machine. If specified, the value supplied to num_cpus
-               must be evenly divisible by this value.
-        :param pulumi.Input[int] num_cpus: The number of virtual processors to assign to this virtual machine.
-        :param pulumi.Input['VirtualMachineOvfDeployArgs'] ovf_deploy: A specification for deploying a virtual machine from ovf/ova template.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] pci_device_ids: A list of PCI passthrough devices
+        :param pulumi.Input[str] name: The name of the virtual machine.
+        :param pulumi.Input[bool] nested_hv_enabled: Enable nested hardware virtualization on the virtual machine, facilitating nested virtualization in the guest operating system. Default: `false`.
+        :param pulumi.Input[Sequence[pulumi.Input['VirtualMachineNetworkInterfaceArgs']]] network_interfaces: A specification for a virtual NIC on the virtual machine. See network interface options for more information.
+        :param pulumi.Input[int] num_cores_per_socket: The number of cores per socket in the virtual machine. The number of vCPUs on the virtual machine will be `num_cpus` divided by `num_cores_per_socket`. If specified, the value supplied to `num_cpus` must be evenly divisible by this value. Default: `1`.
+        :param pulumi.Input[int] num_cpus: The total number of virtual processor cores to assign to the virtual machine. Default: `1`.
+        :param pulumi.Input['VirtualMachineOvfDeployArgs'] ovf_deploy: When specified, the virtual machine will be deployed from the provided OVF/OVA template. See creating a virtual machine from an OVF/OVA template for more information.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] pci_device_ids: List of host PCI device IDs in which to create PCI passthroughs.
+               
+               > **NOTE:** Cloning requires vCenter Server and is not supported on direct ESXi host connections.
         :param pulumi.Input[str] power_state: A computed value for the current power state of the virtual machine. One of `on`, `off`, or `suspended`.
         :param pulumi.Input[int] poweron_timeout: The amount of time, in seconds, that we will be trying to power on a VM
+        :param pulumi.Input[bool] reboot_required: Value internal to Terraform used to determine if a configuration set change requires a reboot.
         :param pulumi.Input[str] replace_trigger: Triggers replacement of resource whenever it changes.
-        :param pulumi.Input[str] resource_pool_id: The ID of a resource pool to put the virtual machine in.
-        :param pulumi.Input[bool] run_tools_scripts_after_power_on: Enable the run of scripts after virtual machine power-on when VMware Tools is installed.
-        :param pulumi.Input[bool] run_tools_scripts_after_resume: Enable the run of scripts after virtual machine resume when when VMware Tools is installed.
-        :param pulumi.Input[bool] run_tools_scripts_before_guest_reboot: Enable the run of scripts before guest operating system reboot when VMware Tools is installed.
-        :param pulumi.Input[bool] run_tools_scripts_before_guest_shutdown: Enable the run of scripts before guest operating system shutdown when VMware Tools is installed.
-        :param pulumi.Input[bool] run_tools_scripts_before_guest_standby: Enable the run of scripts before guest operating system standby when VMware Tools is installed.
-        :param pulumi.Input[str] scsi_bus_sharing: Mode for sharing the SCSI bus. The modes are physicalSharing, virtualSharing, and noSharing.
-        :param pulumi.Input[str] scsi_type: The type of SCSI bus this virtual machine will have. Can be one of lsilogic, lsilogic-sas or pvscsi.
-        :param pulumi.Input[int] shutdown_wait_timeout: The amount of time, in minutes, to wait for shutdown when making necessary updates to the virtual machine.
-        :param pulumi.Input[str] storage_policy_id: The ID of the storage policy to assign to the virtual machine home directory.
-        :param pulumi.Input[str] swap_placement_policy: The swap file placement policy for this virtual machine. Can be one of inherit, hostLocal, or vmDirectory.
-        :param pulumi.Input[bool] sync_time_with_host: Enable guest clock synchronization with the host. On vSphere 7.0 U1 and above, with only this setting the clock is
-               synchronized on startup and resume. Requires VMware Tools to be installed.
-        :param pulumi.Input[bool] sync_time_with_host_periodically: Enable periodic clock synchronization with the host. Supported only on vSphere 7.0 U1 and above. On prior versions
-               setting `sync_time_with_host` is enough for periodic synchronization. Requires VMware Tools to be installed.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: A list of tag IDs to apply to this object.
-        :param pulumi.Input[str] tools_upgrade_policy: Set the upgrade policy for VMware Tools. Can be one of `manual` or `upgradeAtPowerCycle`.
-        :param pulumi.Input[str] uuid: The UUID of the virtual machine. Also exposed as the `id` of the resource.
-        :param pulumi.Input['VirtualMachineVappArgs'] vapp: vApp configuration data for this virtual machine. Can be used to provide configuration data for OVF images.
+               
+               For example, `replace_trigger = sha256(format("%!s(MISSING)-%!s(MISSING)",data.template_file.cloud_init_metadata.rendered,data.template_file.cloud_init_userdata.rendered))` will fingerprint the changes in cloud-init metadata and userdata templates. This will enable a replacement of the resource whenever the dependant template renders a new configuration. (Forces a replacement.)
+        :param pulumi.Input[str] resource_pool_id: The managed object reference ID of the resource pool in which to place the virtual machine. See the Virtual Machine Migration section for more information on modifying this value.
+               
+               > **NOTE:** All clusters and standalone hosts have a default root resource pool. This resource argument does not directly accept the cluster or standalone host resource. For more information, see the section on specifying the Root Resource Pool in the `ResourcePool` data source documentation on using the root resource pool.
+        :param pulumi.Input[bool] run_tools_scripts_after_power_on: Enable post-power-on scripts to run when VMware Tools is installed. Default: `true`.
+        :param pulumi.Input[bool] run_tools_scripts_after_resume: Enable ost-resume scripts to run when VMware Tools is installed. Default: `true`.
+        :param pulumi.Input[bool] run_tools_scripts_before_guest_reboot: Enable pre-reboot scripts to run when VMware Tools is installed. Default: `false`.
+        :param pulumi.Input[bool] run_tools_scripts_before_guest_shutdown: Enable pre-shutdown scripts to run when VMware Tools is installed. Default: `true`.
+        :param pulumi.Input[bool] run_tools_scripts_before_guest_standby: Enable pre-standby scripts to run when VMware Tools is installed. Default: `true`.
+        :param pulumi.Input[int] sata_controller_count: The number of SATA controllers that Terraform manages on this virtual machine. This directly affects the amount of disks
+               you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove
+               controllers.
+        :param pulumi.Input[str] scsi_bus_sharing: The type of SCSI bus sharing for the virtual machine SCSI controller. One of `physicalSharing`, `virtualSharing`, and `noSharing`. Default: `noSharing`.
+        :param pulumi.Input[int] scsi_controller_count: The number of SCSI controllers that Terraform manages on this virtual machine. This directly affects the amount of disks
+               you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove
+               controllers.
+        :param pulumi.Input[str] scsi_type: The SCSI controller type for the virtual machine. One of `lsilogic` (LSI Logic Parallel), `lsilogic-sas` (LSI Logic SAS) or `pvscsi` (VMware Paravirtual). Default: `pvscsi`.
+        :param pulumi.Input[int] shutdown_wait_timeout: The amount of time, in minutes, to wait for a graceful guest shutdown when making necessary updates to the virtual machine. If `force_power_off` is set to `true`, the virtual machine will be forced to power-off after the timeout, otherwise an error is returned. Default: `3` minutes.
+        :param pulumi.Input[str] storage_policy_id: The UUID of the storage policy to assign to the virtual disk.
+        :param pulumi.Input[str] swap_placement_policy: The swap file placement policy for the virtual machine. One of `inherit`, `hostLocal`, or `vmDirectory`. Default: `inherit`.
+        :param pulumi.Input[bool] sync_time_with_host: Enable the guest operating system to synchronization its clock with the host when the virtual machine is powered on or resumed. Requires vSphere 7.0 Update 1 and later. Requires VMware Tools to be installed. Default: `true`.
+        :param pulumi.Input[bool] sync_time_with_host_periodically: Enable the guest operating system to periodically synchronize its clock with the host. Requires vSphere 7.0 Update 1 and later. On previous versions, setting `sync_time_with_host` is will enable periodic synchronization. Requires VMware Tools to be installed. Default: `false`.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource. Please refer to the `Tag` resource for more information on applying tags to virtual machine resources.
+               
+               > **NOTE:** Tagging support is unsupported on direct ESXi host connections and requires vCenter Server instance.
+        :param pulumi.Input[str] tools_upgrade_policy: Enable automatic upgrade of the VMware Tools version when the virtual machine is rebooted. If necessary, VMware Tools is upgraded to the latest version supported by the host on which the virtual machine is running. Requires VMware Tools to be installed. One of `manual` or `upgradeAtPowerCycle`. Default: `manual`.
+        :param pulumi.Input[str] uuid: The UUID of the virtual disk VMDK file. This is used to track the virtual disk on the virtual machine.
+        :param pulumi.Input['VirtualMachineVappArgs'] vapp: Used for vApp configurations. The only sub-key available is `properties`, which is a key/value map of properties for virtual machines imported from and OVF/OVA. See Using vApp Properties for OVF/OVA Configuration for more information.
         :param pulumi.Input[Sequence[pulumi.Input[str]]] vapp_transports: Computed value which is only valid for cloned virtual machines. A list of vApp transport methods supported by the source virtual machine or template.
-        :param pulumi.Input[bool] vbs_enabled: Flag to specify if Virtualization-based security is enabled for this virtual machine.
+        :param pulumi.Input[bool] vbs_enabled: Enable Virtualization Based Security. Requires `firmware` to be `efi`. In addition, `vvtd_enabled`, `nested_hv_enabled`, and `efi_secure_boot_enabled` must all have a value of `true`. Supported on vSphere 6.7 and later. Default: `false`.
         :param pulumi.Input[str] vmware_tools_status: The state of  VMware Tools in the guest. This will determine the proper course of action for some device operations.
         :param pulumi.Input[str] vmx_path: The path of the virtual machine configuration file on the datastore in which the virtual machine is placed.
-        :param pulumi.Input[bool] vvtd_enabled: Flag to specify if I/O MMU virtualization, also called Intel Virtualization Technology for Directed I/O (VT-d) and AMD
-               I/O Virtualization (AMD-Vi or IOMMU), is enabled.
-        :param pulumi.Input[int] wait_for_guest_ip_timeout: The amount of time, in minutes, to wait for an available IP address on this virtual machine. A value less than 1
-               disables the waiter.
-        :param pulumi.Input[bool] wait_for_guest_net_routable: Controls whether or not the guest network waiter waits for a routable address. When false, the waiter does not wait for
-               a default gateway, nor are IP addresses checked against any discovered default gateways as part of its success criteria.
-        :param pulumi.Input[int] wait_for_guest_net_timeout: The amount of time, in minutes, to wait for an available IP address on this virtual machine. A value less than 1
-               disables the waiter.
+        :param pulumi.Input[bool] vvtd_enabled: Enable Intel Virtualization Technology for Directed I/O for the virtual machine (_I/O MMU_ in the vSphere Client). Supported on vSphere 6.7 and later. Default: `false`.
+        :param pulumi.Input[int] wait_for_guest_ip_timeout: The amount of time, in minutes, to wait for an available guest IP address on the virtual machine. This should only be used if the version VMware Tools does not allow the `wait_for_guest_net_timeout` waiter to be used. A value less than `1` disables the waiter. Default: `0`.
+        :param pulumi.Input[bool] wait_for_guest_net_routable: Controls whether or not the guest network waiter waits for a routable address. When `false`, the waiter does not wait for a default gateway, nor are IP addresses checked against any discovered default gateways as part of its success criteria. This property is ignored if the `wait_for_guest_ip_timeout` waiter is used. Default: `true`.
+        :param pulumi.Input[int] wait_for_guest_net_timeout: The amount of time, in minutes, to wait for an available guest IP address on the virtual machine. Older versions of VMware Tools do not populate this property. In those cases, this waiter can be disabled and the `wait_for_guest_ip_timeout` waiter can be used instead. A value less than `1` disables the waiter. Default: `5` minutes.
         """
         if alternate_guest_name is not None:
             pulumi.set(__self__, "alternate_guest_name", alternate_guest_name)
@@ -1604,7 +1698,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="alternateGuestName")
     def alternate_guest_name(self) -> Optional[pulumi.Input[str]]:
         """
-        The guest name for the operating system when guest_id is otherGuest or otherGuest64.
+        The guest name for the operating system when `guest_id` is `otherGuest` or `otherGuest64`.
         """
         return pulumi.get(self, "alternate_guest_name")
 
@@ -1616,7 +1710,7 @@ class _VirtualMachineState:
     @pulumi.getter
     def annotation(self) -> Optional[pulumi.Input[str]]:
         """
-        User-provided description of the virtual machine.
+        A user-provided description of the virtual machine.
         """
         return pulumi.get(self, "annotation")
 
@@ -1628,7 +1722,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="bootDelay")
     def boot_delay(self) -> Optional[pulumi.Input[int]]:
         """
-        The number of milliseconds to wait before starting the boot sequence.
+        The number of milliseconds to wait before starting the boot sequence. The default is no delay.
         """
         return pulumi.get(self, "boot_delay")
 
@@ -1640,7 +1734,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="bootRetryDelay")
     def boot_retry_delay(self) -> Optional[pulumi.Input[int]]:
         """
-        The number of milliseconds to wait before retrying the boot sequence. This only valid if boot_retry_enabled is true.
+        The number of milliseconds to wait before retrying the boot sequence. This option is only valid if `boot_retry_enabled` is `true`. Default: `10000` (10 seconds).
         """
         return pulumi.get(self, "boot_retry_delay")
 
@@ -1652,7 +1746,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="bootRetryEnabled")
     def boot_retry_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        If set to true, a virtual machine that fails to boot will try again after the delay defined in boot_retry_delay.
+        If set to `true`, a virtual machine that fails to boot will try again after the delay defined in `boot_retry_delay`. Default: `false`.
         """
         return pulumi.get(self, "boot_retry_enabled")
 
@@ -1664,7 +1758,7 @@ class _VirtualMachineState:
     @pulumi.getter
     def cdroms(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['VirtualMachineCdromArgs']]]]:
         """
-        A specification for a CDROM device on this virtual machine.
+        A specification for a CD-ROM device on the virtual machine. See CD-ROM options for more information.
         """
         return pulumi.get(self, "cdroms")
 
@@ -1688,7 +1782,7 @@ class _VirtualMachineState:
     @pulumi.getter
     def clone(self) -> Optional[pulumi.Input['VirtualMachineCloneArgs']]:
         """
-        A specification for cloning a virtual machine from template.
+        When specified, the virtual machine will be created as a clone of a specified template. Optional customization options can be submitted for the resource. See creating a virtual machine from a template for more information.
         """
         return pulumi.get(self, "clone")
 
@@ -1700,7 +1794,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="cpuHotAddEnabled")
     def cpu_hot_add_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        Allow CPUs to be added to this virtual machine while it is running.
+        Allow CPUs to be added to the virtual machine while it is powered on.
         """
         return pulumi.get(self, "cpu_hot_add_enabled")
 
@@ -1712,7 +1806,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="cpuHotRemoveEnabled")
     def cpu_hot_remove_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        Allow CPUs to be added to this virtual machine while it is running.
+        Allow CPUs to be removed to the virtual machine while it is powered on.
         """
         return pulumi.get(self, "cpu_hot_remove_enabled")
 
@@ -1724,8 +1818,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="cpuLimit")
     def cpu_limit(self) -> Optional[pulumi.Input[int]]:
         """
-        The maximum amount of memory (in MB) or CPU (in MHz) that this virtual machine can consume, regardless of available
-        resources.
+        The maximum amount of CPU (in MHz) that the virtual machine can consume, regardless of available resources. The default is no limit.
         """
         return pulumi.get(self, "cpu_limit")
 
@@ -1737,7 +1830,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="cpuPerformanceCountersEnabled")
     def cpu_performance_counters_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        Enable CPU performance counters on this virtual machine.
+        Enable CPU performance counters on the virtual machine. Default: `false`.
         """
         return pulumi.get(self, "cpu_performance_counters_enabled")
 
@@ -1749,7 +1842,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="cpuReservation")
     def cpu_reservation(self) -> Optional[pulumi.Input[int]]:
         """
-        The amount of memory (in MB) or CPU (in MHz) that this virtual machine is guaranteed.
+        The amount of CPU (in MHz) that the virtual machine is guaranteed. The default is no reservation.
         """
         return pulumi.get(self, "cpu_reservation")
 
@@ -1761,7 +1854,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="cpuShareCount")
     def cpu_share_count(self) -> Optional[pulumi.Input[int]]:
         """
-        The amount of shares to allocate to cpu for a custom share level.
+        The number of CPU shares allocated to the virtual machine when the `cpu_share_level` is `custom`.
         """
         return pulumi.get(self, "cpu_share_count")
 
@@ -1773,7 +1866,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="cpuShareLevel")
     def cpu_share_level(self) -> Optional[pulumi.Input[str]]:
         """
-        The allocation level for cpu resources. Can be one of high, low, normal, or custom.
+        The allocation level for the virtual machine CPU resources. One of `high`, `low`, `normal`, or `custom`. Default: `custom`.
         """
         return pulumi.get(self, "cpu_share_level")
 
@@ -1785,7 +1878,9 @@ class _VirtualMachineState:
     @pulumi.getter(name="customAttributes")
     def custom_attributes(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]:
         """
-        A list of custom attributes to set on this resource.
+        Map of custom attribute ids to attribute value strings to set for virtual machine. Please refer to the `vsphere_custom_attributes` resource for more information on setting custom attributes.
+
+        > **NOTE:** Custom attributes requires vCenter Server and is not supported on direct ESXi host connections.
         """
         return pulumi.get(self, "custom_attributes")
 
@@ -1797,7 +1892,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="datacenterId")
     def datacenter_id(self) -> Optional[pulumi.Input[str]]:
         """
-        The ID of the datacenter where the VM is to be created.
+        The datacenter ID. Required only when deploying an OVF/OVA template.
         """
         return pulumi.get(self, "datacenter_id")
 
@@ -1809,7 +1904,13 @@ class _VirtualMachineState:
     @pulumi.getter(name="datastoreClusterId")
     def datastore_cluster_id(self) -> Optional[pulumi.Input[str]]:
         """
-        The ID of a datastore cluster to put the virtual machine in.
+        The managed object reference ID of the datastore cluster in which to place the virtual machine. This setting applies to entire virtual machine and implies that you wish to use vSphere Storage DRS with the virtual machine. See the section on virtual machine migration for more information on modifying this value.
+
+        > **NOTE:** One of `datastore_id` or `datastore_cluster_id` must be specified.
+
+        > **NOTE:** Use of `datastore_cluster_id` requires vSphere Storage DRS to be enabled on the specified datastore cluster.
+
+        > **NOTE:** The `datastore_cluster_id` setting applies to the entire virtual machine resource. You cannot assign individual individual disks to datastore clusters. In addition, you cannot use the `attach` setting to attach external disks on virtual machines that are assigned to datastore clusters.
         """
         return pulumi.get(self, "datastore_cluster_id")
 
@@ -1821,8 +1922,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="datastoreId")
     def datastore_id(self) -> Optional[pulumi.Input[str]]:
         """
-        The ID of the virtual machine's datastore. The virtual machine configuration is placed here, along with any virtual
-        disks that are created without datastores.
+        The datastore ID that on which the ISO is located. Required for using a datastore ISO. Conflicts with `client_device`.
         """
         return pulumi.get(self, "datastore_id")
 
@@ -1846,7 +1946,7 @@ class _VirtualMachineState:
     @pulumi.getter
     def disks(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['VirtualMachineDiskArgs']]]]:
         """
-        A specification for a virtual disk device on this virtual machine.
+        A specification for a virtual disk device on the virtual machine. See disk options for more information.
         """
         return pulumi.get(self, "disks")
 
@@ -1858,7 +1958,9 @@ class _VirtualMachineState:
     @pulumi.getter(name="efiSecureBootEnabled")
     def efi_secure_boot_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        When the boot type set in firmware is efi, this enables EFI secure boot.
+        Use this option to enable EFI secure boot when the `firmware` type is set to is `efi`. Default: `false`.
+
+        > **NOTE:** EFI secure boot is only available on vSphere 6.5 and later.
         """
         return pulumi.get(self, "efi_secure_boot_enabled")
 
@@ -1870,7 +1972,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="enableDiskUuid")
     def enable_disk_uuid(self) -> Optional[pulumi.Input[bool]]:
         """
-        Expose the UUIDs of attached virtual disks to the virtual machine, allowing access to them in the guest.
+        Expose the UUIDs of attached virtual disks to the virtual machine, allowing access to them in the guest. Default: `false`.
         """
         return pulumi.get(self, "enable_disk_uuid")
 
@@ -1882,7 +1984,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="enableLogging")
     def enable_logging(self) -> Optional[pulumi.Input[bool]]:
         """
-        Enable logging on this virtual machine.
+        Enable logging of virtual machine events to a log file stored in the virtual machine directory. Default: `false`.
         """
         return pulumi.get(self, "enable_logging")
 
@@ -1894,7 +1996,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="eptRviMode")
     def ept_rvi_mode(self) -> Optional[pulumi.Input[str]]:
         """
-        The EPT/RVI (hardware memory virtualization) setting for this virtual machine. Can be one of automatic, on, or off.
+        The EPT/RVI (hardware memory virtualization) setting for the virtual machine. One of `automatic`, `on`, or `off`. Default: `automatic`.
         """
         return pulumi.get(self, "ept_rvi_mode")
 
@@ -1906,8 +2008,9 @@ class _VirtualMachineState:
     @pulumi.getter(name="extraConfig")
     def extra_config(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]:
         """
-        Extra configuration data for this virtual machine. Can be used to supply advanced parameters not normally in
-        configuration, such as instance metadata, or configuration data for OVF images.
+        Extra configuration data for the virtual machine. Can be used to supply advanced parameters not normally in configuration, such as instance metadata and userdata.
+
+        > **NOTE:** Do not use `extra_config` when working with a template imported from OVF/OVA as your settings may be ignored. Use the `vapp` block `properties` section as described in Using vApp Properties for OVF/OVA Configuration.
         """
         return pulumi.get(self, "extra_config")
 
@@ -1919,7 +2022,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="extraConfigRebootRequired")
     def extra_config_reboot_required(self) -> Optional[pulumi.Input[bool]]:
         """
-        Allow the virtual machine to be rebooted when a change to `extra_config` occurs.
+        Allow the virtual machine to be rebooted when a change to `extra_config` occurs. Default: `true`.
         """
         return pulumi.get(self, "extra_config_reboot_required")
 
@@ -1931,7 +2034,7 @@ class _VirtualMachineState:
     @pulumi.getter
     def firmware(self) -> Optional[pulumi.Input[str]]:
         """
-        The firmware interface to use on the virtual machine. Can be one of bios or efi.
+        The firmware for the virtual machine. One of `bios` or `efi`.
         """
         return pulumi.get(self, "firmware")
 
@@ -1943,7 +2046,7 @@ class _VirtualMachineState:
     @pulumi.getter
     def folder(self) -> Optional[pulumi.Input[str]]:
         """
-        The name of the folder to locate the virtual machine in.
+        The path to the virtual machine folder in which to place the virtual machine, relative to the datacenter path (`/<datacenter-name>/vm`).  For example, `/dc-01/vm/foo`
         """
         return pulumi.get(self, "folder")
 
@@ -1955,7 +2058,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="forcePowerOff")
     def force_power_off(self) -> Optional[pulumi.Input[bool]]:
         """
-        Set to true to force power-off a virtual machine if a graceful guest shutdown failed for a necessary operation.
+        If a guest shutdown failed or times out while updating or destroying (see `shutdown_wait_timeout`), force the power-off of the virtual machine. Default: `true`.
         """
         return pulumi.get(self, "force_power_off")
 
@@ -1967,7 +2070,9 @@ class _VirtualMachineState:
     @pulumi.getter(name="guestId")
     def guest_id(self) -> Optional[pulumi.Input[str]]:
         """
-        The guest ID for the operating system.
+        The guest ID for the operating system type. For a full list of possible values, see [here][vmware-docs-guest-ids]. Default: `otherGuest64`.
+
+        [vmware-docs-guest-ids]: https://vdc-repo.vmware.com/vmwb-repository/dcr-public/184bb3ba-6fa8-4574-a767-d0c96e2a38f4/ba9422ef-405c-47dd-8553-e11b619185b2/SDK/vsphere-ws/docs/ReferenceGuide/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html
         """
         return pulumi.get(self, "guest_id")
 
@@ -1991,7 +2096,10 @@ class _VirtualMachineState:
     @pulumi.getter(name="hardwareVersion")
     def hardware_version(self) -> Optional[pulumi.Input[int]]:
         """
-        The hardware version for the virtual machine.
+        The hardware version number. Valid range is from 4 to 21. The hardware version cannot be downgraded. See virtual machine hardware [versions][virtual-machine-hardware-versions] and [compatibility][virtual-machine-hardware-compatibility] for more information on supported settings.
+
+        [virtual-machine-hardware-versions]: https://kb.vmware.com/s/article/1003746
+        [virtual-machine-hardware-compatibility]: https://kb.vmware.com/s/article/2007240
         """
         return pulumi.get(self, "hardware_version")
 
@@ -2003,7 +2111,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="hostSystemId")
     def host_system_id(self) -> Optional[pulumi.Input[str]]:
         """
-        The ID of an optional host system to pin the virtual machine to.
+        The managed object reference ID of a host on which to place the virtual machine. See the section on virtual machine migration for more information on modifying this value. When using a vSphere cluster, if a `host_system_id` is not supplied, vSphere will select a host in the cluster to place the virtual machine, according to any defaults or vSphere DRS placement policies.
         """
         return pulumi.get(self, "host_system_id")
 
@@ -2015,7 +2123,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="hvMode")
     def hv_mode(self) -> Optional[pulumi.Input[str]]:
         """
-        The (non-nested) hardware virtualization setting for this virtual machine. Can be one of hvAuto, hvOn, or hvOff.
+        The hardware virtualization (non-nested) setting for the virtual machine. One of `hvAuto`, `hvOn`, or `hvOff`. Default: `hvAuto`.
         """
         return pulumi.get(self, "hv_mode")
 
@@ -2026,6 +2134,9 @@ class _VirtualMachineState:
     @property
     @pulumi.getter(name="ideControllerCount")
     def ide_controller_count(self) -> Optional[pulumi.Input[int]]:
+        """
+        The number of IDE controllers that the virtual machine. This directly affects the number of disks you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove controllers. Default: `2`.
+        """
         return pulumi.get(self, "ide_controller_count")
 
     @ide_controller_count.setter
@@ -2036,7 +2147,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="ignoredGuestIps")
     def ignored_guest_ips(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
         """
-        List of IP addresses and CIDR networks to ignore while waiting for an IP
+        List of IP addresses and CIDR networks to ignore while waiting for an available IP address using either of the waiters. Any IP addresses in this list will be ignored so that the waiter will continue to wait for a valid IP address. Default: `[]`.
         """
         return pulumi.get(self, "ignored_guest_ips")
 
@@ -2060,9 +2171,9 @@ class _VirtualMachineState:
     @pulumi.getter(name="latencySensitivity")
     def latency_sensitivity(self) -> Optional[pulumi.Input[str]]:
         """
-        Controls the scheduling delay of the virtual machine. Use a higher sensitivity for applications that require lower
-        latency, such as VOIP, media player applications, or applications that require frequent access to mouse or keyboard
-        devices. Can be one of low, normal, medium, or high.
+        Controls the scheduling delay of the virtual machine. Use a higher sensitivity for applications that require lower latency, such as VOIP, media player applications, or applications that require frequent access to mouse or keyboard devices. One of `low`, `normal`, `medium`, or `high`.
+
+        > **NOTE:** On higher sensitivities, you may need to adjust the `memory_reservation` to the full amount of memory provisioned for the virtual machine.
         """
         return pulumi.get(self, "latency_sensitivity")
 
@@ -2074,7 +2185,7 @@ class _VirtualMachineState:
     @pulumi.getter
     def memory(self) -> Optional[pulumi.Input[int]]:
         """
-        The size of the virtual machine's memory, in MB.
+        The memory size to assign to the virtual machine, in MB. Default: `1024` (1 GB).
         """
         return pulumi.get(self, "memory")
 
@@ -2086,7 +2197,15 @@ class _VirtualMachineState:
     @pulumi.getter(name="memoryHotAddEnabled")
     def memory_hot_add_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        Allow memory to be added to this virtual machine while it is running.
+        Allow memory to be added to the virtual machine while it is powered on.
+
+        > **NOTE:** CPU and memory hot add options are not available on all guest operating systems. Please refer to the [VMware Guest OS Compatibility Guide][vmware-docs-compat-guide] to which settings are allow for your guest operating system. In addition, at least one `pulumi up` must be run before you are able to use CPU and memory hot add.
+
+        [vmware-docs-compat-guide]: http://partnerweb.vmware.com/comp_guide2/pdf/VMware_GOS_Compatibility_Guide.pdf
+
+        > **NOTE:** For Linux 64-bit guest operating systems with less than or equal to 3GB, the virtual machine must powered off to add memory beyond 3GB. Subsequent hot add of memory does not require the virtual machine to be powered-off to apply the plan. Please refer to [VMware KB 2008405][vmware-kb-2008405].
+
+        [vmware-kb-2008405]: https://kb.vmware.com/s/article/2008405
         """
         return pulumi.get(self, "memory_hot_add_enabled")
 
@@ -2098,8 +2217,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="memoryLimit")
     def memory_limit(self) -> Optional[pulumi.Input[int]]:
         """
-        The maximum amount of memory (in MB) or CPU (in MHz) that this virtual machine can consume, regardless of available
-        resources.
+        The maximum amount of memory (in MB) that th virtual machine can consume, regardless of available resources. The default is no limit.
         """
         return pulumi.get(self, "memory_limit")
 
@@ -2111,7 +2229,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="memoryReservation")
     def memory_reservation(self) -> Optional[pulumi.Input[int]]:
         """
-        The amount of memory (in MB) or CPU (in MHz) that this virtual machine is guaranteed.
+        The amount of memory (in MB) that the virtual machine is guaranteed. The default is no reservation.
         """
         return pulumi.get(self, "memory_reservation")
 
@@ -2137,7 +2255,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="memoryShareCount")
     def memory_share_count(self) -> Optional[pulumi.Input[int]]:
         """
-        The amount of shares to allocate to memory for a custom share level.
+        The number of memory shares allocated to the virtual machine when the `memory_share_level` is `custom`.
         """
         return pulumi.get(self, "memory_share_count")
 
@@ -2149,7 +2267,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="memoryShareLevel")
     def memory_share_level(self) -> Optional[pulumi.Input[str]]:
         """
-        The allocation level for memory resources. Can be one of high, low, normal, or custom.
+        The allocation level for the virtual machine memory resources. One of `high`, `low`, `normal`, or `custom`. Default: `custom`.
         """
         return pulumi.get(self, "memory_share_level")
 
@@ -2161,7 +2279,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="migrateWaitTimeout")
     def migrate_wait_timeout(self) -> Optional[pulumi.Input[int]]:
         """
-        The amount of time, in minutes, to wait for a vMotion operation to complete before failing.
+        The amount of time, in minutes, to wait for a virtual machine migration to complete before failing. Default: `10` minutes. See the section on virtual machine migration for more information.
         """
         return pulumi.get(self, "migrate_wait_timeout")
 
@@ -2185,7 +2303,7 @@ class _VirtualMachineState:
     @pulumi.getter
     def name(self) -> Optional[pulumi.Input[str]]:
         """
-        The name of this virtual machine.
+        The name of the virtual machine.
         """
         return pulumi.get(self, "name")
 
@@ -2197,7 +2315,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="nestedHvEnabled")
     def nested_hv_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        Enable nested hardware virtualization on this virtual machine, facilitating nested virtualization in the guest.
+        Enable nested hardware virtualization on the virtual machine, facilitating nested virtualization in the guest operating system. Default: `false`.
         """
         return pulumi.get(self, "nested_hv_enabled")
 
@@ -2209,7 +2327,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="networkInterfaces")
     def network_interfaces(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['VirtualMachineNetworkInterfaceArgs']]]]:
         """
-        A specification for a virtual NIC on this virtual machine.
+        A specification for a virtual NIC on the virtual machine. See network interface options for more information.
         """
         return pulumi.get(self, "network_interfaces")
 
@@ -2221,8 +2339,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="numCoresPerSocket")
     def num_cores_per_socket(self) -> Optional[pulumi.Input[int]]:
         """
-        The number of cores to distribute amongst the CPUs in this virtual machine. If specified, the value supplied to num_cpus
-        must be evenly divisible by this value.
+        The number of cores per socket in the virtual machine. The number of vCPUs on the virtual machine will be `num_cpus` divided by `num_cores_per_socket`. If specified, the value supplied to `num_cpus` must be evenly divisible by this value. Default: `1`.
         """
         return pulumi.get(self, "num_cores_per_socket")
 
@@ -2234,7 +2351,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="numCpus")
     def num_cpus(self) -> Optional[pulumi.Input[int]]:
         """
-        The number of virtual processors to assign to this virtual machine.
+        The total number of virtual processor cores to assign to the virtual machine. Default: `1`.
         """
         return pulumi.get(self, "num_cpus")
 
@@ -2246,7 +2363,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="ovfDeploy")
     def ovf_deploy(self) -> Optional[pulumi.Input['VirtualMachineOvfDeployArgs']]:
         """
-        A specification for deploying a virtual machine from ovf/ova template.
+        When specified, the virtual machine will be deployed from the provided OVF/OVA template. See creating a virtual machine from an OVF/OVA template for more information.
         """
         return pulumi.get(self, "ovf_deploy")
 
@@ -2258,7 +2375,9 @@ class _VirtualMachineState:
     @pulumi.getter(name="pciDeviceIds")
     def pci_device_ids(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
         """
-        A list of PCI passthrough devices
+        List of host PCI device IDs in which to create PCI passthroughs.
+
+        > **NOTE:** Cloning requires vCenter Server and is not supported on direct ESXi host connections.
         """
         return pulumi.get(self, "pci_device_ids")
 
@@ -2293,6 +2412,9 @@ class _VirtualMachineState:
     @property
     @pulumi.getter(name="rebootRequired")
     def reboot_required(self) -> Optional[pulumi.Input[bool]]:
+        """
+        Value internal to Terraform used to determine if a configuration set change requires a reboot.
+        """
         return pulumi.get(self, "reboot_required")
 
     @reboot_required.setter
@@ -2304,6 +2426,8 @@ class _VirtualMachineState:
     def replace_trigger(self) -> Optional[pulumi.Input[str]]:
         """
         Triggers replacement of resource whenever it changes.
+
+        For example, `replace_trigger = sha256(format("%!s(MISSING)-%!s(MISSING)",data.template_file.cloud_init_metadata.rendered,data.template_file.cloud_init_userdata.rendered))` will fingerprint the changes in cloud-init metadata and userdata templates. This will enable a replacement of the resource whenever the dependant template renders a new configuration. (Forces a replacement.)
         """
         return pulumi.get(self, "replace_trigger")
 
@@ -2315,7 +2439,9 @@ class _VirtualMachineState:
     @pulumi.getter(name="resourcePoolId")
     def resource_pool_id(self) -> Optional[pulumi.Input[str]]:
         """
-        The ID of a resource pool to put the virtual machine in.
+        The managed object reference ID of the resource pool in which to place the virtual machine. See the Virtual Machine Migration section for more information on modifying this value.
+
+        > **NOTE:** All clusters and standalone hosts have a default root resource pool. This resource argument does not directly accept the cluster or standalone host resource. For more information, see the section on specifying the Root Resource Pool in the `ResourcePool` data source documentation on using the root resource pool.
         """
         return pulumi.get(self, "resource_pool_id")
 
@@ -2327,7 +2453,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="runToolsScriptsAfterPowerOn")
     def run_tools_scripts_after_power_on(self) -> Optional[pulumi.Input[bool]]:
         """
-        Enable the run of scripts after virtual machine power-on when VMware Tools is installed.
+        Enable post-power-on scripts to run when VMware Tools is installed. Default: `true`.
         """
         return pulumi.get(self, "run_tools_scripts_after_power_on")
 
@@ -2339,7 +2465,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="runToolsScriptsAfterResume")
     def run_tools_scripts_after_resume(self) -> Optional[pulumi.Input[bool]]:
         """
-        Enable the run of scripts after virtual machine resume when when VMware Tools is installed.
+        Enable ost-resume scripts to run when VMware Tools is installed. Default: `true`.
         """
         return pulumi.get(self, "run_tools_scripts_after_resume")
 
@@ -2351,7 +2477,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="runToolsScriptsBeforeGuestReboot")
     def run_tools_scripts_before_guest_reboot(self) -> Optional[pulumi.Input[bool]]:
         """
-        Enable the run of scripts before guest operating system reboot when VMware Tools is installed.
+        Enable pre-reboot scripts to run when VMware Tools is installed. Default: `false`.
         """
         return pulumi.get(self, "run_tools_scripts_before_guest_reboot")
 
@@ -2363,7 +2489,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="runToolsScriptsBeforeGuestShutdown")
     def run_tools_scripts_before_guest_shutdown(self) -> Optional[pulumi.Input[bool]]:
         """
-        Enable the run of scripts before guest operating system shutdown when VMware Tools is installed.
+        Enable pre-shutdown scripts to run when VMware Tools is installed. Default: `true`.
         """
         return pulumi.get(self, "run_tools_scripts_before_guest_shutdown")
 
@@ -2375,7 +2501,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="runToolsScriptsBeforeGuestStandby")
     def run_tools_scripts_before_guest_standby(self) -> Optional[pulumi.Input[bool]]:
         """
-        Enable the run of scripts before guest operating system standby when VMware Tools is installed.
+        Enable pre-standby scripts to run when VMware Tools is installed. Default: `true`.
         """
         return pulumi.get(self, "run_tools_scripts_before_guest_standby")
 
@@ -2386,6 +2512,11 @@ class _VirtualMachineState:
     @property
     @pulumi.getter(name="sataControllerCount")
     def sata_controller_count(self) -> Optional[pulumi.Input[int]]:
+        """
+        The number of SATA controllers that Terraform manages on this virtual machine. This directly affects the amount of disks
+        you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove
+        controllers.
+        """
         return pulumi.get(self, "sata_controller_count")
 
     @sata_controller_count.setter
@@ -2396,7 +2527,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="scsiBusSharing")
     def scsi_bus_sharing(self) -> Optional[pulumi.Input[str]]:
         """
-        Mode for sharing the SCSI bus. The modes are physicalSharing, virtualSharing, and noSharing.
+        The type of SCSI bus sharing for the virtual machine SCSI controller. One of `physicalSharing`, `virtualSharing`, and `noSharing`. Default: `noSharing`.
         """
         return pulumi.get(self, "scsi_bus_sharing")
 
@@ -2407,6 +2538,11 @@ class _VirtualMachineState:
     @property
     @pulumi.getter(name="scsiControllerCount")
     def scsi_controller_count(self) -> Optional[pulumi.Input[int]]:
+        """
+        The number of SCSI controllers that Terraform manages on this virtual machine. This directly affects the amount of disks
+        you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove
+        controllers.
+        """
         return pulumi.get(self, "scsi_controller_count")
 
     @scsi_controller_count.setter
@@ -2417,7 +2553,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="scsiType")
     def scsi_type(self) -> Optional[pulumi.Input[str]]:
         """
-        The type of SCSI bus this virtual machine will have. Can be one of lsilogic, lsilogic-sas or pvscsi.
+        The SCSI controller type for the virtual machine. One of `lsilogic` (LSI Logic Parallel), `lsilogic-sas` (LSI Logic SAS) or `pvscsi` (VMware Paravirtual). Default: `pvscsi`.
         """
         return pulumi.get(self, "scsi_type")
 
@@ -2429,7 +2565,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="shutdownWaitTimeout")
     def shutdown_wait_timeout(self) -> Optional[pulumi.Input[int]]:
         """
-        The amount of time, in minutes, to wait for shutdown when making necessary updates to the virtual machine.
+        The amount of time, in minutes, to wait for a graceful guest shutdown when making necessary updates to the virtual machine. If `force_power_off` is set to `true`, the virtual machine will be forced to power-off after the timeout, otherwise an error is returned. Default: `3` minutes.
         """
         return pulumi.get(self, "shutdown_wait_timeout")
 
@@ -2441,7 +2577,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="storagePolicyId")
     def storage_policy_id(self) -> Optional[pulumi.Input[str]]:
         """
-        The ID of the storage policy to assign to the virtual machine home directory.
+        The UUID of the storage policy to assign to the virtual disk.
         """
         return pulumi.get(self, "storage_policy_id")
 
@@ -2453,7 +2589,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="swapPlacementPolicy")
     def swap_placement_policy(self) -> Optional[pulumi.Input[str]]:
         """
-        The swap file placement policy for this virtual machine. Can be one of inherit, hostLocal, or vmDirectory.
+        The swap file placement policy for the virtual machine. One of `inherit`, `hostLocal`, or `vmDirectory`. Default: `inherit`.
         """
         return pulumi.get(self, "swap_placement_policy")
 
@@ -2465,8 +2601,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="syncTimeWithHost")
     def sync_time_with_host(self) -> Optional[pulumi.Input[bool]]:
         """
-        Enable guest clock synchronization with the host. On vSphere 7.0 U1 and above, with only this setting the clock is
-        synchronized on startup and resume. Requires VMware Tools to be installed.
+        Enable the guest operating system to synchronization its clock with the host when the virtual machine is powered on or resumed. Requires vSphere 7.0 Update 1 and later. Requires VMware Tools to be installed. Default: `true`.
         """
         return pulumi.get(self, "sync_time_with_host")
 
@@ -2478,8 +2613,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="syncTimeWithHostPeriodically")
     def sync_time_with_host_periodically(self) -> Optional[pulumi.Input[bool]]:
         """
-        Enable periodic clock synchronization with the host. Supported only on vSphere 7.0 U1 and above. On prior versions
-        setting `sync_time_with_host` is enough for periodic synchronization. Requires VMware Tools to be installed.
+        Enable the guest operating system to periodically synchronize its clock with the host. Requires vSphere 7.0 Update 1 and later. On previous versions, setting `sync_time_with_host` is will enable periodic synchronization. Requires VMware Tools to be installed. Default: `false`.
         """
         return pulumi.get(self, "sync_time_with_host_periodically")
 
@@ -2491,7 +2625,9 @@ class _VirtualMachineState:
     @pulumi.getter
     def tags(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
         """
-        A list of tag IDs to apply to this object.
+        The IDs of any tags to attach to this resource. Please refer to the `Tag` resource for more information on applying tags to virtual machine resources.
+
+        > **NOTE:** Tagging support is unsupported on direct ESXi host connections and requires vCenter Server instance.
         """
         return pulumi.get(self, "tags")
 
@@ -2503,7 +2639,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="toolsUpgradePolicy")
     def tools_upgrade_policy(self) -> Optional[pulumi.Input[str]]:
         """
-        Set the upgrade policy for VMware Tools. Can be one of `manual` or `upgradeAtPowerCycle`.
+        Enable automatic upgrade of the VMware Tools version when the virtual machine is rebooted. If necessary, VMware Tools is upgraded to the latest version supported by the host on which the virtual machine is running. Requires VMware Tools to be installed. One of `manual` or `upgradeAtPowerCycle`. Default: `manual`.
         """
         return pulumi.get(self, "tools_upgrade_policy")
 
@@ -2515,7 +2651,7 @@ class _VirtualMachineState:
     @pulumi.getter
     def uuid(self) -> Optional[pulumi.Input[str]]:
         """
-        The UUID of the virtual machine. Also exposed as the `id` of the resource.
+        The UUID of the virtual disk VMDK file. This is used to track the virtual disk on the virtual machine.
         """
         return pulumi.get(self, "uuid")
 
@@ -2527,7 +2663,7 @@ class _VirtualMachineState:
     @pulumi.getter
     def vapp(self) -> Optional[pulumi.Input['VirtualMachineVappArgs']]:
         """
-        vApp configuration data for this virtual machine. Can be used to provide configuration data for OVF images.
+        Used for vApp configurations. The only sub-key available is `properties`, which is a key/value map of properties for virtual machines imported from and OVF/OVA. See Using vApp Properties for OVF/OVA Configuration for more information.
         """
         return pulumi.get(self, "vapp")
 
@@ -2551,7 +2687,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="vbsEnabled")
     def vbs_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        Flag to specify if Virtualization-based security is enabled for this virtual machine.
+        Enable Virtualization Based Security. Requires `firmware` to be `efi`. In addition, `vvtd_enabled`, `nested_hv_enabled`, and `efi_secure_boot_enabled` must all have a value of `true`. Supported on vSphere 6.7 and later. Default: `false`.
         """
         return pulumi.get(self, "vbs_enabled")
 
@@ -2587,8 +2723,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="vvtdEnabled")
     def vvtd_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        Flag to specify if I/O MMU virtualization, also called Intel Virtualization Technology for Directed I/O (VT-d) and AMD
-        I/O Virtualization (AMD-Vi or IOMMU), is enabled.
+        Enable Intel Virtualization Technology for Directed I/O for the virtual machine (_I/O MMU_ in the vSphere Client). Supported on vSphere 6.7 and later. Default: `false`.
         """
         return pulumi.get(self, "vvtd_enabled")
 
@@ -2600,8 +2735,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="waitForGuestIpTimeout")
     def wait_for_guest_ip_timeout(self) -> Optional[pulumi.Input[int]]:
         """
-        The amount of time, in minutes, to wait for an available IP address on this virtual machine. A value less than 1
-        disables the waiter.
+        The amount of time, in minutes, to wait for an available guest IP address on the virtual machine. This should only be used if the version VMware Tools does not allow the `wait_for_guest_net_timeout` waiter to be used. A value less than `1` disables the waiter. Default: `0`.
         """
         return pulumi.get(self, "wait_for_guest_ip_timeout")
 
@@ -2613,8 +2747,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="waitForGuestNetRoutable")
     def wait_for_guest_net_routable(self) -> Optional[pulumi.Input[bool]]:
         """
-        Controls whether or not the guest network waiter waits for a routable address. When false, the waiter does not wait for
-        a default gateway, nor are IP addresses checked against any discovered default gateways as part of its success criteria.
+        Controls whether or not the guest network waiter waits for a routable address. When `false`, the waiter does not wait for a default gateway, nor are IP addresses checked against any discovered default gateways as part of its success criteria. This property is ignored if the `wait_for_guest_ip_timeout` waiter is used. Default: `true`.
         """
         return pulumi.get(self, "wait_for_guest_net_routable")
 
@@ -2626,8 +2759,7 @@ class _VirtualMachineState:
     @pulumi.getter(name="waitForGuestNetTimeout")
     def wait_for_guest_net_timeout(self) -> Optional[pulumi.Input[int]]:
         """
-        The amount of time, in minutes, to wait for an available IP address on this virtual machine. A value less than 1
-        disables the waiter.
+        The amount of time, in minutes, to wait for an available guest IP address on the virtual machine. Older versions of VMware Tools do not populate this property. In those cases, this waiter can be disabled and the `wait_for_guest_ip_timeout` waiter can be used instead. A value less than `1` disables the waiter. Default: `5` minutes.
         """
         return pulumi.get(self, "wait_for_guest_net_timeout")
 
@@ -2721,93 +2853,122 @@ class VirtualMachine(pulumi.CustomResource):
         Create a VirtualMachine resource with the given unique name, props, and options.
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[str] alternate_guest_name: The guest name for the operating system when guest_id is otherGuest or otherGuest64.
-        :param pulumi.Input[str] annotation: User-provided description of the virtual machine.
-        :param pulumi.Input[int] boot_delay: The number of milliseconds to wait before starting the boot sequence.
-        :param pulumi.Input[int] boot_retry_delay: The number of milliseconds to wait before retrying the boot sequence. This only valid if boot_retry_enabled is true.
-        :param pulumi.Input[bool] boot_retry_enabled: If set to true, a virtual machine that fails to boot will try again after the delay defined in boot_retry_delay.
-        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['VirtualMachineCdromArgs']]]] cdroms: A specification for a CDROM device on this virtual machine.
-        :param pulumi.Input[pulumi.InputType['VirtualMachineCloneArgs']] clone: A specification for cloning a virtual machine from template.
-        :param pulumi.Input[bool] cpu_hot_add_enabled: Allow CPUs to be added to this virtual machine while it is running.
-        :param pulumi.Input[bool] cpu_hot_remove_enabled: Allow CPUs to be added to this virtual machine while it is running.
-        :param pulumi.Input[int] cpu_limit: The maximum amount of memory (in MB) or CPU (in MHz) that this virtual machine can consume, regardless of available
-               resources.
-        :param pulumi.Input[bool] cpu_performance_counters_enabled: Enable CPU performance counters on this virtual machine.
-        :param pulumi.Input[int] cpu_reservation: The amount of memory (in MB) or CPU (in MHz) that this virtual machine is guaranteed.
-        :param pulumi.Input[int] cpu_share_count: The amount of shares to allocate to cpu for a custom share level.
-        :param pulumi.Input[str] cpu_share_level: The allocation level for cpu resources. Can be one of high, low, normal, or custom.
-        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] custom_attributes: A list of custom attributes to set on this resource.
-        :param pulumi.Input[str] datacenter_id: The ID of the datacenter where the VM is to be created.
-        :param pulumi.Input[str] datastore_cluster_id: The ID of a datastore cluster to put the virtual machine in.
-        :param pulumi.Input[str] datastore_id: The ID of the virtual machine's datastore. The virtual machine configuration is placed here, along with any virtual
-               disks that are created without datastores.
-        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['VirtualMachineDiskArgs']]]] disks: A specification for a virtual disk device on this virtual machine.
-        :param pulumi.Input[bool] efi_secure_boot_enabled: When the boot type set in firmware is efi, this enables EFI secure boot.
-        :param pulumi.Input[bool] enable_disk_uuid: Expose the UUIDs of attached virtual disks to the virtual machine, allowing access to them in the guest.
-        :param pulumi.Input[bool] enable_logging: Enable logging on this virtual machine.
-        :param pulumi.Input[str] ept_rvi_mode: The EPT/RVI (hardware memory virtualization) setting for this virtual machine. Can be one of automatic, on, or off.
-        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] extra_config: Extra configuration data for this virtual machine. Can be used to supply advanced parameters not normally in
-               configuration, such as instance metadata, or configuration data for OVF images.
-        :param pulumi.Input[bool] extra_config_reboot_required: Allow the virtual machine to be rebooted when a change to `extra_config` occurs.
-        :param pulumi.Input[str] firmware: The firmware interface to use on the virtual machine. Can be one of bios or efi.
-        :param pulumi.Input[str] folder: The name of the folder to locate the virtual machine in.
-        :param pulumi.Input[bool] force_power_off: Set to true to force power-off a virtual machine if a graceful guest shutdown failed for a necessary operation.
-        :param pulumi.Input[str] guest_id: The guest ID for the operating system.
-        :param pulumi.Input[int] hardware_version: The hardware version for the virtual machine.
-        :param pulumi.Input[str] host_system_id: The ID of an optional host system to pin the virtual machine to.
-        :param pulumi.Input[str] hv_mode: The (non-nested) hardware virtualization setting for this virtual machine. Can be one of hvAuto, hvOn, or hvOff.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] ignored_guest_ips: List of IP addresses and CIDR networks to ignore while waiting for an IP
-        :param pulumi.Input[str] latency_sensitivity: Controls the scheduling delay of the virtual machine. Use a higher sensitivity for applications that require lower
-               latency, such as VOIP, media player applications, or applications that require frequent access to mouse or keyboard
-               devices. Can be one of low, normal, medium, or high.
-        :param pulumi.Input[int] memory: The size of the virtual machine's memory, in MB.
-        :param pulumi.Input[bool] memory_hot_add_enabled: Allow memory to be added to this virtual machine while it is running.
-        :param pulumi.Input[int] memory_limit: The maximum amount of memory (in MB) or CPU (in MHz) that this virtual machine can consume, regardless of available
-               resources.
-        :param pulumi.Input[int] memory_reservation: The amount of memory (in MB) or CPU (in MHz) that this virtual machine is guaranteed.
+        :param pulumi.Input[str] alternate_guest_name: The guest name for the operating system when `guest_id` is `otherGuest` or `otherGuest64`.
+        :param pulumi.Input[str] annotation: A user-provided description of the virtual machine.
+        :param pulumi.Input[int] boot_delay: The number of milliseconds to wait before starting the boot sequence. The default is no delay.
+        :param pulumi.Input[int] boot_retry_delay: The number of milliseconds to wait before retrying the boot sequence. This option is only valid if `boot_retry_enabled` is `true`. Default: `10000` (10 seconds).
+        :param pulumi.Input[bool] boot_retry_enabled: If set to `true`, a virtual machine that fails to boot will try again after the delay defined in `boot_retry_delay`. Default: `false`.
+        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['VirtualMachineCdromArgs']]]] cdroms: A specification for a CD-ROM device on the virtual machine. See CD-ROM options for more information.
+        :param pulumi.Input[pulumi.InputType['VirtualMachineCloneArgs']] clone: When specified, the virtual machine will be created as a clone of a specified template. Optional customization options can be submitted for the resource. See creating a virtual machine from a template for more information.
+        :param pulumi.Input[bool] cpu_hot_add_enabled: Allow CPUs to be added to the virtual machine while it is powered on.
+        :param pulumi.Input[bool] cpu_hot_remove_enabled: Allow CPUs to be removed to the virtual machine while it is powered on.
+        :param pulumi.Input[int] cpu_limit: The maximum amount of CPU (in MHz) that the virtual machine can consume, regardless of available resources. The default is no limit.
+        :param pulumi.Input[bool] cpu_performance_counters_enabled: Enable CPU performance counters on the virtual machine. Default: `false`.
+        :param pulumi.Input[int] cpu_reservation: The amount of CPU (in MHz) that the virtual machine is guaranteed. The default is no reservation.
+        :param pulumi.Input[int] cpu_share_count: The number of CPU shares allocated to the virtual machine when the `cpu_share_level` is `custom`.
+        :param pulumi.Input[str] cpu_share_level: The allocation level for the virtual machine CPU resources. One of `high`, `low`, `normal`, or `custom`. Default: `custom`.
+        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] custom_attributes: Map of custom attribute ids to attribute value strings to set for virtual machine. Please refer to the `vsphere_custom_attributes` resource for more information on setting custom attributes.
+               
+               > **NOTE:** Custom attributes requires vCenter Server and is not supported on direct ESXi host connections.
+        :param pulumi.Input[str] datacenter_id: The datacenter ID. Required only when deploying an OVF/OVA template.
+        :param pulumi.Input[str] datastore_cluster_id: The managed object reference ID of the datastore cluster in which to place the virtual machine. This setting applies to entire virtual machine and implies that you wish to use vSphere Storage DRS with the virtual machine. See the section on virtual machine migration for more information on modifying this value.
+               
+               > **NOTE:** One of `datastore_id` or `datastore_cluster_id` must be specified.
+               
+               > **NOTE:** Use of `datastore_cluster_id` requires vSphere Storage DRS to be enabled on the specified datastore cluster.
+               
+               > **NOTE:** The `datastore_cluster_id` setting applies to the entire virtual machine resource. You cannot assign individual individual disks to datastore clusters. In addition, you cannot use the `attach` setting to attach external disks on virtual machines that are assigned to datastore clusters.
+        :param pulumi.Input[str] datastore_id: The datastore ID that on which the ISO is located. Required for using a datastore ISO. Conflicts with `client_device`.
+        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['VirtualMachineDiskArgs']]]] disks: A specification for a virtual disk device on the virtual machine. See disk options for more information.
+        :param pulumi.Input[bool] efi_secure_boot_enabled: Use this option to enable EFI secure boot when the `firmware` type is set to is `efi`. Default: `false`.
+               
+               > **NOTE:** EFI secure boot is only available on vSphere 6.5 and later.
+        :param pulumi.Input[bool] enable_disk_uuid: Expose the UUIDs of attached virtual disks to the virtual machine, allowing access to them in the guest. Default: `false`.
+        :param pulumi.Input[bool] enable_logging: Enable logging of virtual machine events to a log file stored in the virtual machine directory. Default: `false`.
+        :param pulumi.Input[str] ept_rvi_mode: The EPT/RVI (hardware memory virtualization) setting for the virtual machine. One of `automatic`, `on`, or `off`. Default: `automatic`.
+        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] extra_config: Extra configuration data for the virtual machine. Can be used to supply advanced parameters not normally in configuration, such as instance metadata and userdata.
+               
+               > **NOTE:** Do not use `extra_config` when working with a template imported from OVF/OVA as your settings may be ignored. Use the `vapp` block `properties` section as described in Using vApp Properties for OVF/OVA Configuration.
+        :param pulumi.Input[bool] extra_config_reboot_required: Allow the virtual machine to be rebooted when a change to `extra_config` occurs. Default: `true`.
+        :param pulumi.Input[str] firmware: The firmware for the virtual machine. One of `bios` or `efi`.
+        :param pulumi.Input[str] folder: The path to the virtual machine folder in which to place the virtual machine, relative to the datacenter path (`/<datacenter-name>/vm`).  For example, `/dc-01/vm/foo`
+        :param pulumi.Input[bool] force_power_off: If a guest shutdown failed or times out while updating or destroying (see `shutdown_wait_timeout`), force the power-off of the virtual machine. Default: `true`.
+        :param pulumi.Input[str] guest_id: The guest ID for the operating system type. For a full list of possible values, see [here][vmware-docs-guest-ids]. Default: `otherGuest64`.
+               
+               [vmware-docs-guest-ids]: https://vdc-repo.vmware.com/vmwb-repository/dcr-public/184bb3ba-6fa8-4574-a767-d0c96e2a38f4/ba9422ef-405c-47dd-8553-e11b619185b2/SDK/vsphere-ws/docs/ReferenceGuide/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html
+        :param pulumi.Input[int] hardware_version: The hardware version number. Valid range is from 4 to 21. The hardware version cannot be downgraded. See virtual machine hardware [versions][virtual-machine-hardware-versions] and [compatibility][virtual-machine-hardware-compatibility] for more information on supported settings.
+               
+               [virtual-machine-hardware-versions]: https://kb.vmware.com/s/article/1003746
+               [virtual-machine-hardware-compatibility]: https://kb.vmware.com/s/article/2007240
+        :param pulumi.Input[str] host_system_id: The managed object reference ID of a host on which to place the virtual machine. See the section on virtual machine migration for more information on modifying this value. When using a vSphere cluster, if a `host_system_id` is not supplied, vSphere will select a host in the cluster to place the virtual machine, according to any defaults or vSphere DRS placement policies.
+        :param pulumi.Input[str] hv_mode: The hardware virtualization (non-nested) setting for the virtual machine. One of `hvAuto`, `hvOn`, or `hvOff`. Default: `hvAuto`.
+        :param pulumi.Input[int] ide_controller_count: The number of IDE controllers that the virtual machine. This directly affects the number of disks you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove controllers. Default: `2`.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] ignored_guest_ips: List of IP addresses and CIDR networks to ignore while waiting for an available IP address using either of the waiters. Any IP addresses in this list will be ignored so that the waiter will continue to wait for a valid IP address. Default: `[]`.
+        :param pulumi.Input[str] latency_sensitivity: Controls the scheduling delay of the virtual machine. Use a higher sensitivity for applications that require lower latency, such as VOIP, media player applications, or applications that require frequent access to mouse or keyboard devices. One of `low`, `normal`, `medium`, or `high`.
+               
+               > **NOTE:** On higher sensitivities, you may need to adjust the `memory_reservation` to the full amount of memory provisioned for the virtual machine.
+        :param pulumi.Input[int] memory: The memory size to assign to the virtual machine, in MB. Default: `1024` (1 GB).
+        :param pulumi.Input[bool] memory_hot_add_enabled: Allow memory to be added to the virtual machine while it is powered on.
+               
+               > **NOTE:** CPU and memory hot add options are not available on all guest operating systems. Please refer to the [VMware Guest OS Compatibility Guide][vmware-docs-compat-guide] to which settings are allow for your guest operating system. In addition, at least one `pulumi up` must be run before you are able to use CPU and memory hot add.
+               
+               [vmware-docs-compat-guide]: http://partnerweb.vmware.com/comp_guide2/pdf/VMware_GOS_Compatibility_Guide.pdf
+               
+               > **NOTE:** For Linux 64-bit guest operating systems with less than or equal to 3GB, the virtual machine must powered off to add memory beyond 3GB. Subsequent hot add of memory does not require the virtual machine to be powered-off to apply the plan. Please refer to [VMware KB 2008405][vmware-kb-2008405].
+               
+               [vmware-kb-2008405]: https://kb.vmware.com/s/article/2008405
+        :param pulumi.Input[int] memory_limit: The maximum amount of memory (in MB) that th virtual machine can consume, regardless of available resources. The default is no limit.
+        :param pulumi.Input[int] memory_reservation: The amount of memory (in MB) that the virtual machine is guaranteed. The default is no reservation.
         :param pulumi.Input[bool] memory_reservation_locked_to_max: If set true, memory resource reservation for this virtual machine will always be equal to the virtual machine's memory
                size;increases in memory size will be rejected when a corresponding reservation increase is not possible. This feature
                may only be enabled if it is currently possible to reserve all of the virtual machine's memory.
-        :param pulumi.Input[int] memory_share_count: The amount of shares to allocate to memory for a custom share level.
-        :param pulumi.Input[str] memory_share_level: The allocation level for memory resources. Can be one of high, low, normal, or custom.
-        :param pulumi.Input[int] migrate_wait_timeout: The amount of time, in minutes, to wait for a vMotion operation to complete before failing.
-        :param pulumi.Input[str] name: The name of this virtual machine.
-        :param pulumi.Input[bool] nested_hv_enabled: Enable nested hardware virtualization on this virtual machine, facilitating nested virtualization in the guest.
-        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['VirtualMachineNetworkInterfaceArgs']]]] network_interfaces: A specification for a virtual NIC on this virtual machine.
-        :param pulumi.Input[int] num_cores_per_socket: The number of cores to distribute amongst the CPUs in this virtual machine. If specified, the value supplied to num_cpus
-               must be evenly divisible by this value.
-        :param pulumi.Input[int] num_cpus: The number of virtual processors to assign to this virtual machine.
-        :param pulumi.Input[pulumi.InputType['VirtualMachineOvfDeployArgs']] ovf_deploy: A specification for deploying a virtual machine from ovf/ova template.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] pci_device_ids: A list of PCI passthrough devices
+        :param pulumi.Input[int] memory_share_count: The number of memory shares allocated to the virtual machine when the `memory_share_level` is `custom`.
+        :param pulumi.Input[str] memory_share_level: The allocation level for the virtual machine memory resources. One of `high`, `low`, `normal`, or `custom`. Default: `custom`.
+        :param pulumi.Input[int] migrate_wait_timeout: The amount of time, in minutes, to wait for a virtual machine migration to complete before failing. Default: `10` minutes. See the section on virtual machine migration for more information.
+        :param pulumi.Input[str] name: The name of the virtual machine.
+        :param pulumi.Input[bool] nested_hv_enabled: Enable nested hardware virtualization on the virtual machine, facilitating nested virtualization in the guest operating system. Default: `false`.
+        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['VirtualMachineNetworkInterfaceArgs']]]] network_interfaces: A specification for a virtual NIC on the virtual machine. See network interface options for more information.
+        :param pulumi.Input[int] num_cores_per_socket: The number of cores per socket in the virtual machine. The number of vCPUs on the virtual machine will be `num_cpus` divided by `num_cores_per_socket`. If specified, the value supplied to `num_cpus` must be evenly divisible by this value. Default: `1`.
+        :param pulumi.Input[int] num_cpus: The total number of virtual processor cores to assign to the virtual machine. Default: `1`.
+        :param pulumi.Input[pulumi.InputType['VirtualMachineOvfDeployArgs']] ovf_deploy: When specified, the virtual machine will be deployed from the provided OVF/OVA template. See creating a virtual machine from an OVF/OVA template for more information.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] pci_device_ids: List of host PCI device IDs in which to create PCI passthroughs.
+               
+               > **NOTE:** Cloning requires vCenter Server and is not supported on direct ESXi host connections.
         :param pulumi.Input[int] poweron_timeout: The amount of time, in seconds, that we will be trying to power on a VM
         :param pulumi.Input[str] replace_trigger: Triggers replacement of resource whenever it changes.
-        :param pulumi.Input[str] resource_pool_id: The ID of a resource pool to put the virtual machine in.
-        :param pulumi.Input[bool] run_tools_scripts_after_power_on: Enable the run of scripts after virtual machine power-on when VMware Tools is installed.
-        :param pulumi.Input[bool] run_tools_scripts_after_resume: Enable the run of scripts after virtual machine resume when when VMware Tools is installed.
-        :param pulumi.Input[bool] run_tools_scripts_before_guest_reboot: Enable the run of scripts before guest operating system reboot when VMware Tools is installed.
-        :param pulumi.Input[bool] run_tools_scripts_before_guest_shutdown: Enable the run of scripts before guest operating system shutdown when VMware Tools is installed.
-        :param pulumi.Input[bool] run_tools_scripts_before_guest_standby: Enable the run of scripts before guest operating system standby when VMware Tools is installed.
-        :param pulumi.Input[str] scsi_bus_sharing: Mode for sharing the SCSI bus. The modes are physicalSharing, virtualSharing, and noSharing.
-        :param pulumi.Input[str] scsi_type: The type of SCSI bus this virtual machine will have. Can be one of lsilogic, lsilogic-sas or pvscsi.
-        :param pulumi.Input[int] shutdown_wait_timeout: The amount of time, in minutes, to wait for shutdown when making necessary updates to the virtual machine.
-        :param pulumi.Input[str] storage_policy_id: The ID of the storage policy to assign to the virtual machine home directory.
-        :param pulumi.Input[str] swap_placement_policy: The swap file placement policy for this virtual machine. Can be one of inherit, hostLocal, or vmDirectory.
-        :param pulumi.Input[bool] sync_time_with_host: Enable guest clock synchronization with the host. On vSphere 7.0 U1 and above, with only this setting the clock is
-               synchronized on startup and resume. Requires VMware Tools to be installed.
-        :param pulumi.Input[bool] sync_time_with_host_periodically: Enable periodic clock synchronization with the host. Supported only on vSphere 7.0 U1 and above. On prior versions
-               setting `sync_time_with_host` is enough for periodic synchronization. Requires VMware Tools to be installed.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: A list of tag IDs to apply to this object.
-        :param pulumi.Input[str] tools_upgrade_policy: Set the upgrade policy for VMware Tools. Can be one of `manual` or `upgradeAtPowerCycle`.
-        :param pulumi.Input[pulumi.InputType['VirtualMachineVappArgs']] vapp: vApp configuration data for this virtual machine. Can be used to provide configuration data for OVF images.
-        :param pulumi.Input[bool] vbs_enabled: Flag to specify if Virtualization-based security is enabled for this virtual machine.
-        :param pulumi.Input[bool] vvtd_enabled: Flag to specify if I/O MMU virtualization, also called Intel Virtualization Technology for Directed I/O (VT-d) and AMD
-               I/O Virtualization (AMD-Vi or IOMMU), is enabled.
-        :param pulumi.Input[int] wait_for_guest_ip_timeout: The amount of time, in minutes, to wait for an available IP address on this virtual machine. A value less than 1
-               disables the waiter.
-        :param pulumi.Input[bool] wait_for_guest_net_routable: Controls whether or not the guest network waiter waits for a routable address. When false, the waiter does not wait for
-               a default gateway, nor are IP addresses checked against any discovered default gateways as part of its success criteria.
-        :param pulumi.Input[int] wait_for_guest_net_timeout: The amount of time, in minutes, to wait for an available IP address on this virtual machine. A value less than 1
-               disables the waiter.
+               
+               For example, `replace_trigger = sha256(format("%!s(MISSING)-%!s(MISSING)",data.template_file.cloud_init_metadata.rendered,data.template_file.cloud_init_userdata.rendered))` will fingerprint the changes in cloud-init metadata and userdata templates. This will enable a replacement of the resource whenever the dependant template renders a new configuration. (Forces a replacement.)
+        :param pulumi.Input[str] resource_pool_id: The managed object reference ID of the resource pool in which to place the virtual machine. See the Virtual Machine Migration section for more information on modifying this value.
+               
+               > **NOTE:** All clusters and standalone hosts have a default root resource pool. This resource argument does not directly accept the cluster or standalone host resource. For more information, see the section on specifying the Root Resource Pool in the `ResourcePool` data source documentation on using the root resource pool.
+        :param pulumi.Input[bool] run_tools_scripts_after_power_on: Enable post-power-on scripts to run when VMware Tools is installed. Default: `true`.
+        :param pulumi.Input[bool] run_tools_scripts_after_resume: Enable ost-resume scripts to run when VMware Tools is installed. Default: `true`.
+        :param pulumi.Input[bool] run_tools_scripts_before_guest_reboot: Enable pre-reboot scripts to run when VMware Tools is installed. Default: `false`.
+        :param pulumi.Input[bool] run_tools_scripts_before_guest_shutdown: Enable pre-shutdown scripts to run when VMware Tools is installed. Default: `true`.
+        :param pulumi.Input[bool] run_tools_scripts_before_guest_standby: Enable pre-standby scripts to run when VMware Tools is installed. Default: `true`.
+        :param pulumi.Input[int] sata_controller_count: The number of SATA controllers that Terraform manages on this virtual machine. This directly affects the amount of disks
+               you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove
+               controllers.
+        :param pulumi.Input[str] scsi_bus_sharing: The type of SCSI bus sharing for the virtual machine SCSI controller. One of `physicalSharing`, `virtualSharing`, and `noSharing`. Default: `noSharing`.
+        :param pulumi.Input[int] scsi_controller_count: The number of SCSI controllers that Terraform manages on this virtual machine. This directly affects the amount of disks
+               you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove
+               controllers.
+        :param pulumi.Input[str] scsi_type: The SCSI controller type for the virtual machine. One of `lsilogic` (LSI Logic Parallel), `lsilogic-sas` (LSI Logic SAS) or `pvscsi` (VMware Paravirtual). Default: `pvscsi`.
+        :param pulumi.Input[int] shutdown_wait_timeout: The amount of time, in minutes, to wait for a graceful guest shutdown when making necessary updates to the virtual machine. If `force_power_off` is set to `true`, the virtual machine will be forced to power-off after the timeout, otherwise an error is returned. Default: `3` minutes.
+        :param pulumi.Input[str] storage_policy_id: The UUID of the storage policy to assign to the virtual disk.
+        :param pulumi.Input[str] swap_placement_policy: The swap file placement policy for the virtual machine. One of `inherit`, `hostLocal`, or `vmDirectory`. Default: `inherit`.
+        :param pulumi.Input[bool] sync_time_with_host: Enable the guest operating system to synchronization its clock with the host when the virtual machine is powered on or resumed. Requires vSphere 7.0 Update 1 and later. Requires VMware Tools to be installed. Default: `true`.
+        :param pulumi.Input[bool] sync_time_with_host_periodically: Enable the guest operating system to periodically synchronize its clock with the host. Requires vSphere 7.0 Update 1 and later. On previous versions, setting `sync_time_with_host` is will enable periodic synchronization. Requires VMware Tools to be installed. Default: `false`.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource. Please refer to the `Tag` resource for more information on applying tags to virtual machine resources.
+               
+               > **NOTE:** Tagging support is unsupported on direct ESXi host connections and requires vCenter Server instance.
+        :param pulumi.Input[str] tools_upgrade_policy: Enable automatic upgrade of the VMware Tools version when the virtual machine is rebooted. If necessary, VMware Tools is upgraded to the latest version supported by the host on which the virtual machine is running. Requires VMware Tools to be installed. One of `manual` or `upgradeAtPowerCycle`. Default: `manual`.
+        :param pulumi.Input[pulumi.InputType['VirtualMachineVappArgs']] vapp: Used for vApp configurations. The only sub-key available is `properties`, which is a key/value map of properties for virtual machines imported from and OVF/OVA. See Using vApp Properties for OVF/OVA Configuration for more information.
+        :param pulumi.Input[bool] vbs_enabled: Enable Virtualization Based Security. Requires `firmware` to be `efi`. In addition, `vvtd_enabled`, `nested_hv_enabled`, and `efi_secure_boot_enabled` must all have a value of `true`. Supported on vSphere 6.7 and later. Default: `false`.
+        :param pulumi.Input[bool] vvtd_enabled: Enable Intel Virtualization Technology for Directed I/O for the virtual machine (_I/O MMU_ in the vSphere Client). Supported on vSphere 6.7 and later. Default: `false`.
+        :param pulumi.Input[int] wait_for_guest_ip_timeout: The amount of time, in minutes, to wait for an available guest IP address on the virtual machine. This should only be used if the version VMware Tools does not allow the `wait_for_guest_net_timeout` waiter to be used. A value less than `1` disables the waiter. Default: `0`.
+        :param pulumi.Input[bool] wait_for_guest_net_routable: Controls whether or not the guest network waiter waits for a routable address. When `false`, the waiter does not wait for a default gateway, nor are IP addresses checked against any discovered default gateways as part of its success criteria. This property is ignored if the `wait_for_guest_ip_timeout` waiter is used. Default: `true`.
+        :param pulumi.Input[int] wait_for_guest_net_timeout: The amount of time, in minutes, to wait for an available guest IP address on the virtual machine. Older versions of VMware Tools do not populate this property. In those cases, this waiter can be disabled and the `wait_for_guest_ip_timeout` waiter can be used instead. A value less than `1` disables the waiter. Default: `5` minutes.
         """
         ...
     @overload
@@ -3107,103 +3268,133 @@ class VirtualMachine(pulumi.CustomResource):
         :param str resource_name: The unique name of the resulting resource.
         :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[str] alternate_guest_name: The guest name for the operating system when guest_id is otherGuest or otherGuest64.
-        :param pulumi.Input[str] annotation: User-provided description of the virtual machine.
-        :param pulumi.Input[int] boot_delay: The number of milliseconds to wait before starting the boot sequence.
-        :param pulumi.Input[int] boot_retry_delay: The number of milliseconds to wait before retrying the boot sequence. This only valid if boot_retry_enabled is true.
-        :param pulumi.Input[bool] boot_retry_enabled: If set to true, a virtual machine that fails to boot will try again after the delay defined in boot_retry_delay.
-        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['VirtualMachineCdromArgs']]]] cdroms: A specification for a CDROM device on this virtual machine.
+        :param pulumi.Input[str] alternate_guest_name: The guest name for the operating system when `guest_id` is `otherGuest` or `otherGuest64`.
+        :param pulumi.Input[str] annotation: A user-provided description of the virtual machine.
+        :param pulumi.Input[int] boot_delay: The number of milliseconds to wait before starting the boot sequence. The default is no delay.
+        :param pulumi.Input[int] boot_retry_delay: The number of milliseconds to wait before retrying the boot sequence. This option is only valid if `boot_retry_enabled` is `true`. Default: `10000` (10 seconds).
+        :param pulumi.Input[bool] boot_retry_enabled: If set to `true`, a virtual machine that fails to boot will try again after the delay defined in `boot_retry_delay`. Default: `false`.
+        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['VirtualMachineCdromArgs']]]] cdroms: A specification for a CD-ROM device on the virtual machine. See CD-ROM options for more information.
         :param pulumi.Input[str] change_version: A unique identifier for a given version of the last configuration was applied.
-        :param pulumi.Input[pulumi.InputType['VirtualMachineCloneArgs']] clone: A specification for cloning a virtual machine from template.
-        :param pulumi.Input[bool] cpu_hot_add_enabled: Allow CPUs to be added to this virtual machine while it is running.
-        :param pulumi.Input[bool] cpu_hot_remove_enabled: Allow CPUs to be added to this virtual machine while it is running.
-        :param pulumi.Input[int] cpu_limit: The maximum amount of memory (in MB) or CPU (in MHz) that this virtual machine can consume, regardless of available
-               resources.
-        :param pulumi.Input[bool] cpu_performance_counters_enabled: Enable CPU performance counters on this virtual machine.
-        :param pulumi.Input[int] cpu_reservation: The amount of memory (in MB) or CPU (in MHz) that this virtual machine is guaranteed.
-        :param pulumi.Input[int] cpu_share_count: The amount of shares to allocate to cpu for a custom share level.
-        :param pulumi.Input[str] cpu_share_level: The allocation level for cpu resources. Can be one of high, low, normal, or custom.
-        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] custom_attributes: A list of custom attributes to set on this resource.
-        :param pulumi.Input[str] datacenter_id: The ID of the datacenter where the VM is to be created.
-        :param pulumi.Input[str] datastore_cluster_id: The ID of a datastore cluster to put the virtual machine in.
-        :param pulumi.Input[str] datastore_id: The ID of the virtual machine's datastore. The virtual machine configuration is placed here, along with any virtual
-               disks that are created without datastores.
+        :param pulumi.Input[pulumi.InputType['VirtualMachineCloneArgs']] clone: When specified, the virtual machine will be created as a clone of a specified template. Optional customization options can be submitted for the resource. See creating a virtual machine from a template for more information.
+        :param pulumi.Input[bool] cpu_hot_add_enabled: Allow CPUs to be added to the virtual machine while it is powered on.
+        :param pulumi.Input[bool] cpu_hot_remove_enabled: Allow CPUs to be removed to the virtual machine while it is powered on.
+        :param pulumi.Input[int] cpu_limit: The maximum amount of CPU (in MHz) that the virtual machine can consume, regardless of available resources. The default is no limit.
+        :param pulumi.Input[bool] cpu_performance_counters_enabled: Enable CPU performance counters on the virtual machine. Default: `false`.
+        :param pulumi.Input[int] cpu_reservation: The amount of CPU (in MHz) that the virtual machine is guaranteed. The default is no reservation.
+        :param pulumi.Input[int] cpu_share_count: The number of CPU shares allocated to the virtual machine when the `cpu_share_level` is `custom`.
+        :param pulumi.Input[str] cpu_share_level: The allocation level for the virtual machine CPU resources. One of `high`, `low`, `normal`, or `custom`. Default: `custom`.
+        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] custom_attributes: Map of custom attribute ids to attribute value strings to set for virtual machine. Please refer to the `vsphere_custom_attributes` resource for more information on setting custom attributes.
+               
+               > **NOTE:** Custom attributes requires vCenter Server and is not supported on direct ESXi host connections.
+        :param pulumi.Input[str] datacenter_id: The datacenter ID. Required only when deploying an OVF/OVA template.
+        :param pulumi.Input[str] datastore_cluster_id: The managed object reference ID of the datastore cluster in which to place the virtual machine. This setting applies to entire virtual machine and implies that you wish to use vSphere Storage DRS with the virtual machine. See the section on virtual machine migration for more information on modifying this value.
+               
+               > **NOTE:** One of `datastore_id` or `datastore_cluster_id` must be specified.
+               
+               > **NOTE:** Use of `datastore_cluster_id` requires vSphere Storage DRS to be enabled on the specified datastore cluster.
+               
+               > **NOTE:** The `datastore_cluster_id` setting applies to the entire virtual machine resource. You cannot assign individual individual disks to datastore clusters. In addition, you cannot use the `attach` setting to attach external disks on virtual machines that are assigned to datastore clusters.
+        :param pulumi.Input[str] datastore_id: The datastore ID that on which the ISO is located. Required for using a datastore ISO. Conflicts with `client_device`.
         :param pulumi.Input[str] default_ip_address: The IP address selected by the provider to be used with any provisioners configured on this resource. When possible, this is the first IPv4 address that is reachable through the default gateway configured on the machine, then the first reachable IPv6 address, and then the first general discovered address if neither exists. If  VMware Tools is not running on the virtual machine, or if the virtual machine is powered off, this value will be blank.
-        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['VirtualMachineDiskArgs']]]] disks: A specification for a virtual disk device on this virtual machine.
-        :param pulumi.Input[bool] efi_secure_boot_enabled: When the boot type set in firmware is efi, this enables EFI secure boot.
-        :param pulumi.Input[bool] enable_disk_uuid: Expose the UUIDs of attached virtual disks to the virtual machine, allowing access to them in the guest.
-        :param pulumi.Input[bool] enable_logging: Enable logging on this virtual machine.
-        :param pulumi.Input[str] ept_rvi_mode: The EPT/RVI (hardware memory virtualization) setting for this virtual machine. Can be one of automatic, on, or off.
-        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] extra_config: Extra configuration data for this virtual machine. Can be used to supply advanced parameters not normally in
-               configuration, such as instance metadata, or configuration data for OVF images.
-        :param pulumi.Input[bool] extra_config_reboot_required: Allow the virtual machine to be rebooted when a change to `extra_config` occurs.
-        :param pulumi.Input[str] firmware: The firmware interface to use on the virtual machine. Can be one of bios or efi.
-        :param pulumi.Input[str] folder: The name of the folder to locate the virtual machine in.
-        :param pulumi.Input[bool] force_power_off: Set to true to force power-off a virtual machine if a graceful guest shutdown failed for a necessary operation.
-        :param pulumi.Input[str] guest_id: The guest ID for the operating system.
+        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['VirtualMachineDiskArgs']]]] disks: A specification for a virtual disk device on the virtual machine. See disk options for more information.
+        :param pulumi.Input[bool] efi_secure_boot_enabled: Use this option to enable EFI secure boot when the `firmware` type is set to is `efi`. Default: `false`.
+               
+               > **NOTE:** EFI secure boot is only available on vSphere 6.5 and later.
+        :param pulumi.Input[bool] enable_disk_uuid: Expose the UUIDs of attached virtual disks to the virtual machine, allowing access to them in the guest. Default: `false`.
+        :param pulumi.Input[bool] enable_logging: Enable logging of virtual machine events to a log file stored in the virtual machine directory. Default: `false`.
+        :param pulumi.Input[str] ept_rvi_mode: The EPT/RVI (hardware memory virtualization) setting for the virtual machine. One of `automatic`, `on`, or `off`. Default: `automatic`.
+        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] extra_config: Extra configuration data for the virtual machine. Can be used to supply advanced parameters not normally in configuration, such as instance metadata and userdata.
+               
+               > **NOTE:** Do not use `extra_config` when working with a template imported from OVF/OVA as your settings may be ignored. Use the `vapp` block `properties` section as described in Using vApp Properties for OVF/OVA Configuration.
+        :param pulumi.Input[bool] extra_config_reboot_required: Allow the virtual machine to be rebooted when a change to `extra_config` occurs. Default: `true`.
+        :param pulumi.Input[str] firmware: The firmware for the virtual machine. One of `bios` or `efi`.
+        :param pulumi.Input[str] folder: The path to the virtual machine folder in which to place the virtual machine, relative to the datacenter path (`/<datacenter-name>/vm`).  For example, `/dc-01/vm/foo`
+        :param pulumi.Input[bool] force_power_off: If a guest shutdown failed or times out while updating or destroying (see `shutdown_wait_timeout`), force the power-off of the virtual machine. Default: `true`.
+        :param pulumi.Input[str] guest_id: The guest ID for the operating system type. For a full list of possible values, see [here][vmware-docs-guest-ids]. Default: `otherGuest64`.
+               
+               [vmware-docs-guest-ids]: https://vdc-repo.vmware.com/vmwb-repository/dcr-public/184bb3ba-6fa8-4574-a767-d0c96e2a38f4/ba9422ef-405c-47dd-8553-e11b619185b2/SDK/vsphere-ws/docs/ReferenceGuide/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html
         :param pulumi.Input[Sequence[pulumi.Input[str]]] guest_ip_addresses: The current list of IP addresses on this machine, including the value of `default_ip_address`. If VMware Tools is not running on the virtual machine, or if the virtul machine is powered off, this list will be empty.
-        :param pulumi.Input[int] hardware_version: The hardware version for the virtual machine.
-        :param pulumi.Input[str] host_system_id: The ID of an optional host system to pin the virtual machine to.
-        :param pulumi.Input[str] hv_mode: The (non-nested) hardware virtualization setting for this virtual machine. Can be one of hvAuto, hvOn, or hvOff.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] ignored_guest_ips: List of IP addresses and CIDR networks to ignore while waiting for an IP
+        :param pulumi.Input[int] hardware_version: The hardware version number. Valid range is from 4 to 21. The hardware version cannot be downgraded. See virtual machine hardware [versions][virtual-machine-hardware-versions] and [compatibility][virtual-machine-hardware-compatibility] for more information on supported settings.
+               
+               [virtual-machine-hardware-versions]: https://kb.vmware.com/s/article/1003746
+               [virtual-machine-hardware-compatibility]: https://kb.vmware.com/s/article/2007240
+        :param pulumi.Input[str] host_system_id: The managed object reference ID of a host on which to place the virtual machine. See the section on virtual machine migration for more information on modifying this value. When using a vSphere cluster, if a `host_system_id` is not supplied, vSphere will select a host in the cluster to place the virtual machine, according to any defaults or vSphere DRS placement policies.
+        :param pulumi.Input[str] hv_mode: The hardware virtualization (non-nested) setting for the virtual machine. One of `hvAuto`, `hvOn`, or `hvOff`. Default: `hvAuto`.
+        :param pulumi.Input[int] ide_controller_count: The number of IDE controllers that the virtual machine. This directly affects the number of disks you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove controllers. Default: `2`.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] ignored_guest_ips: List of IP addresses and CIDR networks to ignore while waiting for an available IP address using either of the waiters. Any IP addresses in this list will be ignored so that the waiter will continue to wait for a valid IP address. Default: `[]`.
         :param pulumi.Input[bool] imported: Indicates if the virtual machine resource has been imported, or if the state has been migrated from a previous version of the resource. It influences the behavior of the first post-import apply operation. See the section on importing below.
-        :param pulumi.Input[str] latency_sensitivity: Controls the scheduling delay of the virtual machine. Use a higher sensitivity for applications that require lower
-               latency, such as VOIP, media player applications, or applications that require frequent access to mouse or keyboard
-               devices. Can be one of low, normal, medium, or high.
-        :param pulumi.Input[int] memory: The size of the virtual machine's memory, in MB.
-        :param pulumi.Input[bool] memory_hot_add_enabled: Allow memory to be added to this virtual machine while it is running.
-        :param pulumi.Input[int] memory_limit: The maximum amount of memory (in MB) or CPU (in MHz) that this virtual machine can consume, regardless of available
-               resources.
-        :param pulumi.Input[int] memory_reservation: The amount of memory (in MB) or CPU (in MHz) that this virtual machine is guaranteed.
+        :param pulumi.Input[str] latency_sensitivity: Controls the scheduling delay of the virtual machine. Use a higher sensitivity for applications that require lower latency, such as VOIP, media player applications, or applications that require frequent access to mouse or keyboard devices. One of `low`, `normal`, `medium`, or `high`.
+               
+               > **NOTE:** On higher sensitivities, you may need to adjust the `memory_reservation` to the full amount of memory provisioned for the virtual machine.
+        :param pulumi.Input[int] memory: The memory size to assign to the virtual machine, in MB. Default: `1024` (1 GB).
+        :param pulumi.Input[bool] memory_hot_add_enabled: Allow memory to be added to the virtual machine while it is powered on.
+               
+               > **NOTE:** CPU and memory hot add options are not available on all guest operating systems. Please refer to the [VMware Guest OS Compatibility Guide][vmware-docs-compat-guide] to which settings are allow for your guest operating system. In addition, at least one `pulumi up` must be run before you are able to use CPU and memory hot add.
+               
+               [vmware-docs-compat-guide]: http://partnerweb.vmware.com/comp_guide2/pdf/VMware_GOS_Compatibility_Guide.pdf
+               
+               > **NOTE:** For Linux 64-bit guest operating systems with less than or equal to 3GB, the virtual machine must powered off to add memory beyond 3GB. Subsequent hot add of memory does not require the virtual machine to be powered-off to apply the plan. Please refer to [VMware KB 2008405][vmware-kb-2008405].
+               
+               [vmware-kb-2008405]: https://kb.vmware.com/s/article/2008405
+        :param pulumi.Input[int] memory_limit: The maximum amount of memory (in MB) that th virtual machine can consume, regardless of available resources. The default is no limit.
+        :param pulumi.Input[int] memory_reservation: The amount of memory (in MB) that the virtual machine is guaranteed. The default is no reservation.
         :param pulumi.Input[bool] memory_reservation_locked_to_max: If set true, memory resource reservation for this virtual machine will always be equal to the virtual machine's memory
                size;increases in memory size will be rejected when a corresponding reservation increase is not possible. This feature
                may only be enabled if it is currently possible to reserve all of the virtual machine's memory.
-        :param pulumi.Input[int] memory_share_count: The amount of shares to allocate to memory for a custom share level.
-        :param pulumi.Input[str] memory_share_level: The allocation level for memory resources. Can be one of high, low, normal, or custom.
-        :param pulumi.Input[int] migrate_wait_timeout: The amount of time, in minutes, to wait for a vMotion operation to complete before failing.
+        :param pulumi.Input[int] memory_share_count: The number of memory shares allocated to the virtual machine when the `memory_share_level` is `custom`.
+        :param pulumi.Input[str] memory_share_level: The allocation level for the virtual machine memory resources. One of `high`, `low`, `normal`, or `custom`. Default: `custom`.
+        :param pulumi.Input[int] migrate_wait_timeout: The amount of time, in minutes, to wait for a virtual machine migration to complete before failing. Default: `10` minutes. See the section on virtual machine migration for more information.
         :param pulumi.Input[str] moid: The managed object reference ID of the created virtual machine.
-        :param pulumi.Input[str] name: The name of this virtual machine.
-        :param pulumi.Input[bool] nested_hv_enabled: Enable nested hardware virtualization on this virtual machine, facilitating nested virtualization in the guest.
-        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['VirtualMachineNetworkInterfaceArgs']]]] network_interfaces: A specification for a virtual NIC on this virtual machine.
-        :param pulumi.Input[int] num_cores_per_socket: The number of cores to distribute amongst the CPUs in this virtual machine. If specified, the value supplied to num_cpus
-               must be evenly divisible by this value.
-        :param pulumi.Input[int] num_cpus: The number of virtual processors to assign to this virtual machine.
-        :param pulumi.Input[pulumi.InputType['VirtualMachineOvfDeployArgs']] ovf_deploy: A specification for deploying a virtual machine from ovf/ova template.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] pci_device_ids: A list of PCI passthrough devices
+        :param pulumi.Input[str] name: The name of the virtual machine.
+        :param pulumi.Input[bool] nested_hv_enabled: Enable nested hardware virtualization on the virtual machine, facilitating nested virtualization in the guest operating system. Default: `false`.
+        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['VirtualMachineNetworkInterfaceArgs']]]] network_interfaces: A specification for a virtual NIC on the virtual machine. See network interface options for more information.
+        :param pulumi.Input[int] num_cores_per_socket: The number of cores per socket in the virtual machine. The number of vCPUs on the virtual machine will be `num_cpus` divided by `num_cores_per_socket`. If specified, the value supplied to `num_cpus` must be evenly divisible by this value. Default: `1`.
+        :param pulumi.Input[int] num_cpus: The total number of virtual processor cores to assign to the virtual machine. Default: `1`.
+        :param pulumi.Input[pulumi.InputType['VirtualMachineOvfDeployArgs']] ovf_deploy: When specified, the virtual machine will be deployed from the provided OVF/OVA template. See creating a virtual machine from an OVF/OVA template for more information.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] pci_device_ids: List of host PCI device IDs in which to create PCI passthroughs.
+               
+               > **NOTE:** Cloning requires vCenter Server and is not supported on direct ESXi host connections.
         :param pulumi.Input[str] power_state: A computed value for the current power state of the virtual machine. One of `on`, `off`, or `suspended`.
         :param pulumi.Input[int] poweron_timeout: The amount of time, in seconds, that we will be trying to power on a VM
+        :param pulumi.Input[bool] reboot_required: Value internal to Terraform used to determine if a configuration set change requires a reboot.
         :param pulumi.Input[str] replace_trigger: Triggers replacement of resource whenever it changes.
-        :param pulumi.Input[str] resource_pool_id: The ID of a resource pool to put the virtual machine in.
-        :param pulumi.Input[bool] run_tools_scripts_after_power_on: Enable the run of scripts after virtual machine power-on when VMware Tools is installed.
-        :param pulumi.Input[bool] run_tools_scripts_after_resume: Enable the run of scripts after virtual machine resume when when VMware Tools is installed.
-        :param pulumi.Input[bool] run_tools_scripts_before_guest_reboot: Enable the run of scripts before guest operating system reboot when VMware Tools is installed.
-        :param pulumi.Input[bool] run_tools_scripts_before_guest_shutdown: Enable the run of scripts before guest operating system shutdown when VMware Tools is installed.
-        :param pulumi.Input[bool] run_tools_scripts_before_guest_standby: Enable the run of scripts before guest operating system standby when VMware Tools is installed.
-        :param pulumi.Input[str] scsi_bus_sharing: Mode for sharing the SCSI bus. The modes are physicalSharing, virtualSharing, and noSharing.
-        :param pulumi.Input[str] scsi_type: The type of SCSI bus this virtual machine will have. Can be one of lsilogic, lsilogic-sas or pvscsi.
-        :param pulumi.Input[int] shutdown_wait_timeout: The amount of time, in minutes, to wait for shutdown when making necessary updates to the virtual machine.
-        :param pulumi.Input[str] storage_policy_id: The ID of the storage policy to assign to the virtual machine home directory.
-        :param pulumi.Input[str] swap_placement_policy: The swap file placement policy for this virtual machine. Can be one of inherit, hostLocal, or vmDirectory.
-        :param pulumi.Input[bool] sync_time_with_host: Enable guest clock synchronization with the host. On vSphere 7.0 U1 and above, with only this setting the clock is
-               synchronized on startup and resume. Requires VMware Tools to be installed.
-        :param pulumi.Input[bool] sync_time_with_host_periodically: Enable periodic clock synchronization with the host. Supported only on vSphere 7.0 U1 and above. On prior versions
-               setting `sync_time_with_host` is enough for periodic synchronization. Requires VMware Tools to be installed.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: A list of tag IDs to apply to this object.
-        :param pulumi.Input[str] tools_upgrade_policy: Set the upgrade policy for VMware Tools. Can be one of `manual` or `upgradeAtPowerCycle`.
-        :param pulumi.Input[str] uuid: The UUID of the virtual machine. Also exposed as the `id` of the resource.
-        :param pulumi.Input[pulumi.InputType['VirtualMachineVappArgs']] vapp: vApp configuration data for this virtual machine. Can be used to provide configuration data for OVF images.
+               
+               For example, `replace_trigger = sha256(format("%!s(MISSING)-%!s(MISSING)",data.template_file.cloud_init_metadata.rendered,data.template_file.cloud_init_userdata.rendered))` will fingerprint the changes in cloud-init metadata and userdata templates. This will enable a replacement of the resource whenever the dependant template renders a new configuration. (Forces a replacement.)
+        :param pulumi.Input[str] resource_pool_id: The managed object reference ID of the resource pool in which to place the virtual machine. See the Virtual Machine Migration section for more information on modifying this value.
+               
+               > **NOTE:** All clusters and standalone hosts have a default root resource pool. This resource argument does not directly accept the cluster or standalone host resource. For more information, see the section on specifying the Root Resource Pool in the `ResourcePool` data source documentation on using the root resource pool.
+        :param pulumi.Input[bool] run_tools_scripts_after_power_on: Enable post-power-on scripts to run when VMware Tools is installed. Default: `true`.
+        :param pulumi.Input[bool] run_tools_scripts_after_resume: Enable ost-resume scripts to run when VMware Tools is installed. Default: `true`.
+        :param pulumi.Input[bool] run_tools_scripts_before_guest_reboot: Enable pre-reboot scripts to run when VMware Tools is installed. Default: `false`.
+        :param pulumi.Input[bool] run_tools_scripts_before_guest_shutdown: Enable pre-shutdown scripts to run when VMware Tools is installed. Default: `true`.
+        :param pulumi.Input[bool] run_tools_scripts_before_guest_standby: Enable pre-standby scripts to run when VMware Tools is installed. Default: `true`.
+        :param pulumi.Input[int] sata_controller_count: The number of SATA controllers that Terraform manages on this virtual machine. This directly affects the amount of disks
+               you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove
+               controllers.
+        :param pulumi.Input[str] scsi_bus_sharing: The type of SCSI bus sharing for the virtual machine SCSI controller. One of `physicalSharing`, `virtualSharing`, and `noSharing`. Default: `noSharing`.
+        :param pulumi.Input[int] scsi_controller_count: The number of SCSI controllers that Terraform manages on this virtual machine. This directly affects the amount of disks
+               you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove
+               controllers.
+        :param pulumi.Input[str] scsi_type: The SCSI controller type for the virtual machine. One of `lsilogic` (LSI Logic Parallel), `lsilogic-sas` (LSI Logic SAS) or `pvscsi` (VMware Paravirtual). Default: `pvscsi`.
+        :param pulumi.Input[int] shutdown_wait_timeout: The amount of time, in minutes, to wait for a graceful guest shutdown when making necessary updates to the virtual machine. If `force_power_off` is set to `true`, the virtual machine will be forced to power-off after the timeout, otherwise an error is returned. Default: `3` minutes.
+        :param pulumi.Input[str] storage_policy_id: The UUID of the storage policy to assign to the virtual disk.
+        :param pulumi.Input[str] swap_placement_policy: The swap file placement policy for the virtual machine. One of `inherit`, `hostLocal`, or `vmDirectory`. Default: `inherit`.
+        :param pulumi.Input[bool] sync_time_with_host: Enable the guest operating system to synchronization its clock with the host when the virtual machine is powered on or resumed. Requires vSphere 7.0 Update 1 and later. Requires VMware Tools to be installed. Default: `true`.
+        :param pulumi.Input[bool] sync_time_with_host_periodically: Enable the guest operating system to periodically synchronize its clock with the host. Requires vSphere 7.0 Update 1 and later. On previous versions, setting `sync_time_with_host` is will enable periodic synchronization. Requires VMware Tools to be installed. Default: `false`.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource. Please refer to the `Tag` resource for more information on applying tags to virtual machine resources.
+               
+               > **NOTE:** Tagging support is unsupported on direct ESXi host connections and requires vCenter Server instance.
+        :param pulumi.Input[str] tools_upgrade_policy: Enable automatic upgrade of the VMware Tools version when the virtual machine is rebooted. If necessary, VMware Tools is upgraded to the latest version supported by the host on which the virtual machine is running. Requires VMware Tools to be installed. One of `manual` or `upgradeAtPowerCycle`. Default: `manual`.
+        :param pulumi.Input[str] uuid: The UUID of the virtual disk VMDK file. This is used to track the virtual disk on the virtual machine.
+        :param pulumi.Input[pulumi.InputType['VirtualMachineVappArgs']] vapp: Used for vApp configurations. The only sub-key available is `properties`, which is a key/value map of properties for virtual machines imported from and OVF/OVA. See Using vApp Properties for OVF/OVA Configuration for more information.
         :param pulumi.Input[Sequence[pulumi.Input[str]]] vapp_transports: Computed value which is only valid for cloned virtual machines. A list of vApp transport methods supported by the source virtual machine or template.
-        :param pulumi.Input[bool] vbs_enabled: Flag to specify if Virtualization-based security is enabled for this virtual machine.
+        :param pulumi.Input[bool] vbs_enabled: Enable Virtualization Based Security. Requires `firmware` to be `efi`. In addition, `vvtd_enabled`, `nested_hv_enabled`, and `efi_secure_boot_enabled` must all have a value of `true`. Supported on vSphere 6.7 and later. Default: `false`.
         :param pulumi.Input[str] vmware_tools_status: The state of  VMware Tools in the guest. This will determine the proper course of action for some device operations.
         :param pulumi.Input[str] vmx_path: The path of the virtual machine configuration file on the datastore in which the virtual machine is placed.
-        :param pulumi.Input[bool] vvtd_enabled: Flag to specify if I/O MMU virtualization, also called Intel Virtualization Technology for Directed I/O (VT-d) and AMD
-               I/O Virtualization (AMD-Vi or IOMMU), is enabled.
-        :param pulumi.Input[int] wait_for_guest_ip_timeout: The amount of time, in minutes, to wait for an available IP address on this virtual machine. A value less than 1
-               disables the waiter.
-        :param pulumi.Input[bool] wait_for_guest_net_routable: Controls whether or not the guest network waiter waits for a routable address. When false, the waiter does not wait for
-               a default gateway, nor are IP addresses checked against any discovered default gateways as part of its success criteria.
-        :param pulumi.Input[int] wait_for_guest_net_timeout: The amount of time, in minutes, to wait for an available IP address on this virtual machine. A value less than 1
-               disables the waiter.
+        :param pulumi.Input[bool] vvtd_enabled: Enable Intel Virtualization Technology for Directed I/O for the virtual machine (_I/O MMU_ in the vSphere Client). Supported on vSphere 6.7 and later. Default: `false`.
+        :param pulumi.Input[int] wait_for_guest_ip_timeout: The amount of time, in minutes, to wait for an available guest IP address on the virtual machine. This should only be used if the version VMware Tools does not allow the `wait_for_guest_net_timeout` waiter to be used. A value less than `1` disables the waiter. Default: `0`.
+        :param pulumi.Input[bool] wait_for_guest_net_routable: Controls whether or not the guest network waiter waits for a routable address. When `false`, the waiter does not wait for a default gateway, nor are IP addresses checked against any discovered default gateways as part of its success criteria. This property is ignored if the `wait_for_guest_ip_timeout` waiter is used. Default: `true`.
+        :param pulumi.Input[int] wait_for_guest_net_timeout: The amount of time, in minutes, to wait for an available guest IP address on the virtual machine. Older versions of VMware Tools do not populate this property. In those cases, this waiter can be disabled and the `wait_for_guest_ip_timeout` waiter can be used instead. A value less than `1` disables the waiter. Default: `5` minutes.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
 
@@ -3301,7 +3492,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="alternateGuestName")
     def alternate_guest_name(self) -> pulumi.Output[Optional[str]]:
         """
-        The guest name for the operating system when guest_id is otherGuest or otherGuest64.
+        The guest name for the operating system when `guest_id` is `otherGuest` or `otherGuest64`.
         """
         return pulumi.get(self, "alternate_guest_name")
 
@@ -3309,7 +3500,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter
     def annotation(self) -> pulumi.Output[str]:
         """
-        User-provided description of the virtual machine.
+        A user-provided description of the virtual machine.
         """
         return pulumi.get(self, "annotation")
 
@@ -3317,7 +3508,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="bootDelay")
     def boot_delay(self) -> pulumi.Output[Optional[int]]:
         """
-        The number of milliseconds to wait before starting the boot sequence.
+        The number of milliseconds to wait before starting the boot sequence. The default is no delay.
         """
         return pulumi.get(self, "boot_delay")
 
@@ -3325,7 +3516,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="bootRetryDelay")
     def boot_retry_delay(self) -> pulumi.Output[Optional[int]]:
         """
-        The number of milliseconds to wait before retrying the boot sequence. This only valid if boot_retry_enabled is true.
+        The number of milliseconds to wait before retrying the boot sequence. This option is only valid if `boot_retry_enabled` is `true`. Default: `10000` (10 seconds).
         """
         return pulumi.get(self, "boot_retry_delay")
 
@@ -3333,7 +3524,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="bootRetryEnabled")
     def boot_retry_enabled(self) -> pulumi.Output[Optional[bool]]:
         """
-        If set to true, a virtual machine that fails to boot will try again after the delay defined in boot_retry_delay.
+        If set to `true`, a virtual machine that fails to boot will try again after the delay defined in `boot_retry_delay`. Default: `false`.
         """
         return pulumi.get(self, "boot_retry_enabled")
 
@@ -3341,7 +3532,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter
     def cdroms(self) -> pulumi.Output[Optional[Sequence['outputs.VirtualMachineCdrom']]]:
         """
-        A specification for a CDROM device on this virtual machine.
+        A specification for a CD-ROM device on the virtual machine. See CD-ROM options for more information.
         """
         return pulumi.get(self, "cdroms")
 
@@ -3357,7 +3548,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter
     def clone(self) -> pulumi.Output[Optional['outputs.VirtualMachineClone']]:
         """
-        A specification for cloning a virtual machine from template.
+        When specified, the virtual machine will be created as a clone of a specified template. Optional customization options can be submitted for the resource. See creating a virtual machine from a template for more information.
         """
         return pulumi.get(self, "clone")
 
@@ -3365,7 +3556,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="cpuHotAddEnabled")
     def cpu_hot_add_enabled(self) -> pulumi.Output[Optional[bool]]:
         """
-        Allow CPUs to be added to this virtual machine while it is running.
+        Allow CPUs to be added to the virtual machine while it is powered on.
         """
         return pulumi.get(self, "cpu_hot_add_enabled")
 
@@ -3373,7 +3564,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="cpuHotRemoveEnabled")
     def cpu_hot_remove_enabled(self) -> pulumi.Output[Optional[bool]]:
         """
-        Allow CPUs to be added to this virtual machine while it is running.
+        Allow CPUs to be removed to the virtual machine while it is powered on.
         """
         return pulumi.get(self, "cpu_hot_remove_enabled")
 
@@ -3381,8 +3572,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="cpuLimit")
     def cpu_limit(self) -> pulumi.Output[Optional[int]]:
         """
-        The maximum amount of memory (in MB) or CPU (in MHz) that this virtual machine can consume, regardless of available
-        resources.
+        The maximum amount of CPU (in MHz) that the virtual machine can consume, regardless of available resources. The default is no limit.
         """
         return pulumi.get(self, "cpu_limit")
 
@@ -3390,7 +3580,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="cpuPerformanceCountersEnabled")
     def cpu_performance_counters_enabled(self) -> pulumi.Output[Optional[bool]]:
         """
-        Enable CPU performance counters on this virtual machine.
+        Enable CPU performance counters on the virtual machine. Default: `false`.
         """
         return pulumi.get(self, "cpu_performance_counters_enabled")
 
@@ -3398,7 +3588,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="cpuReservation")
     def cpu_reservation(self) -> pulumi.Output[Optional[int]]:
         """
-        The amount of memory (in MB) or CPU (in MHz) that this virtual machine is guaranteed.
+        The amount of CPU (in MHz) that the virtual machine is guaranteed. The default is no reservation.
         """
         return pulumi.get(self, "cpu_reservation")
 
@@ -3406,7 +3596,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="cpuShareCount")
     def cpu_share_count(self) -> pulumi.Output[int]:
         """
-        The amount of shares to allocate to cpu for a custom share level.
+        The number of CPU shares allocated to the virtual machine when the `cpu_share_level` is `custom`.
         """
         return pulumi.get(self, "cpu_share_count")
 
@@ -3414,7 +3604,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="cpuShareLevel")
     def cpu_share_level(self) -> pulumi.Output[Optional[str]]:
         """
-        The allocation level for cpu resources. Can be one of high, low, normal, or custom.
+        The allocation level for the virtual machine CPU resources. One of `high`, `low`, `normal`, or `custom`. Default: `custom`.
         """
         return pulumi.get(self, "cpu_share_level")
 
@@ -3422,7 +3612,9 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="customAttributes")
     def custom_attributes(self) -> pulumi.Output[Optional[Mapping[str, str]]]:
         """
-        A list of custom attributes to set on this resource.
+        Map of custom attribute ids to attribute value strings to set for virtual machine. Please refer to the `vsphere_custom_attributes` resource for more information on setting custom attributes.
+
+        > **NOTE:** Custom attributes requires vCenter Server and is not supported on direct ESXi host connections.
         """
         return pulumi.get(self, "custom_attributes")
 
@@ -3430,7 +3622,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="datacenterId")
     def datacenter_id(self) -> pulumi.Output[Optional[str]]:
         """
-        The ID of the datacenter where the VM is to be created.
+        The datacenter ID. Required only when deploying an OVF/OVA template.
         """
         return pulumi.get(self, "datacenter_id")
 
@@ -3438,7 +3630,13 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="datastoreClusterId")
     def datastore_cluster_id(self) -> pulumi.Output[Optional[str]]:
         """
-        The ID of a datastore cluster to put the virtual machine in.
+        The managed object reference ID of the datastore cluster in which to place the virtual machine. This setting applies to entire virtual machine and implies that you wish to use vSphere Storage DRS with the virtual machine. See the section on virtual machine migration for more information on modifying this value.
+
+        > **NOTE:** One of `datastore_id` or `datastore_cluster_id` must be specified.
+
+        > **NOTE:** Use of `datastore_cluster_id` requires vSphere Storage DRS to be enabled on the specified datastore cluster.
+
+        > **NOTE:** The `datastore_cluster_id` setting applies to the entire virtual machine resource. You cannot assign individual individual disks to datastore clusters. In addition, you cannot use the `attach` setting to attach external disks on virtual machines that are assigned to datastore clusters.
         """
         return pulumi.get(self, "datastore_cluster_id")
 
@@ -3446,8 +3644,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="datastoreId")
     def datastore_id(self) -> pulumi.Output[str]:
         """
-        The ID of the virtual machine's datastore. The virtual machine configuration is placed here, along with any virtual
-        disks that are created without datastores.
+        The datastore ID that on which the ISO is located. Required for using a datastore ISO. Conflicts with `client_device`.
         """
         return pulumi.get(self, "datastore_id")
 
@@ -3463,7 +3660,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter
     def disks(self) -> pulumi.Output[Sequence['outputs.VirtualMachineDisk']]:
         """
-        A specification for a virtual disk device on this virtual machine.
+        A specification for a virtual disk device on the virtual machine. See disk options for more information.
         """
         return pulumi.get(self, "disks")
 
@@ -3471,7 +3668,9 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="efiSecureBootEnabled")
     def efi_secure_boot_enabled(self) -> pulumi.Output[Optional[bool]]:
         """
-        When the boot type set in firmware is efi, this enables EFI secure boot.
+        Use this option to enable EFI secure boot when the `firmware` type is set to is `efi`. Default: `false`.
+
+        > **NOTE:** EFI secure boot is only available on vSphere 6.5 and later.
         """
         return pulumi.get(self, "efi_secure_boot_enabled")
 
@@ -3479,7 +3678,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="enableDiskUuid")
     def enable_disk_uuid(self) -> pulumi.Output[Optional[bool]]:
         """
-        Expose the UUIDs of attached virtual disks to the virtual machine, allowing access to them in the guest.
+        Expose the UUIDs of attached virtual disks to the virtual machine, allowing access to them in the guest. Default: `false`.
         """
         return pulumi.get(self, "enable_disk_uuid")
 
@@ -3487,7 +3686,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="enableLogging")
     def enable_logging(self) -> pulumi.Output[Optional[bool]]:
         """
-        Enable logging on this virtual machine.
+        Enable logging of virtual machine events to a log file stored in the virtual machine directory. Default: `false`.
         """
         return pulumi.get(self, "enable_logging")
 
@@ -3495,7 +3694,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="eptRviMode")
     def ept_rvi_mode(self) -> pulumi.Output[Optional[str]]:
         """
-        The EPT/RVI (hardware memory virtualization) setting for this virtual machine. Can be one of automatic, on, or off.
+        The EPT/RVI (hardware memory virtualization) setting for the virtual machine. One of `automatic`, `on`, or `off`. Default: `automatic`.
         """
         return pulumi.get(self, "ept_rvi_mode")
 
@@ -3503,8 +3702,9 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="extraConfig")
     def extra_config(self) -> pulumi.Output[Optional[Mapping[str, str]]]:
         """
-        Extra configuration data for this virtual machine. Can be used to supply advanced parameters not normally in
-        configuration, such as instance metadata, or configuration data for OVF images.
+        Extra configuration data for the virtual machine. Can be used to supply advanced parameters not normally in configuration, such as instance metadata and userdata.
+
+        > **NOTE:** Do not use `extra_config` when working with a template imported from OVF/OVA as your settings may be ignored. Use the `vapp` block `properties` section as described in Using vApp Properties for OVF/OVA Configuration.
         """
         return pulumi.get(self, "extra_config")
 
@@ -3512,7 +3712,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="extraConfigRebootRequired")
     def extra_config_reboot_required(self) -> pulumi.Output[Optional[bool]]:
         """
-        Allow the virtual machine to be rebooted when a change to `extra_config` occurs.
+        Allow the virtual machine to be rebooted when a change to `extra_config` occurs. Default: `true`.
         """
         return pulumi.get(self, "extra_config_reboot_required")
 
@@ -3520,7 +3720,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter
     def firmware(self) -> pulumi.Output[Optional[str]]:
         """
-        The firmware interface to use on the virtual machine. Can be one of bios or efi.
+        The firmware for the virtual machine. One of `bios` or `efi`.
         """
         return pulumi.get(self, "firmware")
 
@@ -3528,7 +3728,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter
     def folder(self) -> pulumi.Output[Optional[str]]:
         """
-        The name of the folder to locate the virtual machine in.
+        The path to the virtual machine folder in which to place the virtual machine, relative to the datacenter path (`/<datacenter-name>/vm`).  For example, `/dc-01/vm/foo`
         """
         return pulumi.get(self, "folder")
 
@@ -3536,7 +3736,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="forcePowerOff")
     def force_power_off(self) -> pulumi.Output[Optional[bool]]:
         """
-        Set to true to force power-off a virtual machine if a graceful guest shutdown failed for a necessary operation.
+        If a guest shutdown failed or times out while updating or destroying (see `shutdown_wait_timeout`), force the power-off of the virtual machine. Default: `true`.
         """
         return pulumi.get(self, "force_power_off")
 
@@ -3544,7 +3744,9 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="guestId")
     def guest_id(self) -> pulumi.Output[str]:
         """
-        The guest ID for the operating system.
+        The guest ID for the operating system type. For a full list of possible values, see [here][vmware-docs-guest-ids]. Default: `otherGuest64`.
+
+        [vmware-docs-guest-ids]: https://vdc-repo.vmware.com/vmwb-repository/dcr-public/184bb3ba-6fa8-4574-a767-d0c96e2a38f4/ba9422ef-405c-47dd-8553-e11b619185b2/SDK/vsphere-ws/docs/ReferenceGuide/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html
         """
         return pulumi.get(self, "guest_id")
 
@@ -3560,7 +3762,10 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="hardwareVersion")
     def hardware_version(self) -> pulumi.Output[int]:
         """
-        The hardware version for the virtual machine.
+        The hardware version number. Valid range is from 4 to 21. The hardware version cannot be downgraded. See virtual machine hardware [versions][virtual-machine-hardware-versions] and [compatibility][virtual-machine-hardware-compatibility] for more information on supported settings.
+
+        [virtual-machine-hardware-versions]: https://kb.vmware.com/s/article/1003746
+        [virtual-machine-hardware-compatibility]: https://kb.vmware.com/s/article/2007240
         """
         return pulumi.get(self, "hardware_version")
 
@@ -3568,7 +3773,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="hostSystemId")
     def host_system_id(self) -> pulumi.Output[str]:
         """
-        The ID of an optional host system to pin the virtual machine to.
+        The managed object reference ID of a host on which to place the virtual machine. See the section on virtual machine migration for more information on modifying this value. When using a vSphere cluster, if a `host_system_id` is not supplied, vSphere will select a host in the cluster to place the virtual machine, according to any defaults or vSphere DRS placement policies.
         """
         return pulumi.get(self, "host_system_id")
 
@@ -3576,20 +3781,23 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="hvMode")
     def hv_mode(self) -> pulumi.Output[Optional[str]]:
         """
-        The (non-nested) hardware virtualization setting for this virtual machine. Can be one of hvAuto, hvOn, or hvOff.
+        The hardware virtualization (non-nested) setting for the virtual machine. One of `hvAuto`, `hvOn`, or `hvOff`. Default: `hvAuto`.
         """
         return pulumi.get(self, "hv_mode")
 
     @property
     @pulumi.getter(name="ideControllerCount")
     def ide_controller_count(self) -> pulumi.Output[Optional[int]]:
+        """
+        The number of IDE controllers that the virtual machine. This directly affects the number of disks you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove controllers. Default: `2`.
+        """
         return pulumi.get(self, "ide_controller_count")
 
     @property
     @pulumi.getter(name="ignoredGuestIps")
     def ignored_guest_ips(self) -> pulumi.Output[Optional[Sequence[str]]]:
         """
-        List of IP addresses and CIDR networks to ignore while waiting for an IP
+        List of IP addresses and CIDR networks to ignore while waiting for an available IP address using either of the waiters. Any IP addresses in this list will be ignored so that the waiter will continue to wait for a valid IP address. Default: `[]`.
         """
         return pulumi.get(self, "ignored_guest_ips")
 
@@ -3605,9 +3813,9 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="latencySensitivity")
     def latency_sensitivity(self) -> pulumi.Output[Optional[str]]:
         """
-        Controls the scheduling delay of the virtual machine. Use a higher sensitivity for applications that require lower
-        latency, such as VOIP, media player applications, or applications that require frequent access to mouse or keyboard
-        devices. Can be one of low, normal, medium, or high.
+        Controls the scheduling delay of the virtual machine. Use a higher sensitivity for applications that require lower latency, such as VOIP, media player applications, or applications that require frequent access to mouse or keyboard devices. One of `low`, `normal`, `medium`, or `high`.
+
+        > **NOTE:** On higher sensitivities, you may need to adjust the `memory_reservation` to the full amount of memory provisioned for the virtual machine.
         """
         return pulumi.get(self, "latency_sensitivity")
 
@@ -3615,7 +3823,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter
     def memory(self) -> pulumi.Output[Optional[int]]:
         """
-        The size of the virtual machine's memory, in MB.
+        The memory size to assign to the virtual machine, in MB. Default: `1024` (1 GB).
         """
         return pulumi.get(self, "memory")
 
@@ -3623,7 +3831,15 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="memoryHotAddEnabled")
     def memory_hot_add_enabled(self) -> pulumi.Output[Optional[bool]]:
         """
-        Allow memory to be added to this virtual machine while it is running.
+        Allow memory to be added to the virtual machine while it is powered on.
+
+        > **NOTE:** CPU and memory hot add options are not available on all guest operating systems. Please refer to the [VMware Guest OS Compatibility Guide][vmware-docs-compat-guide] to which settings are allow for your guest operating system. In addition, at least one `pulumi up` must be run before you are able to use CPU and memory hot add.
+
+        [vmware-docs-compat-guide]: http://partnerweb.vmware.com/comp_guide2/pdf/VMware_GOS_Compatibility_Guide.pdf
+
+        > **NOTE:** For Linux 64-bit guest operating systems with less than or equal to 3GB, the virtual machine must powered off to add memory beyond 3GB. Subsequent hot add of memory does not require the virtual machine to be powered-off to apply the plan. Please refer to [VMware KB 2008405][vmware-kb-2008405].
+
+        [vmware-kb-2008405]: https://kb.vmware.com/s/article/2008405
         """
         return pulumi.get(self, "memory_hot_add_enabled")
 
@@ -3631,8 +3847,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="memoryLimit")
     def memory_limit(self) -> pulumi.Output[Optional[int]]:
         """
-        The maximum amount of memory (in MB) or CPU (in MHz) that this virtual machine can consume, regardless of available
-        resources.
+        The maximum amount of memory (in MB) that th virtual machine can consume, regardless of available resources. The default is no limit.
         """
         return pulumi.get(self, "memory_limit")
 
@@ -3640,7 +3855,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="memoryReservation")
     def memory_reservation(self) -> pulumi.Output[Optional[int]]:
         """
-        The amount of memory (in MB) or CPU (in MHz) that this virtual machine is guaranteed.
+        The amount of memory (in MB) that the virtual machine is guaranteed. The default is no reservation.
         """
         return pulumi.get(self, "memory_reservation")
 
@@ -3658,7 +3873,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="memoryShareCount")
     def memory_share_count(self) -> pulumi.Output[int]:
         """
-        The amount of shares to allocate to memory for a custom share level.
+        The number of memory shares allocated to the virtual machine when the `memory_share_level` is `custom`.
         """
         return pulumi.get(self, "memory_share_count")
 
@@ -3666,7 +3881,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="memoryShareLevel")
     def memory_share_level(self) -> pulumi.Output[Optional[str]]:
         """
-        The allocation level for memory resources. Can be one of high, low, normal, or custom.
+        The allocation level for the virtual machine memory resources. One of `high`, `low`, `normal`, or `custom`. Default: `custom`.
         """
         return pulumi.get(self, "memory_share_level")
 
@@ -3674,7 +3889,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="migrateWaitTimeout")
     def migrate_wait_timeout(self) -> pulumi.Output[Optional[int]]:
         """
-        The amount of time, in minutes, to wait for a vMotion operation to complete before failing.
+        The amount of time, in minutes, to wait for a virtual machine migration to complete before failing. Default: `10` minutes. See the section on virtual machine migration for more information.
         """
         return pulumi.get(self, "migrate_wait_timeout")
 
@@ -3690,7 +3905,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter
     def name(self) -> pulumi.Output[str]:
         """
-        The name of this virtual machine.
+        The name of the virtual machine.
         """
         return pulumi.get(self, "name")
 
@@ -3698,7 +3913,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="nestedHvEnabled")
     def nested_hv_enabled(self) -> pulumi.Output[Optional[bool]]:
         """
-        Enable nested hardware virtualization on this virtual machine, facilitating nested virtualization in the guest.
+        Enable nested hardware virtualization on the virtual machine, facilitating nested virtualization in the guest operating system. Default: `false`.
         """
         return pulumi.get(self, "nested_hv_enabled")
 
@@ -3706,7 +3921,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="networkInterfaces")
     def network_interfaces(self) -> pulumi.Output[Optional[Sequence['outputs.VirtualMachineNetworkInterface']]]:
         """
-        A specification for a virtual NIC on this virtual machine.
+        A specification for a virtual NIC on the virtual machine. See network interface options for more information.
         """
         return pulumi.get(self, "network_interfaces")
 
@@ -3714,8 +3929,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="numCoresPerSocket")
     def num_cores_per_socket(self) -> pulumi.Output[Optional[int]]:
         """
-        The number of cores to distribute amongst the CPUs in this virtual machine. If specified, the value supplied to num_cpus
-        must be evenly divisible by this value.
+        The number of cores per socket in the virtual machine. The number of vCPUs on the virtual machine will be `num_cpus` divided by `num_cores_per_socket`. If specified, the value supplied to `num_cpus` must be evenly divisible by this value. Default: `1`.
         """
         return pulumi.get(self, "num_cores_per_socket")
 
@@ -3723,7 +3937,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="numCpus")
     def num_cpus(self) -> pulumi.Output[Optional[int]]:
         """
-        The number of virtual processors to assign to this virtual machine.
+        The total number of virtual processor cores to assign to the virtual machine. Default: `1`.
         """
         return pulumi.get(self, "num_cpus")
 
@@ -3731,7 +3945,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="ovfDeploy")
     def ovf_deploy(self) -> pulumi.Output[Optional['outputs.VirtualMachineOvfDeploy']]:
         """
-        A specification for deploying a virtual machine from ovf/ova template.
+        When specified, the virtual machine will be deployed from the provided OVF/OVA template. See creating a virtual machine from an OVF/OVA template for more information.
         """
         return pulumi.get(self, "ovf_deploy")
 
@@ -3739,7 +3953,9 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="pciDeviceIds")
     def pci_device_ids(self) -> pulumi.Output[Optional[Sequence[str]]]:
         """
-        A list of PCI passthrough devices
+        List of host PCI device IDs in which to create PCI passthroughs.
+
+        > **NOTE:** Cloning requires vCenter Server and is not supported on direct ESXi host connections.
         """
         return pulumi.get(self, "pci_device_ids")
 
@@ -3762,6 +3978,9 @@ class VirtualMachine(pulumi.CustomResource):
     @property
     @pulumi.getter(name="rebootRequired")
     def reboot_required(self) -> pulumi.Output[bool]:
+        """
+        Value internal to Terraform used to determine if a configuration set change requires a reboot.
+        """
         return pulumi.get(self, "reboot_required")
 
     @property
@@ -3769,6 +3988,8 @@ class VirtualMachine(pulumi.CustomResource):
     def replace_trigger(self) -> pulumi.Output[Optional[str]]:
         """
         Triggers replacement of resource whenever it changes.
+
+        For example, `replace_trigger = sha256(format("%!s(MISSING)-%!s(MISSING)",data.template_file.cloud_init_metadata.rendered,data.template_file.cloud_init_userdata.rendered))` will fingerprint the changes in cloud-init metadata and userdata templates. This will enable a replacement of the resource whenever the dependant template renders a new configuration. (Forces a replacement.)
         """
         return pulumi.get(self, "replace_trigger")
 
@@ -3776,7 +3997,9 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="resourcePoolId")
     def resource_pool_id(self) -> pulumi.Output[str]:
         """
-        The ID of a resource pool to put the virtual machine in.
+        The managed object reference ID of the resource pool in which to place the virtual machine. See the Virtual Machine Migration section for more information on modifying this value.
+
+        > **NOTE:** All clusters and standalone hosts have a default root resource pool. This resource argument does not directly accept the cluster or standalone host resource. For more information, see the section on specifying the Root Resource Pool in the `ResourcePool` data source documentation on using the root resource pool.
         """
         return pulumi.get(self, "resource_pool_id")
 
@@ -3784,7 +4007,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="runToolsScriptsAfterPowerOn")
     def run_tools_scripts_after_power_on(self) -> pulumi.Output[Optional[bool]]:
         """
-        Enable the run of scripts after virtual machine power-on when VMware Tools is installed.
+        Enable post-power-on scripts to run when VMware Tools is installed. Default: `true`.
         """
         return pulumi.get(self, "run_tools_scripts_after_power_on")
 
@@ -3792,7 +4015,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="runToolsScriptsAfterResume")
     def run_tools_scripts_after_resume(self) -> pulumi.Output[Optional[bool]]:
         """
-        Enable the run of scripts after virtual machine resume when when VMware Tools is installed.
+        Enable ost-resume scripts to run when VMware Tools is installed. Default: `true`.
         """
         return pulumi.get(self, "run_tools_scripts_after_resume")
 
@@ -3800,7 +4023,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="runToolsScriptsBeforeGuestReboot")
     def run_tools_scripts_before_guest_reboot(self) -> pulumi.Output[Optional[bool]]:
         """
-        Enable the run of scripts before guest operating system reboot when VMware Tools is installed.
+        Enable pre-reboot scripts to run when VMware Tools is installed. Default: `false`.
         """
         return pulumi.get(self, "run_tools_scripts_before_guest_reboot")
 
@@ -3808,7 +4031,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="runToolsScriptsBeforeGuestShutdown")
     def run_tools_scripts_before_guest_shutdown(self) -> pulumi.Output[Optional[bool]]:
         """
-        Enable the run of scripts before guest operating system shutdown when VMware Tools is installed.
+        Enable pre-shutdown scripts to run when VMware Tools is installed. Default: `true`.
         """
         return pulumi.get(self, "run_tools_scripts_before_guest_shutdown")
 
@@ -3816,33 +4039,43 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="runToolsScriptsBeforeGuestStandby")
     def run_tools_scripts_before_guest_standby(self) -> pulumi.Output[Optional[bool]]:
         """
-        Enable the run of scripts before guest operating system standby when VMware Tools is installed.
+        Enable pre-standby scripts to run when VMware Tools is installed. Default: `true`.
         """
         return pulumi.get(self, "run_tools_scripts_before_guest_standby")
 
     @property
     @pulumi.getter(name="sataControllerCount")
     def sata_controller_count(self) -> pulumi.Output[Optional[int]]:
+        """
+        The number of SATA controllers that Terraform manages on this virtual machine. This directly affects the amount of disks
+        you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove
+        controllers.
+        """
         return pulumi.get(self, "sata_controller_count")
 
     @property
     @pulumi.getter(name="scsiBusSharing")
     def scsi_bus_sharing(self) -> pulumi.Output[Optional[str]]:
         """
-        Mode for sharing the SCSI bus. The modes are physicalSharing, virtualSharing, and noSharing.
+        The type of SCSI bus sharing for the virtual machine SCSI controller. One of `physicalSharing`, `virtualSharing`, and `noSharing`. Default: `noSharing`.
         """
         return pulumi.get(self, "scsi_bus_sharing")
 
     @property
     @pulumi.getter(name="scsiControllerCount")
     def scsi_controller_count(self) -> pulumi.Output[Optional[int]]:
+        """
+        The number of SCSI controllers that Terraform manages on this virtual machine. This directly affects the amount of disks
+        you can add to the virtual machine and the maximum disk unit number. Note that lowering this value does not remove
+        controllers.
+        """
         return pulumi.get(self, "scsi_controller_count")
 
     @property
     @pulumi.getter(name="scsiType")
     def scsi_type(self) -> pulumi.Output[Optional[str]]:
         """
-        The type of SCSI bus this virtual machine will have. Can be one of lsilogic, lsilogic-sas or pvscsi.
+        The SCSI controller type for the virtual machine. One of `lsilogic` (LSI Logic Parallel), `lsilogic-sas` (LSI Logic SAS) or `pvscsi` (VMware Paravirtual). Default: `pvscsi`.
         """
         return pulumi.get(self, "scsi_type")
 
@@ -3850,7 +4083,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="shutdownWaitTimeout")
     def shutdown_wait_timeout(self) -> pulumi.Output[Optional[int]]:
         """
-        The amount of time, in minutes, to wait for shutdown when making necessary updates to the virtual machine.
+        The amount of time, in minutes, to wait for a graceful guest shutdown when making necessary updates to the virtual machine. If `force_power_off` is set to `true`, the virtual machine will be forced to power-off after the timeout, otherwise an error is returned. Default: `3` minutes.
         """
         return pulumi.get(self, "shutdown_wait_timeout")
 
@@ -3858,7 +4091,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="storagePolicyId")
     def storage_policy_id(self) -> pulumi.Output[str]:
         """
-        The ID of the storage policy to assign to the virtual machine home directory.
+        The UUID of the storage policy to assign to the virtual disk.
         """
         return pulumi.get(self, "storage_policy_id")
 
@@ -3866,7 +4099,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="swapPlacementPolicy")
     def swap_placement_policy(self) -> pulumi.Output[Optional[str]]:
         """
-        The swap file placement policy for this virtual machine. Can be one of inherit, hostLocal, or vmDirectory.
+        The swap file placement policy for the virtual machine. One of `inherit`, `hostLocal`, or `vmDirectory`. Default: `inherit`.
         """
         return pulumi.get(self, "swap_placement_policy")
 
@@ -3874,8 +4107,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="syncTimeWithHost")
     def sync_time_with_host(self) -> pulumi.Output[Optional[bool]]:
         """
-        Enable guest clock synchronization with the host. On vSphere 7.0 U1 and above, with only this setting the clock is
-        synchronized on startup and resume. Requires VMware Tools to be installed.
+        Enable the guest operating system to synchronization its clock with the host when the virtual machine is powered on or resumed. Requires vSphere 7.0 Update 1 and later. Requires VMware Tools to be installed. Default: `true`.
         """
         return pulumi.get(self, "sync_time_with_host")
 
@@ -3883,8 +4115,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="syncTimeWithHostPeriodically")
     def sync_time_with_host_periodically(self) -> pulumi.Output[Optional[bool]]:
         """
-        Enable periodic clock synchronization with the host. Supported only on vSphere 7.0 U1 and above. On prior versions
-        setting `sync_time_with_host` is enough for periodic synchronization. Requires VMware Tools to be installed.
+        Enable the guest operating system to periodically synchronize its clock with the host. Requires vSphere 7.0 Update 1 and later. On previous versions, setting `sync_time_with_host` is will enable periodic synchronization. Requires VMware Tools to be installed. Default: `false`.
         """
         return pulumi.get(self, "sync_time_with_host_periodically")
 
@@ -3892,7 +4123,9 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter
     def tags(self) -> pulumi.Output[Optional[Sequence[str]]]:
         """
-        A list of tag IDs to apply to this object.
+        The IDs of any tags to attach to this resource. Please refer to the `Tag` resource for more information on applying tags to virtual machine resources.
+
+        > **NOTE:** Tagging support is unsupported on direct ESXi host connections and requires vCenter Server instance.
         """
         return pulumi.get(self, "tags")
 
@@ -3900,7 +4133,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="toolsUpgradePolicy")
     def tools_upgrade_policy(self) -> pulumi.Output[Optional[str]]:
         """
-        Set the upgrade policy for VMware Tools. Can be one of `manual` or `upgradeAtPowerCycle`.
+        Enable automatic upgrade of the VMware Tools version when the virtual machine is rebooted. If necessary, VMware Tools is upgraded to the latest version supported by the host on which the virtual machine is running. Requires VMware Tools to be installed. One of `manual` or `upgradeAtPowerCycle`. Default: `manual`.
         """
         return pulumi.get(self, "tools_upgrade_policy")
 
@@ -3908,7 +4141,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter
     def uuid(self) -> pulumi.Output[str]:
         """
-        The UUID of the virtual machine. Also exposed as the `id` of the resource.
+        The UUID of the virtual disk VMDK file. This is used to track the virtual disk on the virtual machine.
         """
         return pulumi.get(self, "uuid")
 
@@ -3916,7 +4149,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter
     def vapp(self) -> pulumi.Output[Optional['outputs.VirtualMachineVapp']]:
         """
-        vApp configuration data for this virtual machine. Can be used to provide configuration data for OVF images.
+        Used for vApp configurations. The only sub-key available is `properties`, which is a key/value map of properties for virtual machines imported from and OVF/OVA. See Using vApp Properties for OVF/OVA Configuration for more information.
         """
         return pulumi.get(self, "vapp")
 
@@ -3932,7 +4165,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="vbsEnabled")
     def vbs_enabled(self) -> pulumi.Output[Optional[bool]]:
         """
-        Flag to specify if Virtualization-based security is enabled for this virtual machine.
+        Enable Virtualization Based Security. Requires `firmware` to be `efi`. In addition, `vvtd_enabled`, `nested_hv_enabled`, and `efi_secure_boot_enabled` must all have a value of `true`. Supported on vSphere 6.7 and later. Default: `false`.
         """
         return pulumi.get(self, "vbs_enabled")
 
@@ -3956,8 +4189,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="vvtdEnabled")
     def vvtd_enabled(self) -> pulumi.Output[Optional[bool]]:
         """
-        Flag to specify if I/O MMU virtualization, also called Intel Virtualization Technology for Directed I/O (VT-d) and AMD
-        I/O Virtualization (AMD-Vi or IOMMU), is enabled.
+        Enable Intel Virtualization Technology for Directed I/O for the virtual machine (_I/O MMU_ in the vSphere Client). Supported on vSphere 6.7 and later. Default: `false`.
         """
         return pulumi.get(self, "vvtd_enabled")
 
@@ -3965,8 +4197,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="waitForGuestIpTimeout")
     def wait_for_guest_ip_timeout(self) -> pulumi.Output[Optional[int]]:
         """
-        The amount of time, in minutes, to wait for an available IP address on this virtual machine. A value less than 1
-        disables the waiter.
+        The amount of time, in minutes, to wait for an available guest IP address on the virtual machine. This should only be used if the version VMware Tools does not allow the `wait_for_guest_net_timeout` waiter to be used. A value less than `1` disables the waiter. Default: `0`.
         """
         return pulumi.get(self, "wait_for_guest_ip_timeout")
 
@@ -3974,8 +4205,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="waitForGuestNetRoutable")
     def wait_for_guest_net_routable(self) -> pulumi.Output[Optional[bool]]:
         """
-        Controls whether or not the guest network waiter waits for a routable address. When false, the waiter does not wait for
-        a default gateway, nor are IP addresses checked against any discovered default gateways as part of its success criteria.
+        Controls whether or not the guest network waiter waits for a routable address. When `false`, the waiter does not wait for a default gateway, nor are IP addresses checked against any discovered default gateways as part of its success criteria. This property is ignored if the `wait_for_guest_ip_timeout` waiter is used. Default: `true`.
         """
         return pulumi.get(self, "wait_for_guest_net_routable")
 
@@ -3983,8 +4213,7 @@ class VirtualMachine(pulumi.CustomResource):
     @pulumi.getter(name="waitForGuestNetTimeout")
     def wait_for_guest_net_timeout(self) -> pulumi.Output[Optional[int]]:
         """
-        The amount of time, in minutes, to wait for an available IP address on this virtual machine. A value less than 1
-        disables the waiter.
+        The amount of time, in minutes, to wait for an available guest IP address on the virtual machine. Older versions of VMware Tools do not populate this property. In those cases, this waiter can be disabled and the `wait_for_guest_ip_timeout` waiter can be used instead. A value less than `1` disables the waiter. Default: `5` minutes.
         """
         return pulumi.get(self, "wait_for_guest_net_timeout")