Disable-DPMTapeDrive

Disable-DPMTapeDrive

Disables a tape drive in the DPM library.

Syntax

Parameter Set: Default
Disable-DPMTapeDrive [-TapeDrive] <Drive[]> [-PassThru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The Disable-DPMTapeDrive cmdlet disables a tape drive in the System Center 2012 – Data Protection Manager (DPM) library.

Parameters

-PassThru

Indicates that the cmdlet is part of a pipeline. Use this parameter with DPM commands to return a related object in cases where there is no default output.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-TapeDrive<Drive[]>

Specifies an array of tape drives.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before running the cmdlet.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Notes

  • For more information, type "Get-Help Disable-DPMTapeDrive -detailed".

Examples

Example 1: Disable a tape drive in a library

This example disables a tape drive on the server Contoso-DPMServer.

The first command uses the Get-DPMLibrary cmdlet to retrieve the library, and stores the result in the $DPMLib variable.

The second command uses the Get-Tape cmdlet to retrieve a list of the tapes in the library, and stores the result in the $TapeDrive variable.

The third command uses the Enable-DPMTapeDrive cmdlet to disable the tape drive.

PS C:\> $DPMLib = Get-DPMLibrary -DPMServerName "Contoso-DPMServer"
PS C:\> $TapeDrive = Get-TapeDrive -DPMLibrary $DPMLib
PS C:\> Disable-DPMTapeDrive -TapeDrive $TapeDrive

Enable-DPMTapeDrive

Get-DPMLibrary

Get-DPMTapeDrive