3.15. Searching for Virtual Machines
The following table describes all search options for virtual machines.
Currently, the Network Label, Custom Emulated Machine, and Custom CPU Type properties are not supported search parameters.
| Property (of resource or resource-type) | Type | Description (Reference) |
|---|---|---|
|
| Depends on property type | The property of the hosts associated with the virtual machine. |
|
| Depends on property type | The property of the templates associated with the virtual machine. |
|
| Depends on property type | The property of the events associated with the virtual machine. |
|
| Depends on property type | The property of the users associated with the virtual machine. |
|
| Depends on the property type | The property of storage devices associated with the virtual machine. |
|
| Depends on the property type | The property of the VNIC associated with the virtual machine. |
|
| String | The name of the virtual machine. |
|
| List | The availability of the virtual machine. |
|
| Integer | The IP address of the virtual machine. |
|
| Integer | The number of minutes that the virtual machine has been running. |
|
| String | The domain (usually Active Directory domain) that groups these machines. |
|
| String | The operating system selected when the virtual machine was created. |
|
| Date | The date on which the virtual machine was created. |
|
| String | The unique name that identifies the virtual machine on the network. |
|
| Integer | The percent of processing power used. |
|
| Integer | The percentage of memory used. |
|
| Integer | The percentage of network used. |
|
| Integer | The maximum memory defined. |
|
| String | The applications currently installed on the virtual machine. |
|
| List | The cluster to which the virtual machine belongs. |
|
| List | The virtual machine pool to which the virtual machine belongs. |
|
| String | The name of the user currently logged in to the virtual machine. |
|
| List | The tags to which the virtual machine belongs. |
|
| String | The data center to which the virtual machine belongs. |
|
| List | The virtual machine type (server or desktop). |
|
| String | The name of the quota associated with the virtual machine. |
|
| String | Keywords or text describing the virtual machine, optionally used when creating the virtual machine. |
|
| List | Sorts the returned results by one of the resource properties. |
|
| Integer | The page number of results to display. |
|
| Boolean | The virtual machine has pending configuration changes. |
Example
Vms: template.name = Win* and user.name = ""
This example returns a list of virtual machines whose base template name begins with Win and are assigned to any user.
Example
Vms: cluster = Default and os = windows7
This example returns a list of virtual machines that belong to the Default cluster and are running Windows 7.
