# 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.