Set-DPMTapeBackupOption

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

Syntax

Set-DPMTapeBackupOption [-ProtectionGroup] <ProtectionGroup> -BackupLibrary <Library> -DrivesAllocated <Int32>
 [-PassThru] [-PGSet <PGSet>] [-RemovePGSet] [-TapeCopyLibrary <Library>] [-Confirm] [-WhatIf]
 [<CommonParameters>]
Set-DPMTapeBackupOption [-ProtectionGroup] <ProtectionGroup> [-CompressData] [-EncryptData] [-PassThru]
 [-PerformIntegritycheck] [-PGSet <PGSet>] [-RemovePGSet] [-ShortTerm] [-Confirm] [-WhatIf]
 [<CommonParameters>]
Set-DPMTapeBackupOption [-ProtectionGroup] <ProtectionGroup> [-CompressData] [-EncryptData] [-LongTerm]
 [-PassThru] [-PerformIntegritycheck] [-PGSet <PGSet>] [-RemovePGSet] [-Confirm] [-WhatIf] [<CommonParameters>]

Description

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

Examples

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

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

The first command uses the Get-ProtectionGroup cmdlet to get a protection group for Contoso-DPMServer. The command stores the group in the $PGroup variable.

The second command specifies values for the ShortTerm and Encryption parameters. This example sets the tape backup options to short-term backup with encryption.

Example 2: Set tape backup options for a protection group

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

The first command uses the Get-ProtectionGroup cmdlet to get a protection group for Contoso-DPMServer. The command stores the group in the $PGroup variable.

The second command uses the Get-ModifiableProtectionGroup cmdlet to retrieve the settings for the first protection group. The command stores the group in editable mode in the $MPGroup variable.

The third command uses the Get-DPMLibrary cmdlet to get the library for Contoso-DMPServer. The command stores it in the $DpmLibrary variable.

The fourth command specifies values for the BackupLibrary and DrivesAllocated parameters. This example sets the tape backup option for the protection group.

The fifth command uses the Set-ProtectionGroup cmdlet to save your changes to the value in $MPGroup.

Parameters

-BackupLibrary

Specifies a backup library.

Type:Library
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CompressData

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

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DrivesAllocated

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

Type:Int32
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EncryptData

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

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-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.

Type:SwitchParameter
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PassThru

Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PerformIntegritycheck

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

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PGSet

Specifies the protection group set for which this cmdlet modifies options. To obtain a protection group set object, use the Get-DPMPGSet cmdlet.

Type:PGSet
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ProtectionGroup

Specifies a protection group for which this cmdlet modifies options. To obtain a ProtectionGroup object, use the Get-DPMProtectionGroup cmdlet.

Type:ProtectionGroup
Required:True
Position:1
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-RemovePGSet

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

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-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.

Type:SwitchParameter
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-TapeCopyLibrary

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

Type:Library
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
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.

Type:SwitchParameter
Aliases:wi
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Outputs

ProtectionGroup