Comment importer en masse des utilisateurs dans Microsoft 365 avec PowerShell et CSV

Tout d'abord, installez le SDK Microsoft Graph PowerShell, qui a remplacé les modules MSOnline et AzureAD obsolètes. Ouvrez PowerShell 7+ en tant qu'administrateur et exécutez la commande d'installation.

Install-Module Microsoft.Graph -Force -AllowClobber -Scope CurrentUser
Import-Module Microsoft.Graph.Users

L'installation télécharge la dernière version (2.21.1 en mars 2026) avec un support amélioré des opérations en masse et une meilleure gestion du throttling.

Vérification : Vérifiez la version installée :

Get-Module Microsoft.Graph -ListAvailable | Select-Object Name, Version

Vous devriez voir la version 2.21.1 ou ultérieure répertoriée.

Créez un fichier CSV correctement formaté avec un encodage UTF-8. Le fichier doit inclure des en-têtes spécifiques qui correspondent aux paramètres utilisateur de Microsoft Graph. Enregistrez ceci sous le nom users.csv :

UserPrincipalName,DisplayName,MailNickname,GivenName,Surname,PasswordProfile,UsageLocation,City,Department
user1@contoso.com,"John Smith","jsmith","John","Smith","TempPass123!","US","Seattle","IT"
user2@contoso.com,"Jane Doe","jdoe","Jane","Doe","TempPass123!","US","New York","HR"
user3@contoso.com,"Mike Johnson","mjohnson","Mike","Johnson","TempPass123!","US","Chicago","Finance"

Les colonnes requises incluent UserPrincipalName, DisplayName, MailNickname, et PasswordProfile. Des champs optionnels comme UsageLocation sont cruciaux pour l'attribution de licences ultérieure.

Vérification : Ouvrez le fichier CSV dans un éditeur de texte pour assurer l'encodage UTF-8 et une séparation correcte par des virgules sans espaces supplémentaires.

Établissez une connexion à Microsoft Graph avec les autorisations nécessaires pour la gestion des utilisateurs. Exécutez cette commande et complétez l'authentification interactive :

Connect-MgGraph -Scopes "User.ReadWrite.All"

Cela ouvre une fenêtre de navigateur pour l'authentification. Connectez-vous avec votre compte d'administrateur global ou d'administrateur utilisateur. Le scope User.ReadWrite.All accorde la permission de créer et modifier des utilisateurs.

Pour les scripts automatisés sans authentification interactive, utilisez l'authentification basée sur un certificat :

# Pour l'automatisation (nécessite l'enregistrement de l'application)
Connect-MgGraph -ClientId "your-app-id" -TenantId "your-tenant-id" -CertificateThumbprint "your-cert-thumbprint"

Vérification : Confirmez la connexion et les autorisations :

Get-MgContext | Select-Object Scopes, Account, TenantId

Chargez le fichier CSV et validez que tous les champs requis sont présents. Cette étape prévient les erreurs lors du processus d'importation en masse :

# Charger les données CSV
$userData = Import-Csv -Path "C:\temp\users.csv" -Encoding UTF8

# Valider les champs requis
$requiredFields = @('UserPrincipalName', 'DisplayName', 'MailNickname', 'PasswordProfile')
foreach ($field in $requiredFields) {
    if ($field -notin ($userData[0].PSObject.Properties.Name)) {
        Write-Error "Champ requis manquant : $field"
        exit 1
    }
}

Write-Host "Chargé $($userData.Count) utilisateurs pour l'importation" -ForegroundColor Green

Ensuite, vérifiez les utilisateurs existants pour éviter les conflits :

# Vérifier les utilisateurs existants
$conflicts = @()
foreach ($user in $userData) {
    try {
        $existingUser = Get-MgUser -Filter "userPrincipalName eq '$($user.UserPrincipalName)'" -ErrorAction SilentlyContinue
        if ($existingUser) {
            $conflicts += $user.UserPrincipalName
        }
    } catch {
        # L'utilisateur n'existe pas, continuer
    }
}

if ($conflicts.Count -gt 0) {
    Write-Warning "Trouvé $($conflicts.Count) utilisateurs existants : $($conflicts -join ', ')"
}

Vérification : Examinez la sortie pour vous assurer que tous les utilisateurs sont chargés et qu'aucun conflit critique n'existe.

Exécutez le processus d'importation en masse avec une gestion complète des erreurs et un suivi de la progression. Ce script crée des utilisateurs un par un avec une journalisation détaillée :

# Initialiser les variables de suivi
$results = @()
$successCount = 0
$errorCount = 0

# Traiter chaque utilisateur
foreach ($user in $userData) {
    try {
        # Préparer le profil de mot de passe
        $passwordProfile = @{
            Password = $user.PasswordProfile
            ForceChangePasswordNextSignIn = $true
        }
        
        # Préparer les paramètres de l'utilisateur
        $userParams = @{
            DisplayName = $user.DisplayName
            UserPrincipalName = $user.UserPrincipalName
            MailNickname = $user.MailNickname
            GivenName = $user.GivenName
            Surname = $user.Surname
            UsageLocation = $user.UsageLocation
            City = $user.City
            Department = $user.Department
            PasswordProfile = $passwordProfile
            AccountEnabled = $true
        }
        
        # Créer l'utilisateur
        $newUser = New-MgUser @userParams
        
        # Journaliser le succès
        $results += [PSCustomObject]@{
            UPN = $user.UserPrincipalName
            Status = "Succès"
            Id = $newUser.Id
            Error = ""
        }
        $successCount++
        Write-Host "✓ Créé : $($user.DisplayName)" -ForegroundColor Green
        
        # Délai de limitation pour éviter les limites de l'API
        Start-Sleep -Seconds 2
        
    } catch {
        # Journaliser l'échec
        $results += [PSCustomObject]@{
            UPN = $user.UserPrincipalName
            Status = "Échec"
            Id = ""
            Error = $_.Exception.Message
        }
        $errorCount++
        Write-Host "✗ Échec : $($user.UserPrincipalName) - $($_.Exception.Message)" -ForegroundColor Red
    }
}

# Exporter les résultats
$results | Export-Csv -Path "C:\temp\import_results.csv" -NoTypeInformation
Write-Host "\nRésumé de l'importation : Succès : $successCount | Échec : $errorCount" -ForegroundColor Cyan

Vérification : Vérifiez le fichier CSV des résultats et vérifiez les utilisateurs réussis dans le centre d'administration Microsoft 365.

Après avoir créé des utilisateurs, attribuez des licences pour activer les services Microsoft 365. Tout d'abord, identifiez les SKU de licence disponibles dans votre locataire :

# Obtenir les licences disponibles
$availableLicenses = Get-MgSubscribedSku | Select-Object SkuPartNumber, SkuId, ConsumedUnits, PrepaidUnits
$availableLicenses | Format-Table

# Obtenir la licence Microsoft 365 E3 (exemple)
$e3Sku = (Get-MgSubscribedSku | Where-Object SkuPartNumber -eq "ENTERPRISEPACK").SkuId

Maintenant, attribuez des licences aux utilisateurs créés avec succès :

# Attribuer des licences aux utilisateurs réussis
$successfulUsers = $results | Where-Object Status -eq "Success"
$licenseSuccessCount = 0
$licenseErrorCount = 0

foreach ($user in $successfulUsers) {
    try {
        # Attribuer la licence
        Set-MgUserLicense -UserId $user.Id -AddLicenses @(@{SkuId = $e3Sku}) -RemoveLicenses @()
        
        Write-Host "✓ Licencié : $($user.UPN)" -ForegroundColor Green
        $licenseSuccessCount++
        
        # Petit délai pour éviter le throttling
        Start-Sleep -Seconds 1
        
    } catch {
        Write-Host "✗ Échec de la licence : $($user.UPN) - $($_.Exception.Message)" -ForegroundColor Red
        $licenseErrorCount++
    }
}

Write-Host "\nRésumé des licences : Succès : $licenseSuccessCount | Échec : $licenseErrorCount" -ForegroundColor Cyan

Vérification : Vérifiez les licences utilisateur dans le centre d'administration ou exécutez :

Get-MgUser -UserId "user@contoso.com" | Select-Object DisplayName, AssignedLicenses

Effectuez la vérification finale du processus d'importation et nettoyez la session PowerShell. Tout d'abord, vérifiez un échantillon d'utilisateurs créés :

# Vérifier un échantillon aléatoire d'utilisateurs créés
$sampleUsers = $results | Where-Object Status -eq "Success" | Get-Random -Count 3

foreach ($user in $sampleUsers) {
    $verifyUser = Get-MgUser -UserId $user.Id | Select-Object DisplayName, UserPrincipalName, AccountEnabled, AssignedLicenses
    Write-Host "Vérifié : $($verifyUser.DisplayName) - Activé : $($verifyUser.AccountEnabled)" -ForegroundColor Green
}

Générez un rapport récapitulatif complet :

# Générer le rapport final
$report = @{
    TotalProcessed = $userData.Count
    SuccessfulCreations = $successCount
    FailedCreations = $errorCount
    SuccessfulLicensing = $licenseSuccessCount
    FailedLicensing = $licenseErrorCount
    Timestamp = Get-Date
}

$report | ConvertTo-Json | Out-File "C:\temp\import_summary.json"
Write-Host "\n=== RÉSUMÉ FINAL DE L'IMPORTATION ===" -ForegroundColor Yellow
$report | Format-List

Nettoyez la session PowerShell :

# Déconnexion de Microsoft Graph
Disconnect-MgGraph
Write-Host "Déconnecté de Microsoft Graph" -ForegroundColor Green

Vérification : Connectez-vous au centre d'administration Microsoft 365 et accédez à Utilisateurs > Utilisateurs actifs pour confirmer que tous les utilisateurs apparaissent avec les informations et les attributions de licences correctes.