Set-VBOAzureServiceAccount

Short Description

Modifies Microsoft Azure service account settings.

Syntax

This cmdlet provides the following parameter sets:

DefaultParameterSet (Default)

Set-VBOAzureServiceAccount -Account <VBOAzureServiceAccount> [-Description <String>] [<CommonParameters>]
ParameterSetWithCertificate

Set-VBOAzureServiceAccount -Account <VBOAzureServiceAccount> -ApplicationCertificatePath <String>

[-ApplicationCertificatePassword <SecureString>] [-Description <String>] [<CommonParameters>]

ParameterSetConfigureApplication

Set-VBOAzureServiceAccount -Account <VBOAzureServiceAccount> -ApplicationCertificatePath <String>

[-ApplicationCertificatePassword <SecureString>] [-ConfigureApplication] [-Description <String>]

[-SubscriptionIds <String[]>] [<CommonParameters>]

ParameterSetWithSecret

Set-VBOAzureServiceAccount -Account <VBOAzureServiceAccount> -ApplicationSecret <SecureString>

[-Description <String>] [<CommonParameters>]

Detailed Description

This cmdlet modifies settings for the specified Microsoft Azure service account. To modify settings, you need to enter the necessary parameters with new values. The parameters that you omit will remain unchanged.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
Account	Specifies a Microsoft Azure service account whose settings you want to modify. Accepts the `VBOAzureServiceAccount` object. To get this object, run the `Get-VBOAzureServiceAccount` cmdlet.	`VBOAzureServiceAccount`	True	Named	True (ByValue)
ApplicationCertificatePassword	Specifies the certificate password. The cmdlet will use this password to confirm the certificate that you want to import to a Microsoft Entra application.	`SecureString`	False	Named	False
ApplicationCertificatePath	Specifies a path to the folder where the certificate is located. The cmdlet will import the certificate that is located in this path to set up a secure connection to Microsoft 365 organization.	`String`	True	Named	False
ApplicationSecret	Specifies an application secret. The cmdlet will use an application secret to set up a secure connection to Microsoft 365 organization.	`SecureString`	True	Named	False
ConfigureApplication	Defines that the cmdlet will configure settings of an existing Microsoft Entra application: grant the required permissions and register the specified certificate in Microsoft Entra ID. Default: False	`SwitchParameter`	True	Named	False
Description	Specifies a description of Microsoft Azure service account. The cmdlet will replace the current description with the specified description.	`String`	False	Named	False
SubscriptionIds	Specifies an array of subscriptions associated with a user account that was used to sign in to Microsoft Entra.	`String[]`	False	Named	False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About Common Parameters section of Microsoft Learn.

Output Object

The cmdlet returns the VBOAzureServiceAccount object that contains Microsoft Azure service account details.

Examples

Set-VBOAzureServiceAccount Example 1: Modifying Microsoft Entra Application Certificate Path and Password

This example shows how to modify a certificate path and password of a Microsoft Entra application associated with the Microsoft Azure service account.

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

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

$account = Get-VBOAzureServiceAccount -Name "Archiver Appliance App"

Set-VBOAzureServiceAccount -Account $account -ApplicationCertificatePath "C:\certificate\newcert.pfx" -ApplicationCertificatePassword $securepassword

Perform the following steps:

Create a new secure password:
1. 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.
2. Enter the password.
Run the Get-VBOAzureServiceAccount cmdlet. Specify the Name parameter value. Save the result to the $account variable.
Run the Set-VBOAzureServiceAccount cmdlet. Set the $account variable as the Account parameter value. Specify a new value for the ApplicationCertificatePath parameter. Set the $securepassword variable as the ApplicationCertificatePassword parameter value.

Set-VBOAzureServiceAccount Example 2: Modifying Microsoft Entra Application Settings

This example shows how to modify settings of the Microsoft Entra application associated with the Microsoft Azure service account.

$account = Get-VBOAzureServiceAccount -Name "Archiver Appliance App"

Set-VBOAzureServiceAccount -Account $account -ApplicationCertificatePath "C:\certificate\cert.pfx" -ConfigureApplication -SubscriptionIds "06b735ac3d-d883-4dd8-8de3-98f49d743012"

Perform the following steps:

Run the Get-VBOAzureServiceAccount cmdlet. Specify the Name parameter value. Save the result to the $account variable.
Run the Set-VBOAzureServiceAccount cmdlet. Set the $account variable as the Account parameter value. Specify the ApplicationCertificatePath parameter value. Specify a new value for the SubscriptionIds parameter.