Get-BEMedia Help

Synopsis

Gets media in Backup Exec.

Syntax

Get-BEMedia [[-Name] [<String[]>]] [<CommonParameters>]

Get-BEMedia -MediaSet [<BEMediaSet[]>] [[-Name] [<String[]>]] [<CommonParameters>]

Get-BEMedia -MediaVault [<BEMediaVault[]>] [[-Name] [<String[]>]] [<CommonParameters>]

Get-BEMedia [-Id] [<Guid[]>] [<CommonParameters>]

Get-BEMedia -InputObject [<BEMedia[]>] [<CommonParameters>]

Description

Gets media in Backup Exec.

Without parameters, Get-BEMedia gets all of the Backup Exec media. You can also specify a media by media name or media ID (Guid) or pass a Backup Exec media object through the pipeline to Get-BEMedia.

Parameters

-MediaSet <BEMediaSet[]>

Specifies one or more media set objects to filter the media. Enter a variable that contains the objects, or type a command or expression that gets the objects. See Get-BEMediaSet.

Required	true
Position	Named
Accepts pipeline input	true (ByValue)
Accepts wildcard characters	false

-MediaVault <BEMediaVault[]>

Specifies one or more media vault objects to filter the media. Enter a variable that contains the objects, or type a command or expression that gets the objects. See Get-BEMediaVault.

Required	true
Position	Named
Accepts pipeline input	true (ByValue)
Accepts wildcard characters	false

-Name <String[]>

Specifies one or more media by media name (wildcards accepted). To specify multiple names, use commas to separate the names.

Required	false
Position	0
Accepts pipeline input	false
Accepts wildcard characters	true

-Id <Guid[]>

Specifies one or more media by media ID (Guid). To specify multiple IDs, use commas to separate the IDs.

Required	true
Position	0
Accepts pipeline input	true (ByValue)
Accepts wildcard characters	false

-InputObject <BEMedia[]>

Specifies one or more media objects. Enter a variable that contains the objects, or type a command or expression that gets the objects.

Required	true
Position	Named
Accepts pipeline input	true (ByValue)
Accepts wildcard characters	false

For more information about common parameters, type "Get-Help about_commonparameters".

Input Types

BackupExec.Management.CLI.BEMediaSet

You can pipe a Backup Exec media set object to filter media returned by Get-BEMedia.

BackupExec.Management.CLI.BEMediaVault

You can pipe a Backup Exec media vault object to filter media returned by Get-BEMedia.

System.Guid

You can pipe a System.Guid that contains the ID of a Backup Exec media object to Get-BEMedia.

BackupExec.Management.CLI.BEMedia

You can pipe a Backup Exec media object to Get-BEMedia.

Return Value

BackupExec.Management.CLI.BEMedia

Get-BEMedia returns objects that represent Backup Exec media.

Examples

Example 1

C:\PS> Get-BEMedia

This command gets all of the media.

Example 2

C:\PS> Get-BEMedia -Name "Media 01"

This command gets the media named "Media 01".

Example 3

C:\PS> Get-BEMedia -Name "*media*"

This command gets all of the media that match the wildcard "*media*".

Example 4

C:\PS> Get-BEMediaSet -Name "MediaSet 01" | Get-BEMedia

These commands get all of the media associated with the media set named "MediaSet 01".

Example 5

C:\PS> Get-BEMediaVault -Name "MediaVault 01" | Get-BEMedia

These commands get all of the media associated with the media vault named "MediaVault 01".