Remove-BETapeDriveDevice Help

Synopsis

Removes tape drive devices from Backup Exec.

Syntax

Remove-BETapeDriveDevice -InputObject [<BETapeDriveDevice[]>] [-PassThru [<SwitchParameter>]] [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]

Description

Removes tape drive devices from Backup Exec.

Parameters

-PassThru <SwitchParameter>

Passes the removed object to the pipeline. By default, this cmdlet does not generate any output.

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

-InputObject <BETapeDriveDevice[]>

Specifies one or more tape drive 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

-WhatIf <SwitchParameter>

Describes what happens if you execute the command without actually executing the command.

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

-Confirm <SwitchParameter>

Prompts you for confirmation before executing the command.

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

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

Input Type

BackupExec.Management.CLI.BETapeDriveDevice

You can pipe a Backup Exec tape drive device object to Remove-BETapeDriveDevice.

Return Value

None or BackupExec.Management.CLI.BETapeDriveDevice

When you use the PassThru parameter, Remove-BETapeDriveDevice returns an object that represents the tape drive device that was removed. Otherwise, this cmdlet does not generate any output.

Example

C:\PS> Get-BETapeDriveDevice "Device 0001" | Remove-BETapeDriveDevice

These commands remove a tape drive device named "Device 0001".