How to Configure an Office 365 Exchange Online Service Account and Import Historical Data

Requirements

• Microsoft .NET Framework 4.5 or 4.5.1 and either the Windows Management Framework 3.0 or the Windows Management Framework 4.0.

• Verify the service account has the following:

  • A mailbox that is not hidden in the Global Address list.

  • A license that supports Outlook (i.e., not a kiosk license).
• Enable RPC over HTTP (RoH) for the mailbox. See also How to Enable RPC over HTTP Connectivity.

Step 1. Connect to Office 365 Exchange Online

1. Open Windows PowerShell, enter the following command, and then press Enter:
   $UserCredential = Get-Credential
2. In the Windows PowerShell Credential Request dialog box, enter your Exchange Online user name and password, and then click OK.

3. Enter the following command, and then press Enter:
   $Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri https://outlook.office365.com/powershell-liveid/ -Credential $UserCredential -Authentication Basic -AllowRedirection

   For more information, refer to the Microsoft TechNet article Connect to Exchange Online using remote PowerShell.

4. Enter the following command, and then press Enter:
   Import-PSSession $Session

5. Enter the following command, and then press Enter:
   Get-Mailbox -ResultSize unlimited | Add-MailboxPermission -User ServiceAccount@domain.com -AccessRights fullaccess -InheritanceType all -Automapping $false

   Permissions are assigned on existing mailboxes only; if additional mailboxes are added to your organization, you must rerun this command.

   For more information on adding mailbox permissions, see Add-MailboxPermission in Microsoft TechNet. For information on testing mailbox rights, see Get-MailboxPermission in Microsoft TechNet.

Step 2. Import from Office 365 Exchange Online

Automatically Discover Settings

1. Log into the Barracuda Cloud Archiving Service as the admin, and go to Mail Sources > Exchange Integration.

2. Click Start New Action. In the Select Action page, click Email Import.
3. In the Select Server page, click Add New Server.
4. In the Add New Server dialog box, enter a Configuration Name, the email address for the service account and the service account password.
5. Click Autodiscover.

• • If autodiscover is unable to identify your settings, use the steps in the section that follows, Manually Configure Settings.

Manually Configure Settings

Use the steps in this section only if autodiscover is unable to identify your settings as described above in the section Automatically Discover Settings.

Step 1. Manually Obtain Exchange Hostname Using PowerShell

1. Open Windows PowerShell, and connect to Office 365 Exchange Online.

2. Enter the following command, and then press Enter: 
   $UserCredential = Get-Credential
3. In the Windows PowerShell Credential Request dialog box, enter your Exchange Online admin username and password, and then click OK.

4. Enter the following command, and then press Enter:
   $Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri https://outlook.office365.com/powershell-liveid/ -Credential $UserCredential -Authentication Basic -AllowRedirection

   For more information, refer to the Microsoft TechNet article Connect to Exchange Online using remote PowerShell.

5. Enter the following command, and then press Enter:
   Import-PSSession $Session

6. Enter the following command, and then press Enter:
   Get-Mailbox -Identity <username for service account> | Format-List ExchangeGuid, PrimarySMTPAddress

7. To determine the Exchange Hostname, combine the ExchangeGuid with the domain portion of the PrimarySMTPAddress to form ExchangeGuid@domain.com.
8. To close out the remote PowerShell session, enter the following command, and then press Enter:
   Remove-PSSession $Session

Step 2. Manually Configure Server Settings for Email Import

1. Log into the Barracuda Cloud Archiving Service as the admin, and go to Mail Sources > Exchange Integration.

2. Click Start New Action. In the Select Action page, click Email Import.
3. In the Select Server page, click Add New Server.
4. In the Add New Server dialog, click Configure Manually; enter the Exchange details:
   1. Configuration Name – Enter a name to identify the configuration.
   2. Exchange Hostname – Enter the Exchange hostname from Step 1 Manually Obtain Exchange Hostname Using PowerShell.
   3. Username – Enter the service account username.
   4. Password – Enter the password associated with the username.
   5. Exchange 2013 – Select Yes.
   6. Advanced Options – In the Proxy Server field type outlook.office365.com and leave the Global Catalog Server field blank.
5. Click Save to add your configuration and close the dialog box.

6. In the Configure Action page, click Continue.

7. In the View Summary page, select All Users from the Source drop-down menu.

8. Specify the desired Date and Schedule settings. Click Continue.

9. Verify the configuration settings in the View Summary page, and then click Submit to add the Email Import to the Scheduled Actions table.