Creare utenti in blocco in Microsoft Entra ID

Microsoft Entra ID, parte di Microsoft Entra, supporta operazioni di creazione ed eliminazione bulk degli utenti e supporta il download di elenchi di utenti. È sufficiente compilare un modello di valori delimitati da virgole (CSV) che è possibile scaricare da Microsoft Entra ID.

Autorizzazioni necessarie

Per creare in blocco gli utenti nel portale di amministrazione, è necessario aver eseguito l'accesso come almeno un amministratore utente.

Informazioni sul modello CSV

Scaricare e compilare il modello CSV di caricamento bulk per facilitare la creazione di utenti di Microsoft Entra in blocco. Il modello CSV scaricato sarà simile a questo esempio:

Struttura del modello CSV

Un modello CSV scaricato contiene le righe descritte di seguito:

• Numero di versione: la prima riga contenente il numero di versione deve essere inclusa nel file CSV di caricamento.
• Intestazioni di colonna: il formato delle intestazioni di colonna è <Nome elemento> [NomeProprietà] <Obbligatorio o vuoto>. Ad esempio, Name [displayName] Required. Alcune versioni precedenti del modello potrebbero presentare lievi variazioni.
• Riga di esempi: nel modello è stata inclusa una riga di esempi di valori accettabili per ogni colonna. È necessario rimuovere la riga degli esempi e sostituirla con le proprie voci.

Indicazioni aggiuntive

• Le prime due righe del modello di caricamento non devono essere rimosse o modificate. In caso contrario, il caricamento non può essere elaborato.
• Le colonne obbligatorie sono riportate per prime.
• Non è consigliabile aggiungere nuove colonne al modello. Eventuali colonne aggiuntive aggiunte saranno ignorate e non verranno elaborate.
• È consigliabile scaricare la versione più recente del modello CSV il più spesso possibile.
• Assicurarsi di verificare che non siano presenti spazi vuoti imprevisti prima o dopo qualsiasi campo. Per Nome entità utente, la presenza di tali spazi vuoti provocherebbe un errore di importazione.
• Assicurarsi che i valori in Password iniziale siano conformi ai criteri password attualmente attivi.

Per creare utenti in blocco

1. Accedere all'interfaccia di amministrazione di Microsoft Entra almeno come Amministratore utenti.

2. Selezionare Microsoft Entra ID.

3. Selezionare Tutti gli utenti>Utenti>Crea in blocco.

4. Nella pagina Crea utente in blocco selezionare Scarica per ricevere un file con valori delimitati da virgole (CSV) valide delle proprietà utente e quindi aggiungere gli utenti da creare.

   

5. Aprire il file CSV e aggiungere una riga per ogni utente da creare. Gli unici valori obbligatori sono Nome, Nome dell'entità utente, Password iniziale e Blocca l'accesso (Sì/No). Salvare quindi il file.

   

6. Nella pagina Crea utenti in blocco individuare il file in Caricare il file CSV. Quando si seleziona il file e si fa clic su Invia viene avviata la convalida del file CSV.

7. Dopo la convalida del contenuto del file, viene visualizzato il messaggio Il file è stato caricato. Se sono presenti errori, è necessario correggerli prima di poter inviare il processo.

8. Quando il file supera la convalida, selezionare Invia per avviare l'operazione in blocco che importa i nuovi utenti.

9. Al termine dell'operazione di importazione, verrà visualizzata una notifica relativa allo stato processo dell'operazione in blocco.

Se si verificano errori, è possibile scaricare e visualizzare il file dei risultati nella pagina Risultati dell'operazione bulk. Il file contiene il motivo di ogni errore. L'invio del file deve corrispondere al modello usato e includere i nomi esatti della colonna. Per altre informazioni sulle limitazioni delle operazioni bulk, vedere Limiti del servizio di importazione bulk.

Verificare lo stato

È possibile visualizzare lo stato di tutte le richieste in sospeso di operazioni in blocco nella pagina Risultati dell'operazione in blocco.

Successivamente, è possibile verificare che gli utenti creati siano presenti nell'organizzazione Microsoft Entra nel portale di Azure o tramite PowerShell.

Verificare gli utenti

1. Accedere all'interfaccia di amministrazione di Microsoft Entra almeno come Amministratore utenti.
2. Selezionare Microsoft Entra ID.
3. Selezionare Tutti gli utenti>.
4. In Mostra selezionare Tutti gli utenti e verificare che gli utenti creati siano elencati.

Verificare gli utenti con PowerShell

Esegui questo comando:

Get-MgUser -Filter "UserType eq 'Member'"

Gli utenti creati dovrebbero essere elencati.

Limiti del servizio di importazione in blocco

È necessario tenere presente che ogni attività di operazioni bulk può essere eseguita per un massimo di un'ora.

Le operazioni in blocco nel portale di amministrazione di Microsoft Entra potrebbero verificarsi un timeout e un errore in tenant molto grandi. Questa limitazione è un problema noto dovuto alle limitazioni di ridimensionamento. Il team di progettazione Microsoft sta lavorando a un nuovo servizio che risolverà questa limitazione.The Microsoft engineering team is working on a new service that will endly address this limitation.

Un'altra soluzione alternativa per questo problema consiste nell'usare PowerShell per effettuare chiamate dirette all'API Microsoft Graph. Per gli errori di download in blocco di utenti e gruppi, è consigliabile usare i GET-MgGroup -All cmdlet di PowerShell e GET-MgUser -All.

Gli esempi di codice di PowerShell seguenti sono relativi alle operazioni bulk correlate a:

• Utenti
• Gruppi
• Dispositivi

Utenti

Scaricare in blocco tutti gli utenti

# Import the Microsoft Graph module 
Import-Module Microsoft.Graph 

# Authenticate to Microsoft Graph (you may need to provide your credentials) 
Connect-MgGraph -Scopes "User.Read.All" 

# Get all users using Get-MgUser 
$users = Get-MgUser -All -ConsistencyLevel eventual -Property Id, DisplayName, UserPrincipalName,UserType,OnPremisesSyncEnabled,CompanyName,CreationType 

# Specify the output CSV file path 
$outputCsvPath = "C:\\Users\\YourUsername\\Documents\\Users.csv"  

# Create a custom object to store user data 
$userData = @() 

# Loop through each user and collect relevant data 
foreach ($user in $users) { 
    $userObject = [PSCustomObject]@{ 
        Id = $user.Id 
        DisplayName = $user.DisplayName 
        UserPrincipalName = $user.UserPrincipalName 
        UserType = $user.UserType 
        OnPremisesSyncEnabled = $user.OnPremisesSyncEnabled 
        CompanyName = $user.CompanyName 
        CreationType = $user.CreationType 
    } 
    $userData += $userObject 
} 

# Export user data to a CSV file 
$userData | Export-Csv -Path $outputCsvPath -NoTypeInformation 

# Disconnect from Microsoft Graph 
Disconnect-MgGraph 

Write-Host "User data exported to $outputCsvPath" 

Creare utenti in blocco

# Import the Microsoft Graph module 
Import-Module Microsoft.Graph 

# Authenticate to Microsoft Graph (you may need to provide your credentials) 
Connect-MgGraph -Scopes "User.ReadWrite.All" 

# Specify the path to the CSV file containing user data 
$csvFilePath = "C:\\Path\\To\\Your\\Users.csv" 

# Read the CSV file (adjust the column names as needed) 
$usersData = Import-Csv -Path $csvFilePath 

# Loop through each row in the CSV and create users \
foreach ($userRow in $usersData) { 
    $userParams = @{ 
        DisplayName = $userRow.'Name [displayName] Required' 
        UserPrincipalName = $userRow.'User name [userPrincipalName] Required' 
        PasswordProfile = @{ 
            Password = $userRow.'Initial password [passwordProfile] Required' 
        } 
        AccountEnabled = $true 
        MailNickName = $userRow.mailNickName 
    } 
    try { 
        New-MgUser @userParams 
        Write-Host "User $($userRow.UserPrincipalName) created successfully." 
    } catch { 
        Write-Host "Error creating user $($userRow.UserPrincipalName): $($_.Exception.Message)" 
    } 
} 

# Disconnect from Microsoft Graph 
Disconnect-MgGraph 

Write-Host "Bulk user creation completed." 

Eliminare utenti in blocco

# Import the Microsoft Graph module 
Import-Module Microsoft.Graph 

# Authenticate to Microsoft Graph (you may need to provide your credentials) 
Connect-MgGraph -Scopes "User.ReadWrite.All" 

# Specify the path to the CSV file containing user data 
$csvFilePath = "C:\\Path\\To\\Your\\Users.csv" 

# Read the CSV file (adjust the column names as needed) 
$usersData = Import-Csv -Path $csvFilePath 

# Loop through each row in the CSV and delete users 
foreach ($userRow in $usersData) { 
    try { 
        Remove-MgUser -UserId $userRow.UserPrincipalName -Confirm:$false 
        Write-Host "User $($userRow.UserPrincipalName) deleted successfully." 
    } catch { 
        Write-Host "Error deleting user $($userRow.UserPrincipalName): $($_.Exception.Message)" 
    } 
} 

# Disconnect from Microsoft Graph 
Disconnect-MgGraph 

Write-Host "Bulk user deletion completed." 

Gruppi

Scaricare in blocco tutti i gruppi

Import-Module Microsoft.Graph.Groups 

 # Authenticate to Microsoft Graph (you may need to provide your credentials) 
 Connect-MgGraph -Scopes "Group.Read.All" 

 # Get the group members 
 $groups = Get-MgGroup -All | Select displayName, Id, groupTypes,mail 

 # Create a custom object to store group data 
$groupData = @() 

# Loop through each group and collect relevant data 
foreach ($group in $groups) { 
    if ($group.groupTypes -contains "Unified"){$groupType = "Microsoft 365"} 
    else {$groupType = "Security"} 
    if ($group.groupTypes -contains "DynamicMembership"){$membershipType = "Dynamic"} 
    else {$membershipType = "Assigned"} 
    $groupObject = [PSCustomObject]@{ 
        Id = $group.Id 
        DisplayName = $group.displayName 
        Mail = $group.mail 
        GroupType = $groupType 
        MemebershipType = $membershipType 
    }   
    $groupData += $groupObject 
} 

 # Specify the output CSV file path 
 $outputCsvPath = "C:\\Users\\cewu\\Documents\\Groups.csv" 

 $groupData| Export-Csv -Path $outputCsvPath -NoTypeInformation 
 
 Write-Host "Group members exported to $outputCsvPath" 

Scaricare in blocco i membri di un gruppo

Import-Module Microsoft.Graph.Groups 

 # Authenticate to Microsoft Graph (you may need to provide your credentials) 
 Connect-MgGraph -Scopes "Group.Read.All,GroupMember.Read.All" 

 # Set the group ID of the group whose members you want to download 
 $groupId = "your_group_id" 

 # Get the group members 
 $members = Get-MgGroupMember -GroupId $groupId -All | select * -ExpandProperty additionalProperties | Select-Object @( 
                'id'     
                @{  Name       = 'userPrincipalName' 
                    Expression = { $_.AdditionalProperties["userPrincipalName"] } 
                } 
                @{  Name = 'displayName' 
                Expression = { $_.AdditionalProperties["displayName"] } 
                } 
            ) 

 # Specify the output CSV file path 
 $outputCsvPath = "C:\\Users\\YourUserName\\Documents\\GroupMembers.csv" 

 $members| Export-Csv -Path $outputCsvPath -NoTypeInformation 

# Disconnect from Microsoft Graph 
Disconnect-MgGraph 

 Write-Host "Group members exported to $outputCsvPath"  

Aggiungere membri in blocco

Import-Module Microsoft.Graph.Groups 

 # Authenticate to Microsoft Graph (you may need to provide your credentials) 
 Connect-MgGraph -Scopes "GroupMember.ReadWrite.All" 

# Import the CSV file 
$members = Import-Csv -Path "C:\path\to\your\file.csv" 

# Define the Group ID 
$groupId = "your-group-id" 

# Iterate over each member and add them to the group 
foreach ($member in $members) { 
    try{ 
        New-MgGroupMember -GroupId $groupId -DirectoryObjectId $member.memberObjectId 
  	 Write-Host "Added $($member.memberObjectId) to the group."  
    } 
    Catch{ 
        Write-Host "Error adding member $($member.memberObjectId):$($_.Exception.Message)" 
    } 
} 

# Disconnect from Microsoft Graph 
Disconnect-MgGraph 

Rimuovere membri in blocco

Import-Module Microsoft.Graph.Groups 

 # Authenticate to Microsoft Graph (you may need to provide your credentials) 
 Connect-MgGraph -Scopes "GroupMember.ReadWrite.All" 

# Import the CSV file 
$members = Import-Csv -Path "C:\path\to\your\file.csv" 

# Define the Group ID 
$groupId = "your-group-id" 

# Iterate over each member and add them to the group 
foreach ($member in $members) { 
    try{ 
        Remove-MgGroupMemberByRef -GroupId $groupId -DirectoryObjectId $member.memberObjectId \
        Write-Host "Removed $($member.memberObjectId) from the group." 
    } 
    Catch{ 
        Write-Host "Error removing member $($member.memberObjectId):$($_.Exception.Message)" 
    } 
} 

# Disconnect from Microsoft Graph 
Disconnect-MgGraph 

Dispositivi

Scaricare in blocco tutti i dispositivi

Import-Module Microsoft.Graph 

 # Authenticate to Microsoft Graph (you may need to provide your credentials) 
 Connect-MgGraph -Scopes "Device.Read.All" 

 # Get all devices  
 $devices = Get-MgDevice -All |select displayName,deviceId,operatingSystem,operatingSystemVersion,isManaged,isCompliant,mdmAppId,registeredOwners,TrustType 

 # Specify the output CSV file path 
 $outputCsvPath = "C:\\Users\\YourUserName\\Documents\\Devices.csv" 

 $devices| Export-Csv -Path $outputCsvPath -NoTypeInformation 

 Write-Host "Devices exported to $outputCsvPath"  

Passaggi successivi

• Eliminare utenti in blocco
• Scaricare l'elenco degli utenti
• Ripristinare utenti in blocco