powershell-scripts/m365/migration

Exchange Online PowerShell Migration Tools

This is a collection of useful commands and scripts to aid in Exchange Online tenant migrations.

Before running these commands, install and import the Exchange Online PowerShell module and connect:

Install-Module ExchangeOnlineManagement
Import-Module ExchangeOnlineManagement

Connect-ExchangeOnline

Get email aliases

Use this command to get a list of aliases for all mailboxes. Optionally specify a mailbox: Get-Mailbox 'bsmith@contoso.com' | ...

Get-Mailbox | select DisplayName,PrimarySmtpAddress,@{n='EmailAliases';e={$_.EmailAddresses -cnotmatch 'SMTP:|SPO:|SIP:|[xX]500:' -replace 'smtp:','' -join ',' }}

DisplayName                        PrimarySmtpAddress                                  EmailAliases
-----------                        ------------------                                  ------------
Barbie Smith                       bsmith@contoso.com                                  barbie@contoso.onmicrosoft.com
Clement Jones                      cjones@contoso.com                                  clement@contoso.onmicrosoft.com

If you'd like to export this to CSV, replace the -join parameter with a semicolon, and pipe to Export-Csv like so:

Get-Mailbox | select DisplayName,PrimarySmtpAddress,@{n='EmailAliases';e={$_.EmailAddresses -cnotmatch 'SMTP:|SPO:|SIP:|[xX]500:' -replace 'smtp:','' -join ';' }} | Export-Csv -Path 'C:\Path\To\Export.csv' -NoTypeInformation

Get group membership

Get a list of distribution and Microsoft 365 Teams and their members.

Get-Group | where { $_.RecipientType -ne "Group" } | select DisplayName,@{n='Members';e={ $_.Members -join ',' }

Follow the same process as above to export to CSV.

Grant-SPOPersonalSiteCollectionAdmin

Use this script to grant an admin or migration account the CollectionAdmin role to all personal SharePoint Online sites (OneDrive). This is required if using a single migration account to copy OneDrive data to a new tenant.

Before running this script, install and import the SharePoint Online PowerShell module:

Install-Module Microsoft.Online.SharePoint.PowerShell
Import-Module Microsoft.Online.SharePoint.PowerShell

The script will connect to the SPO Admin center with the configured admin center URL:

# Set the SharePoint Admin page URL
$AdminUrl = 'https://contoso-admin.sharepoint.com'

You will also need to set the UPN of the migration account:

# Set the migration account name
$MigrationAccount = 'migration@contoso.com'