Sections on this page:

 

anchor link Prerequisites

empty

anchor link Note:
Windows PowerShell (5.1 and earlier versions) is not supported! To run the module from Windows, install PowerShell Core on your Windows machine, using the Microsoft Store or go to the PowerShell Github for other installation options.

The module requires:

  • PowerShell Core (minimum version 7.2.1)

The module requires and automatically installs:

  • Exchange Online Module version minimum 3.0.0+
  • DNSClient-PS 1.0+

For information on how to connect to Exchange Online via Powershell, see the Exchange Online PS Module docs.

anchor link Operating Systems

The code and was tested on Windows and macOS. PowerShell Core on Linux should work as well, but has not been intensively tested so far.

anchor link Security

When connecting to Exchange Online, we recommend using the -Device or -Credential based login option. If you want to use credential-based login, we recommend using the Microsoft Secrets Management module to store your username/passwords in a secure place on your disk.

anchor link Installation

warning

anchor link Important:
Do not use the PowerShell Module SEPPmail365 (without cloud at the end) we have also on the PowerShell Gallery. This module will create NON-WORKING setups as it is intended to be used with self-hosted, customer-owned or MSP-operated SEPPmail Appliances.

anchor link Installation of the module

To install the SEPPmail365Cloud module, open Powershell Core (pwsh.exe) and execute:

cd ~ # go to the Home-Directory
 
Install-Module "SEPPmail365cloud" # install the SEPPmail365cloud module

anchor link Additional steps on macOS and Linux (experimental)

In addition to the main module you need to add PSWSMan which adds WSMan client libraries to Linux and macOS for remote connectivity to Exchange Online.

warning

anchor link Important:
Do this in the appropriate shell (bash, or similar) - not in the Powershell!

 

sudo pwsh -command 'Install-Module PSWSMan'
 
#Read more on this here: https://github.com/jborean93/omi
 
sudo pwsh -Command 'Install-WSMan'

 

Further information and detailed steps for the module setup can be found on our GitHub repository for our other PowerShell Module SEPPmail365 module documentation.