Adding a New Team to Emailgistics (App Registration)

To onboard an additional mailbox to Emailgistics, most of the work is done through a PowerShell script. If you are using Microsoft Windows, PowerShell is typically pre-installed. If not, you can download it from Microsoft’s app store.

Please ensure that you have PowerShell version 5.1 or later to run the script. To check your PowerShell version, open PowerShell and enter $PSVersionTable in the command line.

Since our PowerShell script accesses Exchange Online and MSOnline, the admin executing the scripts should ensure that they have the necessary permissions in PowerShell before onboarding. You can check your permissions by running the following commands in PowerShell: Connect-ExchangeOnline and Connect-MsolService.

If you use any network-related antivirus software, such as Sentinel One, we recommend that you allow the execution of PowerShell scripts that access Exchange Online. This will ensure that Emailgistics can access the necessary resources to provide you with a seamless onboarding experience.

Once you confirm everything in our onboard checklist, you are ready to onboard your mailbox with Emailgistics.

Download Onboard Checklist

Before onboarding, be sure to add the shared mailbox to the security group you created for the app registration.

You can do this by doing the following:

Open the Office365 Admin Center
Click on Teams and Groups on the left
Click Active Teams and Groups
Click on the Security Groups tab
Find the security group you created for the app registration and click on it
Click on the Members tab of the right panel that opens
Click View all and Manage Members
Add the shared mailbox you wish to onboard to the members list

Navigate to the Emailgistics web page by going to www.emailgistics.com.
From the Emailgistics home page click on sign in.: You will authenticate with Microsoft single sign-on (SSO).
Once you get in, click on Mailboxes on the left, and then click on Add Mailbox.
Provide the email address of the Shared mailbox and click Add Mailbox.
You will be redirected to a page that requires you to confirm if you are a Global Admin in O365. If not, you will have to have a Global Admin from your organization execute the rest of the onboard process.
Once the Administrator is confirmed, they will have access to download our PowerShell script which will need to be extracted from the ZIP file and run using PowerShell 5.1 on Windows 10 or later.
Download the PowerShell script and extract it from its zip file. Ensure that both the Onboard.ps1 file and the Customer.JSON file are extracted to the same location.
Right-click on the Onboard.ps1 file and select “Run with PowerShell“. Note that some networks or VPNs may require you to run the script as an administrator or while on the organization’s network.
The script will prompt you for all required steps within PowerShell. Simply follow the prompts to complete the onboarding process.
After the PowerShell script has finished running, go back to the browser window where you initiated the onboarding process and click “I’ve finished running PowerShell script.”
The Azure AD app page appears.
Paste in the AppID, the Secret Value and the Secret Expiry that you saved in Notepad earlier and click Validate App.
Once the app validates, you will be asked to select your mailbox time zone. It will pick up the time zone of your browser by default. If all the agents of the shared mailbox are in the same time zone as you, you can hit Continue.
Click “Set up mailbox.” Note that if the inbox folder contains over 1000 emails, this step will fail. See the onboarding checklist for more information.
Congratulations, your mailbox has been successfully added! You are now ready to set up your new Emailgistics mailbox!