Get-BEDiskCartridgeDevice Help

Synopsis

Gets disk cartridge devices in Backup Exec.

Syntax

Get-BEDiskCartridgeDevice [[-Name] [<String[]>]] [-Unconfigured [<SwitchParameter>]] [<CommonParameters>]

Get-BEDiskCartridgeDevice -BackupExecServer [<BEBackupExecServer[]>] [[-Name] [<String[]>]] [-Unconfigured [<SwitchParameter>]] [<CommonParameters>]

Get-BEDiskCartridgeDevice -Media [<BEMedia[]>] [[-Name] [<String[]>]] [-Unconfigured [<SwitchParameter>]] [<CommonParameters>]

Get-BEDiskCartridgeDevice [-Id] [<Guid[]>] [-Unconfigured [<SwitchParameter>]] [<CommonParameters>]

Get-BEDiskCartridgeDevice -InputObject [<BEDiskCartridgeDevice[]>] [-Unconfigured [<SwitchParameter>]] [<CommonParameters>]

Description

Gets disk cartridge devices in Backup Exec.

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

By default, Get-BEDiskCartridgeDevice does not return unconfigured disk cartridge devices. Specify the -Unconfigured parameter to get unconfigured disk cartridge devices.

Parameters

-Unconfigured <SwitchParameter>

Returns unconfigured disk cartridge devices.

Required	false
Position	Named
Accepts pipeline input	false
Accepts wildcard characters	false

-BackupExecServer <BEBackupExecServer[]>

Specifies one or more Backup Exec server objects to filter the disk cartridge devices. Enter a variable that contains the objects, or type a command or expression that gets the objects. See Get-BEBackupExecServer.

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

-Media <BEMedia[]>

Specifies one or more Backup Exec media objects to filter the disk cartridge devices. Enter a variable that contains the objects, or type a command or expression that gets the objects. See Get-BEMedia.

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

-Name <String[]>

Specifies one or more disk cartridge devices by disk cartridge device 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 disk cartridge devices by disk cartridge device 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 <BEDiskCartridgeDevice[]>

Specifies one or more disk cartridge device 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.BEBackupExecServer

You can pipe a Backup Exec server object to filter disk cartridge devices returned by Get-BEDiskCartridgeDevice.

BackupExec.Management.CLI.BEMedia

You can pipe a Backup Exec media object to filter disk cartridge devices returned by Get-BEDiskCartridgeDevice.

System.Guid

You can pipe a System.Guid that contains the ID of a Backup Exec disk cartridge device object to Get-BEDiskCartridgeDevice.

BackupExec.Management.CLI.BEDiskCartridgeDevice

You can pipe a Backup Exec disk cartridge device object to Get-BEDiskCartridgeDevice.

Return Value

BackupExec.Management.CLI.BEDiskCartridgeDevice

Get-BEDiskCartridgeDevice returns objects that represent Backup Exec disk cartridge devices.

Examples

Example 1

C:\PS> Get-BEDiskCartridgeDevice

This command gets all of the disk cartridge devices.

Example 2

C:\PS> Get-BEDiskCartridgeDevice -Name "Device 01"

This command gets the disk cartridge device named "Device 01".

Example 3

C:\PS> Get-BEDiskCartridgeDevice -Name "Device*"

This command gets all of the disk cartridge devices that match the wildcard "Device*".

Example 4

C:\PS> Get-BEBackupExecServer -Local | Get-BEDiskCartridgeDevice

This command gets all of the disk cartridge devices attached to the local Backup Exec server.