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

Find-VBRvCloudEntity

Short Description

Looks for vCloud Director entities.

Applies to

Platform: VMware

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

Find-VBRvCloudEntity [-Server <CHost[]>][-Full][-Name <string[]>] [<CommonParameters>]

Find-VBRvCloudEntity [-Server <CHost[]>][-VApp][-Name <string[]>] [<CommonParameters>]

Find-VBRvCloudEntity [-Server <CHost[]>][-Template][-Name <string[]>] [<CommonParameters>]

Find-VBRvCloudEntity [-Server <CHost[]>][-VmTemplate][-Name <string[]>] [<CommonParameters>]

Find-VBRvCloudEntity [-Server <CHost[]>][-OrganizationVdc][-Name <string[]>] [<CommonParameters>]

Find-VBRvCloudEntity [-Server <CHost[]>][-StorageProfile][-Name <string[]>] [<CommonParameters>]

Find-VBRvCloudEntity [-Server <CHost[]>][-Datastore][-Name <string[]>] [<CommonParameters>]

Find-VBRvCloudEntity [-Server <CHost[]>][-Vc][-Name <string[]>] [<CommonParameters>]

Related Commands

Get-VBRServer

Detailed Description

This cmdlet looks for vCloud Director entities.

You can get the whole list of vCloud entities, or the list of specified entities (i.e. vApps), or narrow down the output by filtering by name.

Return Type

CVcdSystemItem

CVcdOrganizationItem

CVcdOrganizationVdcItem

CVcdVappItem

CVcdVmItem

CVcdOrgVdcStorageProfile

CVcdDatastoreRestoreInfo

CVcdVcInfo

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

Server

Specifies the server(s) where the entity to look for is located.

You can assign multiple servers to this object.

False

Named

True (ByValue,
ByProperty
Name)

False

Full

View results as the list of all vCloud entities.

False

Named

False

False

VApp

View results as vApps.

False

Named

False

False

Template

View results as vApp templates.

False

Named

False

False

VmTemplate

View results as VM templates.

False

Named

False

False

Organization
Vdc

View results as Organization vDCs.

False

Named

False

False

StorageProfile

View results as storage profiles.

False

Named

False

False

Datastore

View results as datastores.

False

Named

False

False

Vc

View results as vCenter Servers managed by vCloud Director.

False

Named

False

False

Name

Specifies the name(s) of the entity.

You can specify multiple names separated by commas.

False

Named

False

True

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.

Example 1

This command looks for all vCloud entities registered on the server represented by $server variable. The server object is obtained with Get-VBRServer and assigned to the variable beforehand.

PS C:\PS> Find-VBRvCloudEntity -Server $server -Full

Example 2

This command looks for the vCloud entities registered on the server with 172.16.1.13 IP address. The server object is obtained with Get-VBRServer and piped down. The output is filtered by name containing "SQL".

PS C:\PS> Get-VBRServer -Name "172.16.1.13" | Find-VBRvCloudEntity -Name *SQL*

Example 3

This command looks for the vApps registered on the server named "vCloud Server". The server object is obtained with Get-VBRServer and piped down.

PS C:\PS> Get-VBRServer -Name "vCloud Server" | Find-VBRvCloudEntity -VApp

Example 4

This command looks for the datastore named "Datastore 04" registered on the server represented by $server variable. The server object is obtained with Get-VBRServer and assigned to the variable beforehand.

PS C:\PS> Find-VBRvCloudEntity -Server $server -Datastore -Name "Datastore 04"