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.

Beginning from module version 2.0, the required PowerShell version is:

The module requires and automatically installs the following modules in their latest supported versions:

  • ExchangeOnlineManagement
  • DNSClient-PS
  • PSWriteHTML

For general 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 app/certificate-based login option. If you need to use any kind of passwords or other secret information, we recommend using the Microsoft Secrets Management module to store sensitive information in a secure place.

For connectivity options including how to setup app/certificate-based connectivity, see minute 19:34 – 35:04  in the Deep Dive Video https://www.youtube.com/watch?v=cCYC77Vt7pw.

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-PSResource "SEPPmail365cloud" # install the SEPPmail365cloud module

 

The Module Microsoft.PowerShell.PSResourceGet has to be installed to use Install-PSResource. If this throws an error, watch the PowerShell install video referenced in Prerequisites above.

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 in the documentation of our other PowerShell Module: SEPPmail365 module documentation.