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[]>]
[-Server <CIServer[]>]
[CommonParameters]
[-Name <String[]>]
[-Owner <CIUser[]>]
[-Server <CIServer[]>]
[CommonParameters]
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| optional |
|
Catalog[] | named |
|
Specifies the catalogs from which you want to retrieve media devices. | optional |
|
String[] | named |
|
Specifies the names of the media devices you want to retrieve. | optional |
|
CIUser[] | named |
|
Specifies the owners of the cloud media you want to retrieve. | optional |
|
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. |
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| required |
|
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 |
|
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.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.
