38 lines
2.0 KiB
Markdown
38 lines
2.0 KiB
Markdown
# 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. |