Exchange-Scripts/Docs/alias-toolkit.md

Alias Toolkit

How to use Alias Toolkit

1. Download the script or clone this repository
2. Make sure the execution policy is set properly (Or run Set-ExecutionPolicy Bypass -Scope Process)
3. Run the script.
4. Follow the on-screen prompts.

If target is Exchange Server, run script from the Exchange Management Shell.

If target is Exchange Online, run from a PS session that has already connected to Exchange Online Management Shell.

Alias Toolkit Options

1. List contents of a .csv

Use this option to verify that your .csv file containing email addresses is formatted correctly. The output should look like:

Display Name

Email Address 1

Email Address 2

Email Address 3

If the email addresses are on a single line, your formatting isn't correct and the import will import all your addresses as a single email address.

2. Apply the contents of a .csv to the currently logged in Exchange session

Use this option to apply the email addresses when you've verified that the .csv is formatted correctly.

This will apply the email addresses based on Display Name, so make sure that if display names were changed between environments, the .csv has been edited to reflect the changes.

3. Create a .csv based on a search term

This option will create a .csv with the columns Displayname and EmailAddresses based on the search term given.
This uses Get-Mailbox | Where-Object $_.EmailAddresses -like "$SearchTerm", so it will support wildcards.

This won't give you a .csv you can apply by default, this is by design. You need to replace the spaces with ; in the EmailAddresses column. This was implemented to ensure double-checking no unwanted addresses are included into the import.

4. Use the legacy search script and output the alias list to console.

This does the same as the above option, but outputs the results to console with some nice-ish formatting. This is an adaptation of search-email-addresses.