Automating User Onboarding in Microsoft 365 with PowerShell

# Define parameters for the new user
$firstName = "Alice"
$lastName = "Johnson"
$userPrincipalName = "$($firstName.ToLower()).$($lastName.ToLower())@yourdomain.com"
$password = "SecureP@ssw0rd!"  # Ensure this meets your organizations password policy
$license = "yourdomain:ENTERPRISEPACK"  # Replace with the appropriate license

# Import the required module (if not already imported)
Import-Module Microsoft.Graph
# Create the new user
New-MgUser -DisplayName "$firstName $lastName" `
            -UserPrincipalName $userPrincipalName `
            -AccountEnabled $true `
            -MailNickname "$($firstName.ToLower())$($lastName.ToLower())" `
            -PasswordProfile @{ ForceChangePasswordNextSignIn = $true; Password = $password }
Write-Host "User $firstName $lastName created successfully."

# Assign a license to the new user
Set-MgUserLicense -UserId $userPrincipalName -AddLicenses $license
Write-Host "License $license assigned to user $firstName $lastName."

# Add user to specified groups
$groups = @("group-id-1", "group-id-2")  # Replace with your actual group Object IDs
foreach ($group in $groups) {
    Add-MgGroupMember -GroupId $group -DirectoryObjectId $userPrincipalName
    Write-Host "User $firstName $lastName added to group with ID: $group."
}

# Verify the new user
$user = Get-MgUser -UserId $userPrincipalName
if ($user) {
    Write-Host "User $($user.DisplayName) successfully created with UPN: $($user.UserPrincipalName)."
} else {
    Write-Host "ERROR: User creation failed."
}