# Get VM

> `UiPath.VMware.Activities.CrossPlatform.VirtualMachine.GetVM`

`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.
:::