---
title: "New-VBOOffice365ApplicationOnlyConnectionSettings"
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..."
canonical: "https://helpcenter.veeam.com/docs/vbo365/powershell/new-vbooffice365applicationonlyconnectionsettings.html"
breadcrumb: "PowerShell Reference > Veeam Backup for Microsoft 365 PowerShell Reference > Organizations Management > Organization Connection Settings > New-VBOOffice365ApplicationOnlyConnectionSettings"
dateModified: "2026-08-21"
---

# New-VBOOffice365ApplicationOnlyConnectionSettings

## Short Description
Defines Microsoft Entra application settings.

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>AccountNameParameterSet</code></p>

```
New-VBOOffice365ApplicationOnlyConnectionSettings -ImpersonationAccountName <String> -ApplicationId <Guid>
 -ApplicationCertificatePath <String> [-ApplicationCertificatePassword <SecureString>]
 [-SharePointSaveAllWebParts] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>OfficeNameParameterSet</code></p>

```
New-VBOOffice365ApplicationOnlyConnectionSettings -OfficeOrganizationName <String> -ApplicationId <Guid>
 -ApplicationCertificatePath <String> [-ApplicationCertificatePassword <SecureString>]
 [-SharePointSaveAllWebParts] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>ModifyApplicationParameterSet</code></p>

```
New-VBOOffice365ApplicationOnlyConnectionSettings [-ApplicationId <Guid>] -ApplicationCertificatePath <String>
 [-ApplicationCertificatePassword <SecureString>] [-ConfigureApplication] [-SharePointSaveAllWebParts] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>RegisterApplicationParameterSet</code></p>

```
New-VBOOffice365ApplicationOnlyConnectionSettings -ApplicationCertificatePath <String>
 [-ApplicationCertificatePassword <SecureString>] [-NewApplicationName <String>] [-SharePointSaveAllWebParts] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet creates the [`VBOApplicationOnlyConnectionSettings`](vboapplicationonlyconnectionsettings.md) 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 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

<table style="width:100%;" class="Blue_Table">
      <tr style="vertical-align:top">
        <th style="width:20%;">
          <p>Parameter</p>
        </th>
        <th style="width:20%;">
          <p>Description</p>
        </th>
        <th style="width:20%;">
          <p>Type</p>
        </th>
        <th style="width:10%;">
          <p>Required</p>
        </th>
        <th style="width:10%;">
          <p>Position</p>
        </th>
        <th style="width:10%;">
          <p>Accept Pipeline Input</p>
        </th>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">ApplicationCertificatePassword</span></p>
        </td>
        <td>
          <p>Specifies the certificate password. The cmdlet will use this password to confirm the certificate that you want to import to a Microsoft Entra application.</p>
        </td>
        <td style="width:10%;">
          <p><code>SecureString</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">ApplicationCertificatePath</span></p>
        </td>
        <td>
          <p>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.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">ApplicationId</span></p>
        </td>
        <td>
          <p>Specifies a Microsoft Entra application ID. The cmdlet will use this application ID to set up a secure connection to a Microsoft organization.</p>
        </td>
        <td style="width:10%;">
          <p><code>Guid</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">ConfigureApplication</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will configure settings of an existing Microsoft Entra application.</p><p>Default: <em>False</em></p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">ImpersonationAccountName</span></p>
        </td>
        <td>
          <p>Specifies a user name of a Microsoft Exchange user. The cmdlet will use this user name to authenticate to the Microsoft Exchange server.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">NewApplicationName</span></p>
        </td>
        <td>
          <p>Specifies a name of a new Microsoft Entra application. The cmdlet will define settings of the Microsoft Entra application with this name.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">OfficeOrganizationName</span></p>
        </td>
        <td>
          <p>Specifies a name of Microsoft organization. The cmdlet will use this name to authenticate to the Microsoft 365 server.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">SharePointSaveAllWebParts</span></p>
        </td>
        <td>
          <p><strong>Note</strong>: This parameter will be deprecated in future versions of Veeam Backup for Microsoft 365.</p><p>Defines that the cmdlet will add SharePoint Web Parts to Microsoft Entra application settings.</p><p>Default: <em>False</em></p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the [About Common Parameters](http://go.microsoft.com/fwlink/p/?LinkID=113216) section of Microsoft Learn.

## Output Object
The cmdlet returns the [`VBOApplicationOnlyConnectionSettings`](vboapplicationonlyconnectionsettings.md) object that defines Microsoft Entra application settings.

## Examples

::: example
### 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:

1. Run the [`Read-Host`](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/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.
3. 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.

:::

::: example
### 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:

1. Run the [`Read-Host`](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/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.
3. 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.

4. To set up a secure connection to a Microsoft organization, open the [https://microsoft.com/devicelogin](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.

:::

::: example
### 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:

1. Run the [`Read-Host`](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/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.
3. 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.

:::

::: example
### 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:

1. Run the [`Read-Host`](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/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.
3. 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.

:::

::: example
### 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:

1. Run the [`Read-Host`](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/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.
3. 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``](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/read-host)