Get-Media
This cmdlet retrieves cloud media. You can filter the returned media by name, ID, catalog, and user.
Syntax
[-Catalog
< Catalog[] > ]
[-Name
< String[] > ]
[-Owner
< CIUser[] > ]
[-ProgressAction
< ActionPreference > ]
[-Server
< CIServer[] > ]
[CommonParameters]
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| optional | Catalog | Catalog[] | named |
|
Specifies the catalogs from which you want to retrieve media devices. |
| optional | Name | String[] | named |
|
Specifies the names of the media devices you want to retrieve. |
| optional | Owner | CIUser[] | named |
|
Specifies the owners of the cloud media you want to retrieve. |
| optional | ProgressAction | ActionPreference | named |
|
|
| optional | Server | CIServer[] | named |
|
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. |
-Id
< String[] >
[-ProgressAction
< ActionPreference > ]
[-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 | ProgressAction | ActionPreference | named |
|
|
| optional | Server | CIServer[] | named |
|
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.MediaExamples
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.