Prerequisites

 

The module requires at least PowerShell Core 7.2 (64bit) and the ExchangeOnlineManagement module of version 3.6.0 or higher.

 

The module was developed on Windows 11 and macOS 11.7.

 

Note on PowerShell on Debian: There are scenarios where module installation fails with an error on incorrect module manifest. We are currently investigating this. Please try to run it on PowerShell Core on Windows or macOS.

 

Note on Windows PowerShell: Make sure you have the latest version of PowerShellGet installed.

 

Install-Module PowerShellGet -Scope CurrentUser

 

 

Module Installation

 

Installation on Windows

 

For installation, execute

 

Install-Module "SEPPmail365"

 

Installation on macOS and Linux

 

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.

 

# Do this OUTSIDE Powershell in the shell !
sudo pwsh -command 'Install-Module PSWSMan -Scope allusers' # Read more on this here https://github.com/jborean93/omi

sudo pwsh -Command 'Install-WSMan'

 

Prereleases

 

If you want to use the newest version, that might not be production ready yet, go to the SEPPmail365 Github repository, download the source code and execute

 

Import-Module "C:\path\to\module\SEPPmail365.psd1"

 

 

Preparation

 

Prior to using this module you need to connect to your Exchange Online organization. Use either one of the following commands, depending on whether multi factor authentication is enabled for your account or not:

 

Without multi factor authentication:

 

Import-Module ExchangeOnlineManagement
$UserCredential = Get-Credential #Enter Exchange Admin UserName and Password
Connect-ExchangeOnline -Credential $UserCredential -ShowProgress $true
 
# If you have stored your credentials in Secretmanagement it would read:
Connect-ExchangeOnline -Credential (Get-Secret mycredentials) -ShowProgress $true

 

With multi factor authentication:

 

Import-Module ExchangeOnlineManagement
Connect-ExchangeOnline -UserPrincipalName frank@contoso.com -ShowProgress $true

 

With DEVICE Login:

 

Import-Module ExchangeOnlineManagement
# Login to the Exchange Environment with your Web-Browser
Connect-ExchangeOnline -Device
# Follow the instructions.