Get-Media Command | Vmware PowerCLI Reference

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[] > ]
[-Server < CIServer[] > ]
[CommonParameters]

Parameters

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 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.
Get-Media
-Id < String[] >
[-Server < CIServer[] > ]
[CommonParameters]

Parameters

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 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.

Output

VMware.VimAutomation.Cloud.Types.V1.Media

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.

Related Commands

Media

This cmdlet retrieves cloud media.