This is an archive version of the document. To get the most up-to-date information, see the current version.

Find-VBRViEntity

Short Description

Looks for VMware objects.

Applies to

Platform: VMware

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

Syntax

This cmdlet provides parameter sets that allow you to:

Look for VMware hosts and clusters.

Find-VBRViEntity [-Name <String[]>] [-Server <CHost[]>] [-HostsAndClusters <SwitchParameter>] [<CommonParameters>]

Look for VMware VMs and templates.

Find-VBRViEntity [-Name <String[]>] [-Server <CHost[]>] [-VMsAndTemplates <SwitchParameter>] [<CommonParameters>]

Look for VMware datastores and VMs.

Find-VBRViEntity [-Name <String[]>] [-Server <CHost[]>] [-DatastoresAndVMs <SwitchParameter>] [<CommonParameters>]

Look for VMware hosts and datastores.

Find-VBRViEntity [-Name <String[]>] [-Server <CHost[]>] [-HostsAndDatastores <SwitchParameter>] [<CommonParameters>]

Look for VMware resource pools.

Find-VBRViEntity [-Name <String[]>] [-Server <CHost[]>] [-ResourcePools <SwitchParameter>] [<CommonParameters>]

Look for VMware servers.

Find-VBRViEntity [-Name <String[]>] [-Server <CHost[]>] [-Servers <SwitchParameter>] [<CommonParameters>]

Look for VMware tags.

Find-VBRViEntity [-Name <String[]>] [-Server <CHost[]>] [-Tags <SwitchParameter>] [<CommonParameters>]

Detailed Description

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

Parameter	Description	Type	Required	Position	Accept Pipeline Input
Name	Specifies an array of VMware object names. The cmdlet will return entities with these names.	String[]	False	Named	True
Server	Specifies an array of ESXi hosts. The cmdlet will return entities created on these hosts.	Accepts the CHost[] object. To get this object, run the Get-VBRServer cmdlet.	False	Named	True (ByValue, ByProperty Name)
HostsAndClusters	Defines that the cmdlet will return only hosts and clusters.	SwitchParameter	False	Named	False
VMsAndTemplates	Defines that the cmdlet will return only VMs and templates.	SwitchParameter	False	Named	False
DatastoresAndVMs	Defines that the cmdlet will return only datastores and VMs.	SwitchParameter	False	Named	False
HostsAndDatastores	Defines that the cmdlet will return only hosts and datastores.	SwitchParameter	False	Named	False
ResourcePools	Defines that the cmdlet will return only resource pools.	SwitchParameter	False	Named	False
Servers	Defines that the cmdlet will return only VMware hosts.	SwitchParameter	False	Named	False
Tags	Defines that the cmdlet will return only tags. Note: To get the necessary tags of the VMware objects, you must specify the vCenter Server in the Server parameter. If you specify ESXi hosts, the cmdlet will not return any data. If you don't provide the Server parameter, the cmdlet will return tags for all servers, added to a backup infrastructure. To specify the tag name, use the Name parameter.	SwitchParameter	False	Named	False

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

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

Find-VBRViEntity Example 1. Getting List of Hosts and Clusters Connected to Specific ESXI Hosts

Find-VBRViEntity Example 2. Getting Specific Cluster from ESXI Host

Find-VBRViEntity Example 3. Getting List of Resource Pools

Find-VBRViEntity Example 4. Getting List of VMware Tags

Related Commands

Get-VBRServer