New-VBOOffice365ApplicationOnlyConnectionSettings

Short Description

Defines Microsoft Entra application settings.

Syntax

This cmdlet provides parameter sets that allow you to:

Define Microsoft Entra application settings with a user name of a Microsoft Exchange user.

New-VBOOffice365ApplicationOnlyConnectionSettings -ImpersonationAccountName <String> -ApplicationId <Guid> -ApplicationCertificatePath <String> [-ApplicationCertificatePassword <SecureString>] [-SharePointSaveAllWebParts] [<CommonParameters>]

Define Microsoft Entra application settings using Microsoft 365 organization name.

New-VBOOffice365ApplicationOnlyConnectionSettings -OfficeOrganizationName <String> -ApplicationId <Guid> -ApplicationCertificatePath <String> [-ApplicationCertificatePassword <SecureString>] [-SharePointSaveAllWebParts] [<CommonParameters>]

Define new Microsoft Entra application settings using application ID and a new application certificate path.

New-VBOOffice365ApplicationOnlyConnectionSettings [-ApplicationId <Guid>] -ApplicationCertificatePath <String> [-ApplicationCertificatePassword <SecureString>] [-ConfigureApplication] [-SharePointSaveAllWebParts] [<CommonParameters>]

Define new Microsoft Entra application settings using a new certificate path.

New-VBOOffice365ApplicationOnlyConnectionSettings -ApplicationCertificatePath <String> [-ApplicationCertificatePassword <SecureString>] [-NewApplicationName <String>] [-SharePointSaveAllWebParts] [<CommonParameters>]

Detailed Description

This cmdlet creates the VBOApplicationOnlyConnectionSettings object. This object defines Microsoft Entra application settings that allow you to use modern app-only authentication when you add Microsoft organizations to the Veeam Backup for Microsoft 365 infrastructure. Depending on your setup you can define Microsoft Entra application settings using the following options:

Define Microsoft Entra application settings without authentication code. Use this option to define a Microsoft Entra application without using an authentication code. For authentication to a Microsoft 365 server, you must provide a Microsoft Exchange user name. The cmdlet will not configure Microsoft Entra application settings.
Define Microsoft Entra application settings using Microsoft 365 organization name. Use this option to define a Microsoft Entra application that you will use to back up only Microsoft SharePoint Online and Microsoft OneDrive for Business services. For authentication to Microsoft 365 server, you must provide a Microsoft 365 organization name. The cmdlet will not configure Microsoft Entra application settings.
Define new Microsoft Entra application settings using application ID and a new application certificate path. Use this option to register new Microsoft Entra application settings.
Define new Microsoft Entra application settings using a certificate. Use this option to configure Microsoft Entra application without specifying the application ID settings.

Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input
ImpersonationAccountName	Specifies a user name of a Microsoft Exchange user. The cmdlet will use this user name to authenticate to the Microsoft Exchange server.	String	True	Named	False
ApplicationId	Specifies a Microsoft Entra application ID. The cmdlet will use this application ID to set up a secure connection to a Microsoft organization.	Guid	True	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 an encrypted connection to a Microsoft organization.	String	True	Named	False
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
SharePointSaveAllWebParts	Defines that the cmdlet will add SharePoint Web Parts to Microsoft Entra application settings. Default: False	SwitchParameter	False	Named	False
OfficeOrganizationName	Specifies a name of Microsoft organization. The cmdlet will use this name to authenticate to the Microsoft 365 server.	String	True	Named	False
ConfigureApplication	Defines that the cmdlet will configure settings of an existing Microsoft Entra application. Default: False	SwitchParameter	False	Named	False
NewApplicationName	Specifies a name of a new Microsoft Entra application. The cmdlet will define settings of the Microsoft Entra application with this name.	String	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 VBOApplicationOnlyConnectionSettings object that defines Microsoft Entra application settings.

Examples

New-VBOOffice365ApplicationOnlyConnectionSettings Example 1. Defining Microsoft Entra Application Settings with User Name of Microsoft Exchange User

This example shows how to define Microsoft Entra application settings using the Office365Admin@tech-365.tech user name to authenticate to the Microsoft 365 server.

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

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

New-VBOOffice365ApplicationOnlyConnectionSettings -ApplicationCertificatePath "C:\certificate\cert.pfx" -ApplicationCertificatePassword $securepassword -ApplicationId 6c957a12-93fd-469a-86f6-1dc3cc81cf07 -ImpersonationAccountName Office365Admin@tech-365.tech

Perform the following steps:

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 New-VBOOffice365ApplicationOnlyConnectionSettings cmdlet. Specify the following settings:

Specify the ApplicationCertificatePath parameter value.
Set the $securepassword variable as the ApplicationCertificatePassword parameter value.
Specify the ApplicationId parameter value.
Specify the ImpersonationAccountName parameter value.

New-VBOOffice365ApplicationOnlyConnectionSettings Example 2. Defining Microsoft Entra Application Settings Using Microsoft 365 Organization Name

This example shows how to define Microsoft Entra application settings. The cmdlet will use the @tech-365.tech name to authenticate to the Microsoft 365 server. The cmdlet will not configure Microsoft Entra application settings.

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

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

New-VBOOffice365ApplicationOnlyConnectionSettings -OfficeOrganizationName @tech-365.tech -ApplicationId 22b5dd21-5ccf-4696-8482-eda0a1c7d32b -ApplicationCertificatePath "C:\certificate\cert.pfx" -ApplicationCertificatePassword $securepassword

Perform the following steps:

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 New-VBOOffice365ApplicationOnlyConnectionSettings cmdlet. Specify the following settings:

Specify the OfficeOrganizationName parameter value.
Specify the ApplicationId parameter value.
Specify the ApplicationCertificatePath parameter value.
Set the $securepassword variable as the ApplicationCertificatePassword parameter value.

To set up a secure connection to a Microsoft organization, open the https://microsoft.com/devicelogin link in your browser and enter the code that you get in the PowerShell Console to authenticate to the Microsoft 365 server.

New-VBOOffice365ApplicationOnlyConnectionSettings Example 3. Defining New Microsoft Entra Application Settings

This example shows how to define new Microsoft Entra application settings. The cmdlet will add this application to Microsoft Entra ID.

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

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

New-VBOOffice365ApplicationOnlyConnectionSettings -ApplicationId f5df82a6-e9ea-4430-ae9b-9b3373f405c6 -ApplicationCertificatePath "C:\certificate\cert.pfx" -ApplicationCertificatePassword $securepassword

Perform the following steps:

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 New-VBOOffice365ApplicationOnlyConnectionSettings cmdlet. Specify the following settings:

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

New-VBOOffice365ApplicationOnlyConnectionSettings Example 4. Defining Settings of Existing Microsoft Entra Application

This example shows how to define settings of an existing Microsoft Entra application.

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

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

New-VBOOffice365ApplicationOnlyConnectionSettings -ApplicationId a22f2e50-0e00-4f24-b09d-ccd161e136bf -ApplicationCertificatePath "C:\certificate\cert.pfx" -ApplicationCertificatePassword $securepassword -ConfigureApplication

Perform the following steps:

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 New-VBOOffice365ApplicationOnlyConnectionSettings cmdlet. Specify the following settings:

Specify the ApplicationCertificatePath parameter value.
Set the $securepassword variable as the ApplicationCertificatePassword parameter value.
Specify the ApplicationId parameter value.
Provide the ConfigureApplication parameter.

New-VBOOffice365ApplicationOnlyConnectionSettings Example 5. Defining Microsoft Entra Application Using Certificate

This example shows how to define settings of a Microsoft Entra application using the certificate with the following settings:

The cmdlet will use the certificate that is located at the C:\certificate\cert.pfx file path.
The cmdlet will assign the Application05 name to the application.

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

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

New-VBOOffice365ApplicationOnlyConnectionSettings -ApplicationCertificatePath "C:\certificate\cert.pfx" -ApplicationCertificatePassword $securepassword -NewApplicationName "Application05"

Perform the following steps:

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 New-VBOOffice365ApplicationOnlyConnectionSettings cmdlet. Specify the following settings:

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

Related Commands

Read-Host