New-VBOOffice365ConnectionSettings
Short Description
Defines connection settings to access Microsoft Office 365 organizations.
Syntax
This cmdlet provides parameter sets that allow you to:
- Define connection settings to access Microsoft Office 365 organizations using basic authentication.
New-VBOOffice365ConnectionSettings -Credential <pscredential> [-GrantRolesAndPermissions] [-VeeamAADApplicationUsed] [<CommonParameters>] |
- Define connection settings to access Microsoft Office 365 organizations using modern authentication with an application secret.
New-VBOOffice365ConnectionSettings -AppCredential <pscredential> -ApplicationId <guid> -ApplicationSecret <securestring> [-GrantRolesAndPermissions] [<CommonParameters>] |
- Define connection settings to access Microsoft Office 365 organizations using modern authentication with an application certificate.
New-VBOOffice365ConnectionSettings -AppCredential <pscredential> -ApplicationId <guid> -ApplicationCertificatePath <string> [-GrantRolesAndPermissions] [-ApplicationCertificatePassword <securestring>] [<CommonParameters>] |
Detailed Description
This cmdlet creates the VBOOffice365ConnectionSettings object. This object defines connection settings to access Microsoft Office 365 organizations. You can apply these settings to add Microsoft Office 365 organizations to Veeam Backup for Microsoft Office 365 infrastructure.
Run the Add-VBOOrganization cmdlet to add Microsoft organizations to Veeam Backup for Microsoft Office 365 infrastructure.
Important! |
This type of connection settings utilizes legacy authentication protocols. |
Parameters
Parameter | Description | Type | Required | Position | Accept Pipeline Input | Accept Wildcard Characters |
AppCredential | For the modern authentication type. Specifies credentials. The cmdlet will use these credentials to connect to a Microsoft Office 365 organization. | PSCredential | True | Named | False | False |
ApplicationCertificatePassword | For the modern authentication type. Specifies an application password. The cmdlet will use these credentials to connect to a Microsoft Office 365 organization. | SecureString | False | Named | False | False |
ApplicationCertificatePath | For the modern authentication type. Specifies the path to the application certificate. The cmdlet will use this path to get the application certificate and to connect to a Microsoft Office 365 organization. | String | True | Named | False | False |
ApplicationId | For the modern authentication type. Specifies an application ID. The cmdlet will use an application ID to connect to a Microsoft Office 365 organization. | Guid | True | Named | False | False |
ApplicationSecret | For the modern authentication type. Specifies an application secret. The cmdlet will use an application secret to connect to a Microsoft Office 365 organization. | SecureString | True | Named | False | False |
Credential | Specifies credentials. The cmdlet will use these credentials to connect to a Microsoft Office 365 organization. | PSCredential | True | Named | False | False |
GrantRolesAndPermissions | Defines that the cmdlet will grant required permissions and assign appropriate roles to the account. | SwitchParameter | False | Named | False | False |
VeeamAADApplicationUsed | Defines that the cmdlet will use the Veeam application to connect to Microsoft Graph. Note: You must set this parameter to the True value for the following Microsoft Azure Regions:
Default: False | SwitchParameter | False | Named | False | False |
<CommonParameters>
This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.
Output Object
The cmdlet returns the VBOOffice365ConnectionSettings object that contains connection settings to access Microsoft Office 365 organizations.
Examples
Example 1. Defining Connection Settings with Basic Authentication
This example shows how to define Microsoft Office 365 organization connection settings with the basic authentication:
Perform the following steps:
|
Example 2. Defining Connection Settings with Modern Authentication Using Application Secret
This example shows how to define Microsoft Office 365 organization connection settings with a modern authentication using an application secret:
Perform the following steps:
|
Example 3. Defining Connection Settings with Modern Authentication Using Application Certificate
This example shows how to define Microsoft Office 365 organization connection settings with a modern authentication using an application certificate:
Perform the following steps:
|
Related Commands