Syntax
Get-Media [[-Name] <String[]>] [-Catalog <Catalog[]>] [-Server <CIServer[]>] [-Owner <CIUser[]>] [-InformationAction <ActionPreference>] [-InformationVariable <String>] [-PipelineVariable <String>] [<CommonParameters>]Related Commands
Online versionDetailed 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 objectsNotes
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.