Backup Exec Management Command Line Interface Help
Get-BEDiskCartridgeDevice Cmdlet
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


<CommonParameters>

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.

Related Links

Get-BEBackupExecServer
Get-BEMedia