Skip to main content

Create Exchange mailboxes

This section details the steps required for you to create the Exchange Mailboxes required for each instance of Pro-Sapien.

Before you start​

Prerequisite stages​

Confirm the following stages have been completed:

Parameters​

The following values from the parameters workbook are required:

  • {Mailbox-Email-Address}
  • {Mailbox-Alias}
  • {Mailbox-Display-Name}
  • {Deployment-Accounts}

Permission required​

Use an account with the following permissions:

  • Exchange Administrator

Exchange Mailbox​

Create a new mailbox in Exchange Online for each Pro-Sapien instance.

Two instances will be deployed, requiring two mailboxes:

  • UAT (test)
  • Production (live)

While both User and Shared mailboxes are supported, Shared mailboxes are recommended.

The following link provides steps for creating a Shared mailbox in the Microsoft 365 Admin Center:

Use the following details for the instance.

  • Email Address: {Mailbox-Email-Address}
  • Alias: {Mailbox-Alias}
  • Display Name: {Mailbox-Display-Name}

Alternatively, the following PowerShell can be used.

note

IMPORTANT: Variables at top of script must be updated before proceeding.

  • $Alias: populate with {Mailbox-Alias}
  • $DisplayName : populate with {Mailbox-Display-Name}

$Alias = ""
$DisplayName = ""

Connect-ExchangeOnline

New-Mailbox -Shared -Name $DisplayName `
-DisplayName $DisplayName `
-Alias $Alias

Grant Permissions​

Add the {Deployment-Accounts} for the instance to the following roles in the new mailbox:

  • Full access

The following links provide examples and information on this:

Alternatively, the following PowerShell can be used.

note

IMPORTANT: Variables at top of script must be updated before proceeding.

  • $Alias: populate with {Mailbox-Alias}
  • $DeploymentAccount: populate with {Deployment-Accounts} (run for each account separately)
$Alias = ""
$DeploymentAccount = ""

Connect-ExchangeOnline
Get-EXOMailbox -Identity $Alias | Add-MailboxPermission -User $DeploymentAccount -AccessRights FullAccess -InheritanceType All

Script should be run for each deployment account.