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

Set-VBREncryptedBackupPassword

Short Description

Decrypts imported encrypted backups.

Applies to

Platform: VMware, Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

Set-VBREncryptedBackupPassword -Backup <VBRImportedEncryptedBackup> -Password <string[]> [<CommonParameters>]

Detailed Description

This cmdlet decrypts a selected imported encrypted backup. After you decrypt an imported encrypted backup, you can use such backups for restore. The decrypted backups will be available in the array of backups returned by Get-VBRBackup.

To decrypt an imported encrypted backup,you will need to specify the password or passwords you used to encrypt the backups. If you changed the password one or several times while the backup chain was created, you must enter passwords in the following manner:

  • If you decrypt a VBM file, you must specify the latest password that was used to encrypt files in the backup chain.
  • If you decrypt a VBK file, you must specify the whole set of passwords that were used to encrypt files in the backup chain.

You can use hints to recall the passwords you used to encrypt the backups. Run Get-VBRImportedEncryptedBackupHint to get the hints for the needed backup.

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

Backup

Specifies the imported encrypted backup you want to decrypt.

True

Named

False

False

Password

Specifies the password required for decrypting the backup.

True

Named

False

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

Example

The example shows how to decrypt an imported encrypted backup.

  1. Run Get-VBRImportedEncryptedBackup to get the imported encrypted backup. Save the result to the $encryptedbackup variable.
  2. Run Get-VBRImportedEncryptedBackupHint to get the password hints. Use the $encryptedbackup variable.
  3. Run Set-VBREncryptedBackupPassword. Use the $encryptedbackup variable and the hints to recall the passwords.

$encryptedbackup = Get-VBRImportedEncryptedBackup -Name "Atlanta SQL Server Backup"

Get-VBRImportedEncryptedBackupHint -Backup $encryptedbackup

Set-VBREncryptedBackupPassword -Backup $encryptedbackup -Password "123", "345"

Related Commands

Get-VBRImportedEncryptedBackup