Set-VBOAzureServiceAccount

Short Description

Modifies Microsoft Azure service account settings.

Syntax

This cmdlet provides parameter sets that allow you to:

Change the Microsoft Azure service account description.

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

Change the Microsoft Azure service account settings when using the application certificate.

Set-VBOAzureServiceAccount -Account <VBOAzureServiceAccount> -ApplicationCertificatePath <String> [-ApplicationCertificatePassword <SecureString>] [-Description <String>] [<CommonParameters>]

Change the Microsoft Azure service account settings when using the application secret.

Set-VBOAzureServiceAccount -Account <VBOAzureServiceAccount> -ApplicationSecret <SecureString> [-Description <String>] [<CommonParameters>]

Change the Azure AD application settings.

Set-VBOAzureServiceAccount -Account <VBOAzureServiceAccount> -ApplicationCertificatePath <String> -ConfigureApplication [-ApplicationCertificatePassword <SecureString>] [-Description <String>] [-SubscriptionIds <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

Parameter	Description	Type	Required	Position	Accept Pipeline Input	Accept Wildcard Characters
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.	True	Named	True (ByValue)	False
ApplicationCertificatePassword	Specifies the certificate password. The cmdlet will use this password to confirm the certificate that you want to import to an Azure AD application.	SecureString	False	Named	False	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	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	False
ConfigureApplication	Defines that the cmdlet will configure settings of an existing Azure AD application: grant the required permissions and register the specified certificate in Azure Active Directory.	SwitchParameter	True	Named	False	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	False
SubscriptionIds	Specifies an array of subscriptions associated with a user account that was used to sign in to Microsoft Azure.	String[]	False	Named	False	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 VBOAzureServiceAccount object that contains Microsoft Azure service account details.

Examples

Set-VBOAzureServiceAccount Example 1. Modifying Azure AD Application Certificate Path and Password

This example shows how to modify a certificate path and password of an Azure AD 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:

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-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 Azure AD Application Settings

This example shows how to modify settings of the Azure AD 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.

Related Commands