Get-Media

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

Syntax

Get-Media

[-Catalog < Catalog[] > ]

[-Name < String[] > ]

[-Owner < CIUser[] > ]

[-ProgressAction < ActionPreference > ]

[-Server < CIServer[] > ]

[CommonParameters]

Required	Parameter Name	Type	Position	Features	Description
optional	Catalog	Catalog[]	named	pipeline wildcards	Specifies the catalogs from which you want to retrieve media devices.
optional	Name	String[]	named	wildcards	Specifies the names of the media devices you want to retrieve.
optional	Owner	CIUser[]	named	pipeline wildcards	Specifies the owners of the cloud media you want to retrieve.
optional	ProgressAction	ActionPreference	named
optional	Server	CIServer[]	named	wildcards	Specifies the cloud servers on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-CIServer.

Required	Parameter Name	Type	Position	Features	Description
required	Id	String[]	named		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.
optional	ProgressAction	ActionPreference	named
optional	Server	CIServer[]	named	wildcards	Specifies the cloud servers on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-CIServer.

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.

Get-Media

This cmdlet retrieves cloud media.