## PowerCLI Reference

# Search-Cloud

## Synopsis

This cmdlet searches the cloud for objects of the specified type.

Syntax

Search-Cloud [-Name <String[]>] [[-Filter] <String>] [-QueryType] <QueryType> [-Property <String[]>] [-Server <CIServer[]>] [-InformationAction <ActionPreference>] [-InformationVariable <String>] [-PipelineVariable <String>] [<CommonParameters>]

Related Commands

Online version

Detailed Description

This cmdlet searches the cloud for objects of the specified type. You can filter the returned objects by their properties. The cmdlet allows you to retrieve only specific properties of object.

Parameters

Name | Type | Description | Required? | Pipeline Input | Default Value
--- | --- | --- | --- | --- | ---
QueryType | QueryType | Specifies what types of objects you want to search for. | true | false
Filter | String | Specifies a filter criteria for the returned objects. | false | false
InformationAction | ActionPreference |  | false | false
InformationVariable | String |  | false | false
Name | String[] | Specifies the names of the objects to search for. This parameter supports only the "*" wildcard. For more information about the valid filter syntax, see the vCloud API Programming Guide. | false | false
PipelineVariable | String |  | false | false
Property | String[] | Specifies the properties you want to retrieve for the specified object type. If you do not provide a value for this parameter, the cmdlet returns all properties of the objects. | false | false
Server | CIServer[] | Specifies the cloud servers on which you want to run the cmdlet. If no value is given to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-CIServer. | false | false

Return Type

Zero or more CISearchResult objects

Notes

Examples

-------------- Example 1 --------------

    Search-Cloud -Type vAppTemplate

Searches the cloud server for virtual appliance templates. The user is connected as a cloud user.

-------------- Example 2 --------------

    Search-Cloud user -Name User1

Searches for a user by name.

-------------- Example 3 --------------

    Search-Cloud adminUser -Property 'Name', 'FullName'

Gets all the Name and FullName properties for all cloud users. You must be connected as a system administrator.

-------------- Example 4 --------------

    Search-Cloud vappTemplate -Filter 'isGoldMaster==True;isPublished==True'

Searches for public gold master vAppTemplate objects.

-------------- Example 5 --------------

    Search-Cloud -QueryType adminVAppTemplate

Searches the cloud server for virtual appliance templates. The user is connected as a cloud administrator.

Copyright © VMware, Inc. All rights reserved.