mirror of
https://github.com/admindroid-community/powershell-scripts.git
synced 2025-12-17 16:35:19 +00:00
Convert DL to M365 Groups
Convert DL to M365 Groups
This commit is contained in:
AdminDroid
parent
36b5f8ae6a
commit
f8913aec89
230
Convert DL to M365 Groups/ConvertDLToM365Group.ps1
Normal file
230
Convert DL to M365 Groups/ConvertDLToM365Group.ps1
Normal file
@ -0,0 +1,230 @@
|
|||||||
|
<#
|
||||||
|
=============================================================================================
|
||||||
|
Name: Upgrade Distribution Lists to Microsoft 365 Groups Using PowerShell
|
||||||
|
Description: This script converts distribution lists to Microsoft 365 groups
|
||||||
|
Version: 1.0
|
||||||
|
Website: o365reports.com
|
||||||
|
Script by: O365Reports Team
|
||||||
|
For detailed script execution: https://o365reports.com/2023/02/21/upgrade-distribution-lists-to-microsoft-365-groups-using-powershell/
|
||||||
|
============================================================================================
|
||||||
|
#>
|
||||||
|
param (
|
||||||
|
[string] $DistributionEmailAddress = $null,
|
||||||
|
[string] $UserName = $null,
|
||||||
|
[string] $Password = $null,
|
||||||
|
[string] $InputFile = $null
|
||||||
|
)
|
||||||
|
#Connect Modules
|
||||||
|
function Connect_ExchangeOnline
|
||||||
|
{
|
||||||
|
Write-Progress -Activity "Connecting exchange online.."
|
||||||
|
$ExchangeOnlineModule = Get-Module ExchangeOnlineManagement -ListAvailable
|
||||||
|
if($ExchangeOnlineModule -eq $null)
|
||||||
|
{
|
||||||
|
Write-host "Important: Exchange online module is unavailable. It is mandatory to have this module installed in the system to run the script successfully."
|
||||||
|
$confirm = Read-Host Are you sure you want to install ExchangeOnline module? [Y] Yes [N] No
|
||||||
|
if($confirm -match "[yY]")
|
||||||
|
{
|
||||||
|
Write-host "Installing exchange online module..."
|
||||||
|
Install-Module -Name ExchangeOnlineManagement -Scope CurrentUser
|
||||||
|
Write-host "Exchange online Module is installed in the machine successfully" -ForegroundColor Magenta
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
Write-host "Exiting. `nNote: Exchange online module must be available in your system to run the script"
|
||||||
|
Exit
|
||||||
|
}
|
||||||
|
}
|
||||||
|
Disconnect-ExchangeOnline -Confirm:$false
|
||||||
|
try
|
||||||
|
{
|
||||||
|
if(($UserName -ne "") -and ($Password -ne ""))
|
||||||
|
{
|
||||||
|
$securedPassword = ConvertTo-SecureString -AsPlainText $Password -Force
|
||||||
|
$credential = New-Object System.Management.Automation.PSCredential $UserName,$securedPassword
|
||||||
|
Connect-ExchangeOnline -Credential $credential -ShowBanner:$false -ErrorAction SilentlyContinue # For Non-MFA account
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
Connect-ExchangeOnline -ShowBanner:$false -ErrorAction SilentlyContinue
|
||||||
|
}
|
||||||
|
}
|
||||||
|
catch
|
||||||
|
{
|
||||||
|
Write-Host $_.Exception.message -ForegroundColor Red
|
||||||
|
Exit
|
||||||
|
}
|
||||||
|
Write-Host "Exchange online connected" -ForegroundColor Green
|
||||||
|
}
|
||||||
|
#To create group
|
||||||
|
function Create_M365Group
|
||||||
|
{
|
||||||
|
Write-Progress -Activity "Creating Microsoft 365 group...."
|
||||||
|
$Params=@{}
|
||||||
|
$Params= @{DisplayName =$DLGroup.DisplayName
|
||||||
|
AccessType =$AccessType
|
||||||
|
ManagedBy =$DLGroup.managedby
|
||||||
|
RequireSenderAuthenticationEnabled =$DLGroup.RequireSenderAuthenticationEnabled
|
||||||
|
}
|
||||||
|
if($GroupMember -ne $null)
|
||||||
|
{
|
||||||
|
$Params.Add('Members',$GroupMember)
|
||||||
|
}
|
||||||
|
if($AccessType -eq 'Private')
|
||||||
|
{
|
||||||
|
$Params.Add('HiddenGroupMembershipEnabled',$DLGroup.HiddenGroupMembershipEnabled)
|
||||||
|
}
|
||||||
|
$script:NewM365Group = New-UnifiedGroup @Params
|
||||||
|
if($NewM365Group -eq $null)
|
||||||
|
{
|
||||||
|
Write-Host $_.Exception.Message -ForegroundColor Red
|
||||||
|
return
|
||||||
|
}
|
||||||
|
Write-Host "$($DLGroup.DisplayName) group created successfuly" -ForegroundColor Green
|
||||||
|
$GetOwner = Compare-Object -ReferenceObject $DLGroup.managedby -DifferenceObject $NewM365Group.ManagedBy
|
||||||
|
$GetOwner = $GetOwner |Where-Object{$_.SideIndicator -eq "=>"}
|
||||||
|
$M365GroupOwner = $GetOwner.InputObject
|
||||||
|
Remove-DistributionGroup -Identity $DLMail -Confirm:$false
|
||||||
|
if($M365GroupOwner -ne $null)
|
||||||
|
{
|
||||||
|
Remove-UnifiedGroupLinks -Identity $NewM365Group.PrimarySmtpAddress -LinkType Owners -Links $M365GroupOwner -Confirm:$false -ErrorAction SilentlyContinue
|
||||||
|
if($GroupMember -notcontains $M365GroupOwner)
|
||||||
|
{
|
||||||
|
Remove-UnifiedGroupLinks -Identity $NewM365Group.PrimarySmtpAddress -LinkType Members -Links $M365GroupOwner -Confirm:$false -ErrorAction SilentlyContinue
|
||||||
|
}
|
||||||
|
}
|
||||||
|
While(1)
|
||||||
|
{
|
||||||
|
Write-Progress -Activity "Updating DL properties to Microsoft 365 group info..."
|
||||||
|
Start-Sleep -Seconds 5
|
||||||
|
Set-UnifiedGroup -Identity $NewM365Group.PrimarySmtpAddress -PrimarySmtpAddress $DLMail -ErrorAction SilentlyContinue -ErrorVariable DLGroupError
|
||||||
|
if($DLGroupError -ne $null)
|
||||||
|
{
|
||||||
|
Write-Host "Removed existing Distribution List does not updated... Waiting for 5 seconds" -ForegroundColor Red
|
||||||
|
Continue
|
||||||
|
}
|
||||||
|
Set-UnifiedGroup -Identity $DLMail -EmailAddresses @{Add = "X500:$($DLGroup.LegacyExchangeDN)"} -HiddenFromAddressListsEnabled $DLGroup.HiddenFromAddressListsEnabled -AcceptMessagesOnlyFromSendersOrMembers $DLGroup.AcceptMessagesOnlyFromSendersOrMembers -GrantSendOnBehalfTo $DLGroup.GrantSendOnBehalfTo -ModeratedBy $DLGroup.ModeratedBy -MailTip $DLGroup.MailTip -ErrorAction SilentlyContinue
|
||||||
|
break
|
||||||
|
}
|
||||||
|
Write-Host "$($DLGroup.DisplayName) group successfully converted to Microsoft 365 group" -ForegroundColor Green
|
||||||
|
Update_NewM365GroupInfo
|
||||||
|
}
|
||||||
|
#Update the group info
|
||||||
|
function Update_NewM365GroupInfo
|
||||||
|
{
|
||||||
|
$confirm = Read-Host Are you sure you want to update the Microsoft 365 group info? [Y] Yes [N] No
|
||||||
|
if($confirm -match "[yY]")
|
||||||
|
{
|
||||||
|
Write-Progress -Activity "Updating Microsoft 365 group info..."
|
||||||
|
$GroupName = Read-Host "Enter the Microsoft 365 group name"
|
||||||
|
if($GroupName -ne "")
|
||||||
|
{
|
||||||
|
Set-UnifiedGroup -Identity $DLMail -DisplayName "$GroupName" -ErrorAction SilentlyContinue -ErrorVariable NameError
|
||||||
|
if($NameError -ne $null)
|
||||||
|
{
|
||||||
|
Write-Host $NameError.Exception[1] -ForegroundColor Yellow
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
Write-Host "Group name updated successfully" -ForegroundColor Green
|
||||||
|
}
|
||||||
|
}
|
||||||
|
$GroupMailAddress = Read-Host "Enter the Microsoft 365 group mail address"
|
||||||
|
if($GroupMailAddress -ne "")
|
||||||
|
{
|
||||||
|
Set-UnifiedGroup -Identity $DLMail -PrimarySmtpAddress "$GroupMailAddress" -ErrorAction SilentlyContinue -ErrorVariable EmailError
|
||||||
|
if($EmailError -ne $null)
|
||||||
|
{
|
||||||
|
Write-Host $EmailError.Exception[1] -ForegroundColor Yellow
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
Write-Host "Group mail address updated successfully" -ForegroundColor Green
|
||||||
|
}
|
||||||
|
}
|
||||||
|
$GroupAccessType = Read-Host "Do you want to change your group access type to(Private or Public)"
|
||||||
|
if($GroupAccessType -ne "")
|
||||||
|
{
|
||||||
|
Set-UnifiedGroup -Identity $DLMail -AccessType "$GroupAccessType" -ErrorAction SilentlyContinue -ErrorVariable AccessTypeError
|
||||||
|
if($AccessTypeError -ne $null)
|
||||||
|
{
|
||||||
|
Write-Host $AccessTypeError.Exception[1] -ForegroundColor Yellow
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
function CloseConnection
|
||||||
|
{
|
||||||
|
Disconnect-ExchangeOnline -Confirm:$false
|
||||||
|
Exit
|
||||||
|
}
|
||||||
|
|
||||||
|
#Connect exchange module
|
||||||
|
Connect_ExchangeOnline
|
||||||
|
#Check if parameter passed or not
|
||||||
|
if($DistributionEmailAddress -ne "")
|
||||||
|
{
|
||||||
|
$GetEmailAddress = $DistributionEmailAddress.Split(",")
|
||||||
|
}
|
||||||
|
elseif($InputFile -ne "")
|
||||||
|
{
|
||||||
|
try
|
||||||
|
{
|
||||||
|
$InputFileInfo = Import-Csv -Header "DLMail","AccessType" -path $InputFile
|
||||||
|
$GetEmailAddress = $InputFileInfo.DLMail
|
||||||
|
}
|
||||||
|
catch
|
||||||
|
{
|
||||||
|
Write-Host "File not found" -ForegroundColor Red
|
||||||
|
CloseConnection
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
$GetEmailAddress = Read-Host "Please enter distrbution mail you want to convert to Microsoft 365 group"
|
||||||
|
if($GetEmailAddress -ne "")
|
||||||
|
{
|
||||||
|
$GetEmailAddress = $GetEmailAddress.Split(",")
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
Write-Host "You didn't provide any distribution mail" -ForegroundColor Red
|
||||||
|
CloseConnection
|
||||||
|
}
|
||||||
|
}
|
||||||
|
$GetEligibleDLGroup = (Get-EligibleDistributionGroupForMigration).PrimarySmtpAddress
|
||||||
|
Foreach($DLMail in $GetEmailAddress)
|
||||||
|
{
|
||||||
|
$DLGroup = Get-DistributionGroup| Where-Object{$_.PrimarySmtpAddress -eq $DLMail}
|
||||||
|
if($DLGroup -ne $null)
|
||||||
|
{
|
||||||
|
if($GetEligibleDLGroup -notcontains $DLMail)
|
||||||
|
{
|
||||||
|
Write-Host "$($DLGroup.DisplayName) is not eligible for convert to Microsoft 365 group" -ForegroundColor Red
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
$GroupMember = (Get-DistributionGroupMember -Identity $DLMail).Name
|
||||||
|
Write-Host "`n$($DLGroup.DisplayName) group conversion process started..." -ForegroundColor Magenta
|
||||||
|
# Get access type from InputFile
|
||||||
|
if($InputFile -ne "")
|
||||||
|
{
|
||||||
|
$AccessType = $InputFileInfo| Where-Object{$_.DLMail -eq "$DLMail"}
|
||||||
|
$AccessType = $AccessType.AccessType
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
$AccessType = Read-Host "Access Type (Private or Public)"
|
||||||
|
}
|
||||||
|
if(($AccessType -ne 'Private') -and ($AccessType -ne 'Public'))
|
||||||
|
{
|
||||||
|
$AccessType = "Private"
|
||||||
|
Write-Host "Access type is wrong. So we can take access type of the group is private." -ForegroundColor Red
|
||||||
|
}
|
||||||
|
Create_M365Group
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
Write-Host "$DLMail is not found" -ForegroundColor Red
|
||||||
|
}
|
||||||
|
}
|
||||||
|
CloseConnection
|
||||||
Loading…
x
Reference in New Issue
Block a user