Set-DPMTapeBackupOption

Set-DPMTapeBackupOption

Modifies the tape backup and library options for a DPM protection group.

Syntax

Parameter Set: LibraryOptions
Set-DPMTapeBackupOption [-ProtectionGroup] <ProtectionGroup> -BackupLibrary <Library> -DrivesAllocated <Int32> [-PassThru] [-PGSet <PGSet> ] [-RemovePGSet] [-TapeCopyLibrary <Library> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: LongTerm
Set-DPMTapeBackupOption [-ProtectionGroup] <ProtectionGroup> -LongTerm [-CompressData] [-EncryptData] [-PassThru] [-PerformIntegritycheck] [-PGSet <PGSet> ] [-RemovePGSet] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: ShortTerm
Set-DPMTapeBackupOption [-ProtectionGroup] <ProtectionGroup> -ShortTerm [-CompressData] [-EncryptData] [-PassThru] [-PerformIntegritycheck] [-PGSet <PGSet> ] [-RemovePGSet] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The Set-DPMTapeBackupOption cmdlet modifies the tape backup options, such as library and drive information, and short-term and long-term tape backup options for a System Center 2012 – Data Protection Manager (DPM) protection group.

Parameters

-BackupLibrary<Library>

Specifies a backup library.

-CompressData

Indicates that the backup process compresses the data to reduce storage needs. Do not use compression and encryption together.

-DrivesAllocated<Int32>

Specifies the number of drives to allocate to the protection group.

-EncryptData

Indicates that the backup process encrypts the data during backup. Do not use compression and encryption together.

-LongTerm

Indicates that the protection group uses long-term tape protection. Do not use this parameter with the ShortTerm parameter. You must set LongTerm and ShortTerm options in separate commands.

-PassThru

Indicates that the cmdlet is part of a pipeline.

-PerformIntegritycheck

Indicates that the backup process performs an integrity check on the tape backup.

-PGSet<PGSet>

Specifies the name of a protection group set.

-ProtectionGroup<ProtectionGroup>

Specifies the name of a protection group.

-RemovePGSet

Indicates that the cmdlet removes the protection group set as an option.

-ShortTerm

Indicates that the protection group will be on disk, on tape, or on neither, if nothing is specified. Do not use this parameter with the LongTerm parameter. You must set LongTerm and ShortTerm options in separate commands.

-TapeCopyLibrary<Library>

Specifies a library object. Use the secondary tape library to make copies of the tape in the backup library.

-Confirm

Prompts you for confirmation before running the cmdlet.

-WhatIf

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

<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.

• ProtectionGroup

Notes

• For more information, type "Get-Help Set-DPMTapeBackupOption -detailed".

Examples

Example 1: Set tape backup options for short-term backup

This example sets the tape backup options to short-term backup with encryption.

The first command uses the Get-ProtectionGroup cmdlet and stores the result in the variable named $PGroup.

The second command uses the Set-DPMTapeBackupOption cmdlet to set the ShortTerm and Encryption parameters.

PS C:\> $PGroup = Get-ProtectionGroup -DPMServerName "Contoso-DPMServer"
PS C:\> Set-DPMTapeBackupOption -ProtectionGroup $PGroup -ShortTerm -EncryptData

Example 2: Set tape backup options for a protection group

This example sets the tape backup option for the protection group in the variable named $MPGroup.

The first command uses the Get-ProtectionGroup cmdlet and stores the result in the variable named $PGroup.

The second command uses the Get-ModifiableProtectionGroup cmdlet to retrieve the settings for the first protection group, and stores the result in the variable named $MPGroup.

The third command uses the Get-DPMLibrary cmdlet and stores the result in the variable named $Lib.

The fourth command uses the Set-DPMTapeBackupOption cmdlet to set the BackupLibrary and DrivesAllocated parameters.

The fifth command uses the Set-ProtectionGroup cmdlet to set the protection group to the value in the $MPGroup variable.

PS C:\> $PGroup = Get-ProtectionGroup "Contoso-DPMServer"
PS C:\> $MPGroup = Get-ModifiableProtectionGroup -ProtectionGroup $PGroup[0]
PS C:\> $Lib = Get-DPMLibrary "Contoso-DPMServer"
PS C:\> Set-DPMTapeBackupOption -ProtectionGroup $MPGroup -BackupLibrary $Lib -DrivesAllocated 1
PS C:\> Set-ProtectionGroup $MPGroup

Related topics

Get-DPMTapeBackupOption