This topic has not yet been rated - Rate this topic

Set-DPMTapeBackupOption

Updated: January 14, 2013

Applies To: System Center 2012 - Data Protection Manager

Set-DPMTapeBackupOption

Sets the tape backup and library options for a 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 sets the tape backup options like library and drive information, and short-term and long-term tape backup options.

The parameters CompressData and EncryptData cannot be run together. To remove data compression and encryption, run the cmdlet with neither parameter.

Long-term and short-term setting cannot be made at the same time. Run the cmdlet individually for each set of settings.

Parameters

-BackupLibrary<Library>

Specify the library used for backup.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-CompressData

Indicates that on-wire compression of data must be enabled while archiving.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-DrivesAllocated<Int32>

Specify the number of drives allocated to be used in protection.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-EncryptData

Indicates whether the data should be encrypted during backup.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-LongTerm

Indicates that the protection group is set to long-term tape protection.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-PassThru

Use the PassThru parameter to allow cmdlets to be part of a pipeline. The -PassThru parameter can be used with many commands in DPM to return a related object in cases where there is no default output. Using the PassThru parameter allows such cmdlets to be part of a pipeline.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-PerformIntegritycheck

Indicates that an integrity check must be performed on the tape.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-PGSet<PGSet>

Provide the PG set object.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ProtectionGroup<ProtectionGroup>

The name of a protection group.

Aliases	none
Required?	true
Position?	1
Default Value	none
Accept Pipeline Input?	True (ByValue)
Accept Wildcard Characters?	false

-RemovePGSet

Indicates that the specified PG set should be removed.

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

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-TapeCopyLibrary<Library>

Specify a library object. The secondary tape library is used while making copies of the tape in the backup library.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Confirm

Prompts you for confirmation before executing the command.

Required?	false
Position?	named
Default Value	false
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-WhatIf

Describes what would happen if you executed the command without actually executing the command.

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.

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

For technical information, type "Get-Help Set-DPMTapeBackupOption -full".

Examples

EXAMPLE 1

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

PowerShell

PS C:\>$pg = Get-ProtectionGroup -DPMServerName TestingServerSet-DPMTapeBackupOption -ProtectionGroup $pg -ShortTerm -EncryptData

EXAMPLE 2

PowerShell

PS C:\>$pg = Get-ProtectionGroup TestingServer$mpg = Get-ModifiableProtectionGroup -ProtectionGroup $pg[0]$Lib = Get-DPMLibrary TestingServerSet-DPMTapeBackupOption -ProtectionGroup $mpg -BackupLibrary $Lib -DrivesAllocated 1Set-ProtectionGroup $mpg

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)