O365EmailAddressPolicy - PowerShell Module

O365EmailAddressPolicy PowerShell module replicates Exchange On-Premise functionality when it comes to Email Address Policy allowing cloud-only environments. Office 365 doesn't provide an option to autogenerate email addresses for users. This module enables the creation of email addresses for users based on their first name and last name.

Installing

Everyone can install this module from PowerShellGallery hosted by Microsoft. It's recommended way to work with the module. Version on PowershellGallery is optimized for speed and signed. Using code from GitHub is recommended for development.

Install-Module -Name O365Essentials -AllowClobber -Force

Force and AllowClobber aren't necessary, but they do skip errors in case some appear.

Updating

Update-Module -Name O365Essentials

That's it. Whenever there's a new version, you run the command, and you can enjoy it. Remember that you may need to close, reopen PowerShell session if you have already used module before updating it.

The essential thing is if something works for you on production, keep using it till you test the new version on a test computer. I do changes that may not be big, but big enough that auto-update may break your code. For example, small rename to a parameter and your code stops working! Be responsible!

Usage

# will give przemyslawklys@evotec.xyz
Get-EmailAddress -FirstName 'Przemysław' -LastName 'Kłys' -EmailTemplate "%g%s@evotec.xyz" -ToLower

$EmailTemplate = @(
    "%g.%s@evotec.xyz"  # will give przemyslaw.klys@evotec.xyz
    "%1g.%s@evotec.xyz" # will give p.klys@evotec.xyz
    "%1g%s@evotec.xyz"  # will give pklys@evotec.xyz
    "%3g.%s@evotec.xyz" # will give prz.klys@evotec.xyz
    "%g.%1s@evotec.xyz" # will give przemyslaw.k@evotec.xyz
    "%g@company.pl"     # will give przemyslaw@company.pl
)

Get-EmailAddress -FirstName 'Przemysław' -LastName 'Kłys' -EmailTemplate $EmailTemplate -ToLower