activities
latest
false
UiPath logo, featuring letters U and I in white
IT Automation Activities
Last updated Nov 15, 2024

Get VM

UiPath.VMware.Activities.CrossPlatform.VirtualMachine.GetVM

Description

Retrieves details about the specified virtual machine or template.

Project compatibility

Windows | Cross-platform

Configuration

  • Virtual Machine ID - Specifies the unique identifier of the virtual machine or template.
  • Virtual Machine Name - Specifies the full path of the new virtual machine, including the data center and its folder.

    Note: At least one of Virtual Machine ID or Virtual Machine Name parameters must have a value; if both have values, the "VirtualMachineId" takes the precedence.
Input
  • Timeout - Specifies how long to wait (in seconds) for the activity to run before an error is thrown. The default value is 300 seconds (5 minutes).
Output
  • Virtual Machine - Provides details about the newly created virtual machine.

    Note: The Virtual Machine parameter provides the following information:
    • ID - Specifies the ID of the virtual machine.
    • Name - Specifies the name Virtual machine.
    • Host - Specifies the host on which the virtual machine is running.
    • FullPath - Specifies the full path to the virtual machine, including datacenter and folder hierarchy.
    • IPAddress - Specifies the primary IP address assigned to the guest operating system, if known.
    • DNSName - Specifies the hostname of the guest operating system, if known.
    • GuestOS - Specifies the guest's operating system full name, if known.
    • GuestOSState - Specifies the guest's operating system state. Possible values are Running, ShuttingDown, Resetting, Standby, NotRunning, Unknown.
    • PowerState - Specifies the virtual machine power state. Possible values are PoweredOn, PoweredOff, Suspended.
    • VMwareToolsState - Specifies the current running status of VMware Tools in the guest operating system, if known. Possible values are NotRunning, Running, ExecutingScripts.
    • VMwareToolsVersionStatus - Specifies the current version status of VMware Tools. The possible values are Blacklisted, Current, NeedUpgrade, NotInstalled, SupportedNew, SupportedOld, TooNew, TooOld, Unmanaged.
    • IsTemplate - Indicates if the input represents a virtual machine template.
    • Tags - Specifies the list of tags assigned to the virtual machine or template.
Note: For retrieving the DNS Name and IP Address, you need to install the VMware tools on the Guest OS and to power on the machine at least once before initiating the request.
  • Description
  • Project compatibility
  • Configuration

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2024 UiPath. All rights reserved.