PowerCLI Reference

Get-Media

Synopsis

This cmdlet retrieves cloud media.

Syntax

Get-Media [[-Name] <String[]>] [-Catalog <Catalog[]>] [-Owner <CIUser[]>] [-Server <CIServer[]>] [<CommonParameters>]

Get-Media -Id <String[]> [-Server <CIServer[]>] [<CommonParameters>]

Related Commands

Online Version

Detailed Description

This cmdlet retrieves cloud media. You can filter the returned media by name, ID, catalog, and user.

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
NameString[]Specifies the names of the media devices you want to retrieve.falseFalse
CatalogCatalog[]Specifies the catalogs from which you want to retrieve media devices.falseTrue (ByValue)
IdString[]Specifies the IDs of the media devices you want to retrieve.


Note: When a list of values is specified for the Id parameter, the returned objects would have an ID that matches exactly one of the string values in that list.
trueFalse
OwnerCIUser[]Specifies the owners of the cloud media you want to retrieve.falseTrue (ByValue)
ServerCIServer[]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.falseFalse

Return Type

Zero or more Media objects

Notes

Examples

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

Get-Media -ID $cloudMediaId

Retrieves the cloud media devices with the provided IDs.

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

Get-Media -Name windows7*

Retrieves the cloud media devices with the provided names.

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

Get-Catalog -Name Catalog1 | Get-Media

Retrieves media from the cloud catalog named Catalog1.


Copyright © VMware, Inc. All rights reserved.