iMIS Power Suite - Outlook Integration

iMIS Outlook Integration App Registration - PowerShell

Microsoft recently discontinued the legacy API that iMIS Outlook Integration used to access attachments. The replacement API requires that a domain administrator create and link an Entra App Registration for iMIS Outlook Integration. Follow this guide to set up Entra app registration for iMIS Outlook Integration using Microsoft PowerShell.

To follow this guide, a basic familiarity with PowerShell is needed. Users can also follow the Entra Console setup guide instead.

Important! 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. 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.

Running the script

Do the following to run the script:

  1. From the Start menu, search for Windows Powershell.
  2. Right-click Windows Powershell and select Run as Administrator.
  3. Copy and paste each of the following lines, then press Enter on your keyboard to run each line:

    4. Note: If you get any security errors when running scripts, 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:

      2. Set-ExecutionPolicy Unrestricted Process -Force

    2. Download the script to a temporary folder:

      3. 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! Always review scripts downloaded from the internet before running them to ensure they do not contain malicious code. Review the install script.

    3. Run the script:

      4. . .\install-iemail.ps1

  4. After running the script, 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.
  5. After logging in and returning to the PowerShell window, the output shows the Application ID.

  6. Copy the Application ID in the output and save it in a temporary location, such as a Notepad window.

    7. Note: If you lose the Application ID, you can get it again from the Entra admin console.

  7. Close the console window.

Configuring iMIS Outlook Integration

Return to the iMIS Outlook Integration Attachment Configuration page to finish the setup.