## PowerCLI Reference

# Get-Media

## Synopsis

This cmdlet retrieves cloud media.

Syntax

Get-Media [[-Name] <String[]>] [-Catalog <Catalog[]>] [-Server <CIServer[]>] [-Owner <CIUser[]>] [-InformationAction <ActionPreference>] [-InformationVariable <String>] [-PipelineVariable <String>] [<CommonParameters>]
Get-Media -Id <String[]> [-Server <CIServer[]>] [-InformationAction <ActionPreference>] [-InformationVariable <String>] [-PipelineVariable <String>] [<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

Name | Type | Description | Required? | Pipeline Input | Default Value
--- | --- | --- | --- | --- | ---
Name | String[] | Specifies the names of the media devices you want to retrieve. | false | false
Catalog | Catalog[] | Specifies the catalogs from which you want to retrieve media devices. | false | true (ByValue)
Id | String[] | 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. | true | false
InformationAction | ActionPreference |  | false | false
InformationVariable | String |  | false | false
Owner | CIUser[] | Specifies the owners of the cloud media you want to retrieve. | false | true (ByValue)
PipelineVariable | String |  | 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 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.