This is an archive version of the document. To get the most up-to-date information, see the current version.

Set-VBRConfigurationBackupJob

On This Page

Short Description
Applies to
Syntax
Return Type
Detailed Description
Parameters
Example 1
Example 2

Short Description

Modifies the configuration backup job.

Applies to

Platform: VMware, Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

Set-VBRConfigurationBackupJob [-Enable] [-Repository <CBackupRepository>] [-ScheduleOptions <VBRConfigurationBackupScheduleOptions>] [-RestorePointsToKeep <int>] [-EnableEncryption] [-EncryptionKey <VBREncryptionKey>] [-PassThru] [<CommonParameters>]

Related Commands

Get-VBRBackupRepository

New-VBRConfigurationBackupScheduleOptions

Get-VBREncryptionKey

Return Type

VBRConfigurationBackupJob

Detailed Description

This cmdlet modifies settings of the configuration backup job. To modify settings, you need to enter the corresponding parameters with new values. The parameters that you omit will remain unchanged.

Parameters

Parameter	Description	Required	Position	Accept Pipeline Input	Accept Wildcard Characters
Enable	If set to TRUE, the job will be enabled. If set to FALSE, you will need to run the job manually. Default: TRUE.	False	Named	False	False
Repository	Specifies the backup repository where you want to store the configuration backups. You cannot use a scale-out backup repository or an extent as target for the configuration backup job. Accepts CBackupRepository object or string type (repository name).	False	Named	False	False
Schedule Options	Specifies the schedule for the configuration backup job. Accepts VBRConfigurationBackupScheduleOptions object.	False	Named	False	False
RestorePoints ToKeep	Specifies the number of restore points you want to keep on disk. Accepts integer type. You can set 1 to 255.	False	Named	False	False
Enable Encryption	If set to TRUE, the configuration backup will be encrypted. Use the EncryptionKey parameter to specify the encryption key. NOTE: if you have created at least one password in the Password Manager on the backup server, you must enable encryption for the configuration backup.	False	Named	False	False
Encryption Key	Used to set the encryption key for the EnableEncryption parameter. Specifies the encryption key you want to use to encrypt the data.	False	Named	False	False
PassThru	Indicates that the command returns the output object to the Windows PowerShell console.	False	Named	False	False

This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.

Example 1

This command disables the configuration backup job.

PS C:\PS> Set-VBRConfigurationBackupJob -Enable:$False

Example 2

This command modifies the configuration backup schedule and enables encryption. The job is set to run at 00:00 every Saturday.

Run New-VBRDailyOptions to create an object with settings for the Daily type. Save the result to the "$daily" variable.
Run New-VBRConfigurationBackupScheduleOptions with the saved variable. Save the result to the "$dailyschedule" variable.

Run Get-VBREncryptionKey to create an object that contains the encryption key. Save it to the "$encryptionkey" variable.

Run Set-VBRConfigurationBackupJob with the saved variables to modify the configuration job settings.

PS C:\PS> $daily = New-VBRDailyOptions -Period "05:00" -DayOfWeek Saturday

PS C:\PS> $dailyschedule = New-VBRConfigurationBackupScheduleOptions -Type Daily -DailyOptions $daily

PS C:\PS> $encryptionkey = Get-VBREncryptionKey -Description "veeam encryption"

PS C:\PS> Set-VBRConfigurationBackupJob -ScheduleOptions $configschedule -EnableEncryption -EncryptionKey $encryptionkey