New-VBREncryptionOptions

Short Description

Defines encryption settings.

Applies to

Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License

Syntax

This cmdlet provides cmdlet sets that allow you to:

New-VBREncryptionOptions [-EnableEncryption] [<CommonParameters>]

New-VBREncryptionOptions [-EnableEncryption] -EncryptionKey <VBREncryptionKey> [<CommonParameters>]

New-VBREncryptionOptions [-EnableEncryption] -KMSServer <VBRKMSServer> -KMSSourceName <String> [<CommonParameters>]

Detailed Description

This cmdlet creates a VBREncryptionOptions object that defines encryption options.

Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input
EncryptionKey	Specifies an encryption key. Veeam Backup & Replication will use this key to encrypt backup files.	Accepts the VBREncryptionKey object. To get this object, run the Get-VBREncryptionKey cmdlet.	False	Named	True (ByPropertyName)
KMSServer	Specifies the KMS server you want to use to encrypt the data.	Accepts the VBRKMSServer object. To get this object, run the Get-VBRKMSServer cmdlet.	False	Named	False
KMSSourceName	Specifies the displayed name for the key. The cmdlet will create a key and include this name into the key name on the KMS server.	String	False	Named	False
EnableEncryption	Enables encryption. Default: False.	SwitchParameter	False	Named	False

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Output Object

The cmdlet returns the VBREncryptionOptions object that defines encryption options.

Examples

New-VBREncryptionOptions Example 1. Create Encryption Options with Encryption Key

This example shows how to define encryption options with the encryption using an encryption key.

$encKey = Get-VBREncryptionKey -Description "For Entra ID encryption"

$encOptions = New-VBREncryptionOptions -EnableEncryption -EncryptionKey $encKey

Perform the following steps:

Run the Get-VBREncryptionKey cmdlet. Specify the Description parameter value. Save the result to the $encKey variable.
Run the New-VBREncryptionOptions cmdlet. Specify the EnableEncryption parameter. Set the $encKey variable as the EncryptionKey parameter value. Save the result to the $encOptions variable.

Related Commands