New-VBOOffice365ApplicationOnlyConnectionSettings
Short Description
Defines Azure AD application settings.
Syntax
This cmdlet provides parameter sets that allow you to:
- Define AD Azure application settings with a user name of a Microsoft Exchange user.
New-VBOOffice365ApplicationOnlyConnectionSettings -ImpersonationAccountName <String> -ApplicationId <Guid> -ApplicationCertificatePath <String> [-ApplicationCertificatePassword <SecureString>] [-SharePointSaveAllWebParts [<SwitchParameter>]] [<CommonParameters>] |
- Define AD Azure application settings using Microsoft Office 365 organization name.
New-VBOOffice365ApplicationOnlyConnectionSettings -OfficeOrganizationName <String> -ApplicationId <Guid> -ApplicationCertificatePath <String> [-ApplicationCertificatePassword <SecureString>] [-SharePointSaveAllWebParts [<SwitchParameter>]] [<CommonParameters>] |
- Define new Azure AD application settings using application ID and a new application certificate path.
New-VBOOffice365ApplicationOnlyConnectionSettings -ApplicationId <Guid> -ApplicationCertificatePath <String> [-ApplicationCertificatePassword <SecureString>] [-ConfigureApplication [<SwitchParameter>]][-SharePointSaveAllWebParts [<SwitchParameter>]] [<CommonParameters>] |
- Define new Azure AD application settings using a new certificate path.
New-VBOOffice365ApplicationOnlyConnectionSettings -ApplicationCertificatePath <String> [-ApplicationCertificatePassword <SecureString>] [-NewApplicationName <String>] [-SharePointSaveAllWebParts [<SwitchParameter>]] [<CommonParameters>] |
Detailed Description
This cmdlet creates the VBOOffice365ApplicationOnlyConnectionSettings object. This object defines Azure AD application settings that allow you to use multi-factor authentication when you add Microsoft organizations to the Veeam Backup for Microsoft Office 365 infrastructure. Depending on your setup you can define Azure AD application settings using the following options:
- Define AD Azure application settings without authentication code. Use this option to define an AD Azure application without using an authentication code. To authenticate against a Microsoft Office 365 server you must provide a Microsoft Exchange user name. The cmdlet will not configure Azure AD application settings.
- Define AD Azure application settings using Microsoft Office 365 organization name. Use this option to define an AD Azure application that you will use to back up only Microsoft SharePoint Online and Microsoft OneDrive for Business services. To authenticate against Microsoft Office 365 server you must provide a Microsoft Office 365 organization name. The cmdlet will not configure Azure AD application settings.
- Define new Azure AD application settings using application ID and a new application certificate path. Use this option to register new Azure AD application settings.
- Define new Azure AD application settings using a certificate. Use this option to configure Azure AD application without specifying the application ID settings.
Important! |
This cmdlet is available only in Veeam Backup for Microsoft Office 365 version 4c. |
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 against the Microsoft Exchange server. | String | True | Named | True |
OfficeOrganizationName | Specifies a name of Microsoft organization. The cmdlet will use this name to authenticate against the Microsoft Office 365 server. | String | True | Named | True |
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 | True |
NewApplicationName | Specifies a name of a new Azure AD application. The cmdlet will define Azure AD application settings with this name. | String | False | Named | 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 |
ApplicationId | Specifies an Azure AD application ID. The cmdlet will use this application ID to set up a secure connection to a Microsoft organization. | Guid | True | Named | True |
ConfigureApplication | Defines that the cmdlet will configure settings of an existing Azure AD application. | SwitchParameter | False | Named | False |
SharePointSaveAllWebParts | Defines that the cmdlet will add SharePoint Web Parts to Azure AD application settings. | SwitchParameter | False | Named | False |
<CommonParameters>
This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.
Output Object
The cmdlet returns the VBOApplicationOnlyConnectionSettings object that defines Azure AD application settings.
Examples
Example 1. Defining AD Azure Application Settings with User Name of Microsoft Exchange User
This example shows how to define Azure AD application settings using the Office365Admin@tech-365.tech user name to authenticate to the Microsoft Office 365 server.
Perform the following steps:
|
Example 2. Defining AD Azure Application Settings Using Microsoft 365 Organization Name
This example shows how to define Azure AD application settings. The cmdlet will use the @tech-365.tech name to authenticate against the Microsoft Office 365 server. The cmdlet will not configure Azure AD application settings.
Perform the following steps:
|
Example 3. Defining New Azure AD Application Settings
This example shows how to define new Azure AD application settings. The cmdlet will add this application to the Azure AD.
Perform the following steps:
|
Example 4. Defining Settings of Existing Azure AD Application
This example shows how to define settings of an existing Azure AD application.
Perform the following steps:
|
Example 5. Defining Azure AD Application Using Certificate
This example shows how to define settings of an Azure AD application using the certificate with the following settings:
Perform the following steps:
|
Related Commands