Set-VBOBackupApplication

Short Description

Modifies backup application settings that are added to Microsoft organizations.

Syntax

Set-VBOBackupApplication -BackupApplication <VBOBackupApplication> -ApplicationCertificatePath <string> [-ApplicationCertificatePassword <securestring>] [<CommonParameters>]

Detailed Description

This cmdlet modifies backup application settings that are added to Microsoft organizations. The backup application represents settings of an Azure AD application. To modify settings, you need to enter the necessary parameters with new values. The parameters that you omit will remain unchanged.

Set-VBOBackupApplication Important

This cmdlet is available only in Veeam Backup for Microsoft 365 version 4c or later.
This cmdlet will run only for Microsoft organizations that are added to the Veeam Backup for Microsoft 365 infrastructure using modern app-only authentication method.

Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input	Accept Wildcard Characters
BackupApplication	Specifies a backup application whose settings you want to modify.	Accepts the VBOBackupApplication object. To get this object, run the Get-VBOBackupApplication cmdlet.	True	Named	False	False
ApplicationCertificatePath	Specifies a path to the folder where the certificate is located. The cmdlet will modify the path to the certificate in the backup application settings.	String	True	Named	False	False
ApplicationCertificatePassword	Specifies the certificate password. The cmdlet will modify the password in the backup application settings.	SecureString	False	Named	False	False

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Accept Wildcard Characters

BackupApplication

Specifies a backup application whose settings you want to modify.

Accepts the VBOBackupApplication object.

To get this object, run the Get-VBOBackupApplication cmdlet.

True

Named

False

ApplicationCertificatePath

Specifies a path to the folder where the certificate is located. The cmdlet will modify the path to the certificate in the backup application settings.

String

True

Named

False

ApplicationCertificatePassword

Specifies the certificate password. The cmdlet will modify the password in the backup application settings.

SecureString

False

Named

False

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

Output Object

The cmdlet returns the VBOBackupApplication object that contains backup application settings that are added to Microsoft organizations.

Examples

Set-VBOBackupApplication Example 1. Modifying Backup Application Certificate Path and Password

This example shows how to modify the path to the folder where the certificate is located. The cmdlet will change it to the C:\NewCertificate\cert.pfx value.

$securepassword = Read-Host "Enter your password" -AsSecureString

Enter your password: **********

$app = Get-VBOBackupApplication

Set-VBOBackupApplication -BackupApplication $app -ApplicationCertificatePath "C:\NewCertificate\cert.pfx" -ApplicationCertificatePassword $securepassword

Perform the following steps:

Specify the secure password.

Run the Read-Host cmdlet. Specify the message that the console will display as a prompt. Provide the AsSecureString parameter. Save the result to the $securepassword variable.
Enter the password.

Run the Get-VBOBackupApplication cmdlet. Save the result to the $app variable.
Run the Set-VBOBackupApplication cmdlet. Specify the following settings:

Set the $app variable as the BackupApplication parameter value.
Specify the ApplicationCertificatePath parameter value.
Set the $securepassword variable as the ApplicationCertificatePassword parameter value.

Related Commands