iEmail Cloud App Registration - PowerShell

This guide allows you to configure the Entra app registration for iEmail Cloud using Microsoft PowerShell.

You must be a Microsoft Entra administrator or global administrator to complete these steps.

Prerequisites

The machine running the script must have access to the internet, and must have an account or credentials to log in to the tenant where the app will be configured.

The machine must be running PowerShell v7.x. You can verify which version of PowerShell you are running by opening the Windows Terminal and entering $PSVersionTable. If the table displays a version number starting with 7.x, you are running the correct version.

Download the latest version of PowerShell v7.x here.

Open Terminal

Open Windows Terminal as an administrator. (Right-click and “Run as Administrator” or press Ctrl+Shift+Enter from the Start menu.)

Obtaining the Script

Copy, paste, and run each of the following lines in order to prepare the PS environment, download the iEmail Cloud script, and execute it.

If you get any security errors when running any of these commands, it is possible you may need to contact your IT department or MSP to have them temporarily lift security restrictions on your computer in order to complete these steps.

1. Set Execution Policy

POWERSHELL

Set-ExecutionPolicy Unrestricted Process -Force

2. Download the Script to a Temp Folder

POWERSHELL

cd $env:TEMP; (Invoke-WebRequest -Method GET -Uri https://cdn.cloud.csiinc.com/iemail-cloud/iemail-entra-install-script -UseBasicParsing).Content > install-iemail.ps1

Important: You should always review scripts downloaded from the internet before running them to ensure they do not contain malicious code. Click here to review the script in your browser.

3. Run the Script

POWERSHELL

. .\install-iemail.ps1

Running the Script

After running the script (Step 3 above), you will be asked to log in with your Microsoft account. Be sure to select the correct account that is 1) an administrator or user with Entra permissions, and 2) is a member of the correct tenant.

After logging in and returning to the Terminal window, you should see the following output:

Copy the Application ID in the output and save it in a temporary location such as Notepad - you will need it for the next step. (Don’t worry – if you lose it, you can get it again from the Entra admin console.)

You may now close the console window.

Configuring iEmail Cloud

Open iEmail Cloud (in either Read or Compose mode). In the menu, select “Setup”.

Paste the Application ID into the configuration box and press Save.

You may need to close and reopen iEmail Cloud for the changes to take effect.

Success!

Attachments should now be functional in iEmail Cloud.