---
title: "Find-VBRViEntity"
description: "Looks for VMware objects. Platform: VMware Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet provides the following parameter sets: This cmdlet returns VMware objects connected to a specified ESXi host."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/find-vbrvientity.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Backup Infrastructure > Managing Infrastructure > Find-VBRViEntity"
dateModified: "2026-08-19"
---

# Find-VBRViEntity

## Short Description
Looks for VMware objects.

**Platform**: VMware

**Product Edition**: Standard, Enterprise, Enterprise Plus, Veeam Universal License

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>HostsAndClusters (Default)</code></p>

```
Find-VBRViEntity [-Name <String[]>] [-Server <CHost[]>] [-HostsAndClusters] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>VMsAndTemplates</code></p>

```
Find-VBRViEntity [-Name <String[]>] [-Server <CHost[]>] [-VMsAndTemplates] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>DatastoresAndVMs</code></p>

```
Find-VBRViEntity [-Name <String[]>] [-Server <CHost[]>] [-DatastoresAndVMs] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>HostsAndDatastores</code></p>

```
Find-VBRViEntity [-Name <String[]>] [-Server <CHost[]>] [-HostsAndDatastores] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>ResourcePools</code></p>

```
Find-VBRViEntity [-Name <String[]>] [-Server <CHost[]>] [-ResourcePools] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Servers</code></p>

```
Find-VBRViEntity [-Name <String[]>] [-Server <CHost[]>] [-Servers] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Tags</code></p>

```
Find-VBRViEntity [-Name <String[]>] [-Server <CHost[]>] [-Tags] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet returns VMware objects connected to a specified ESXi host.

## Parameters

<table style="width:100%;" class="Blue_Table">
      <tr style="vertical-align:top">
        <th style="width:20%;">
          <p>Parameter</p>
        </th>
        <th style="width:20%;">
          <p>Description</p>
        </th>
        <th style="width:20%;">
          <p>Type</p>
        </th>
        <th style="width:10%;">
          <p>Required</p>
        </th>
        <th style="width:10%;">
          <p>Position</p>
        </th>
        <th style="width:10%;">
          <p>Accept Pipeline Input</p>
        </th>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">DatastoresAndVMs</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will return only datastores and VMs.</p><p>Default: <code>False</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">HostsAndClusters</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will return only hosts and clusters.</p><p>Default: <code>False</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">HostsAndDatastores</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will return only hosts and datastores.</p><p>Default: <code>False</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Name</span></p>
        </td>
        <td>
          <p>Specifies an array of VMware object names. The cmdlet will return entities with these names.</p>
        </td>
        <td style="width:10%;">
          <p><code>String[]</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">ResourcePools</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will return only resource pools.</p><p>Default: <code>False</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Server</span></p>
        </td>
        <td>
          <p>Specifies an array of ESXi hosts. The cmdlet will return entities created on these hosts.</p><p>Accepts the <code>CHost[]</code> object. To get this object, run the <a href="get-vbrserver.md"><code>Get-VBRServer</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CHost[]</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Servers</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will return only VMware hosts.</p><p>Default: <code>False</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Tags</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will return only tags.</p><p>Default: <code>False</code>.</p><p><strong>Note</strong>:</p><ul><li>To get the necessary tags of the VMware objects, you must specify the vCenter Server in the <code>Server</code> parameter. If you specify ESXi hosts, the cmdlet will not return any data. If you don't provide the <code>Server</code> parameter, the cmdlet will return tags for all servers, added to a backup infrastructure.</li><li>To specify the tag name, use the <code>Name</code> parameter.</li></ul>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">VMsAndTemplates</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will return only VMs, folders and templates.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see [ Microsoft Docs](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-7).

## Output Object
The cmdlet returns the following VMware objects connected to a specified ESXi host:

- `CVcItem`
- `CViFolderItem`
- `CViDatacenterItem`
- `CEsxItem`
- `CViClusterItem`
- `CViResourcePoolItem`
- `CViVmItem`
- `CViVirtualAppItem`
- `CViTagItem`

## Examples

::: example
### Example 1. Getting List of Hosts and Clusters Connected to Specific ESXI Hosts

This example shows how to get a list of hosts and clusters that are connected to the following ESXi hosts: `ESXiHost 01` and `ESXiHost 02`.

```
$server = Get-VBRServer -Name "ESXiHost 01", "ESXiHost 02"
Find-VBRViEntity -HostsAndClusters -Server $server
```

Perform the following steps:

1. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable.
2. Run the `Find-VBRViEntity` cmdlet. Provide the `HostsAndClusters` parameter. Set the `$server` variable as the `Server` parameter value.

:::

::: example
### Example 2. Getting Specific Cluster from ESXI Host

This example shows how to get the `vSAN` ESXi cluster named located on the `ESX01` ESXiHost.

```
$server = Get-VBRServer -Name "ESX01"
Find-VBRViEntity -Server $server -HostsAndClusters -Name vSAN
```

Perform the following steps:

1. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable.
2. Run the `Find-VBRViEntity` cmdlet. Specify the following settings:

   - Set the `$server` variable as the `Server` parameter value.
   - Provide the `HostsAndClusters` parameter.
   - Specify the `Name` parameter value.

:::

::: example
### Example 3. Getting List of Resource Pools

This example shows how to get a list of resource pools with names starting with `Veeam`. The resource pools are located on the `ESX01` ESXi host.

```
$server = Get-VBRServer -Name "ESX01"
Find-VBRViEntity -Server $server -ResourcePools -Name Veeam*
```

Perform the following steps:

1. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable.
2. Run the `Find-VBRViEntity` cmdlet. Specify the following settings:

   - Set the `$server` variable as the `Server` parameter value.
   - Provide the `ResourcePools` parameter.
   - Specify the `Name` parameter value.

:::

::: example
### Example 4. Getting List of VMware Tags

This example shows how to get a list of the `Mac OS` VMware tags within the `vcenter05.tech.global` vCenter.

```
$server = Get-VBRServer -Name vcenter05.tech.global
Find-VBRViEntity -Server $server -Tags -Name "Mac OS"
```

Perform the following steps:

1. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable.
2. Run the `Find-VBRViEntity` cmdlet. Specify the following settings:

   - Set the `$server` variable as the `Server` parameter value.
   - Provide the `Tags` parameter.
   - Specify the `Name` parameter value.

:::

## Related Commands

[`Get-VBRServer`](get-vbrserver.md)