Get-DPMTape

Get-DPMTape

Returns tapes in the library.

Syntax

Parameter Set: Library
Get-DPMTape [-DPMLibrary] <Library[]> [ <CommonParameters>]

Parameter Set: ProtectionGroup
Get-DPMTape [-ProtectionGroup] <ProtectionGroup[]> [ <CommonParameters>]

Parameter Set: RecoverySourceLocation
Get-DPMTape [-RecoveryPointLocation] <RecoverySourceLocation[]> [ <CommonParameters>]

Detailed Description

The Get-DPMTape cmdlet returns tapes in the library. In System Center 2012 – Data Protection Manager (DPM), a library refers to multi-drive tape hardware and stand-alone tape drives.

Parameters

-DPMLibrary<Library[]>

Specifies an array of DPM library objects that this cmdlet gets. The library objects can be multi-drive tape hardware or stand-alone tape drives.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-ProtectionGroup<ProtectionGroup[]>

Specifies an array of protection groups for which this cmdlet gets tapes. To obtain a ProtectionGroup object, use the Get-DPMProtectionGroup cmdlet. A protection group consists of data sources, such as volumes or shares, that have a common protection configuration and schedule.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-RecoveryPointLocation<RecoverySourceLocation[]>

Specifies an array of recovery point locations for which this cmdlet gets tapes. To obtain a recovery point location object, use the Get-DPMRecoveryPointLocation cmdlet. A recovery point is a copy of a replica stored on a DPM server. You can specify multiple locations for recovery items that exist on a disk and a tape, or on multiple tapes.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (http://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.

  • Tape

Examples

Example 1: Retrieve a list of tapes for a library

The first command uses the Get-DPMLibrary cmdlet to get the library for the server, and then stores it in the $DpmLibrary variable.

The second command uses the Get-DPMTape cmdlet to return the list of tapes on Contoso-DPMServer.

PS C:\> $DpmLibrary = Get-DPMLibrary -DPMServerName "Contoso-DPMServer"
PS C:\> Get-DPMTape -DPMLibrary $DpmLibrary

Add-DPMTape

Get-DPMLibrary

Remove-DPMTape

Set-DPMTape