Aggiungere in blocco i membri del gruppo in Microsoft Entra ID

Informazioni generali

È possibile aggiungere più membri a un gruppo usando un file con valori delimitati da virgole (CSV) per importare in blocco i membri del gruppo nel portale per Microsoft Entra ID.

Informazioni sul modello CSV

Scaricare e compilare il modello CSV di caricamento bulk per aggiungere correttamente i membri del gruppo Microsoft Entra in blocco. Usare il modello scaricato per l'operazione di importazione dei membri del gruppo. Il modello membro del gruppo corrente inizia con l'intestazione di colonna, non con una version:v1.0 riga.

Struttura del modello CSV

Le righe in un modello CSV scaricato sono:

  • Intestazioni di colonna: mantieni l'intestazione completa della colonna scaricata esattamente com'è. Il nome della proprietà tra parentesi quadre è solo una parte dell'intestazione, quindi non sostituire l'intestazione completa con solo memberObjectIdOrUpn. L'intestazione corrente per l'importazione dei membri del gruppo è Member object ID or user principal name [memberObjectIdOrUpn] Required. Per le modifiche all'appartenenza a un gruppo, è possibile usare l'ID oggetto del membro o il nome principale utente (UPN) nelle righe sotto questa intestazione.
  • Riga di esempi: se il modello include una riga di valori di esempio, ad esempio Example: 9832aad8-e4fe-496b-a604-95c6eF01ae75, rimuovere la riga degli esempi e sostituirla con le proprie voci.

Nota

I formati di modello CSV variano in base all'operazione. Alcuni modelli, come la creazione in blocco o l'eliminazione degli utenti, includono version:v1.0 come prima riga. Altri modelli, ad esempio le operazioni dei membri del gruppo, iniziano con le intestazioni di colonna. Scaricare il modello per l'operazione specifica dal portale. Non aggiungere una riga di versione o qualsiasi altra riga non presente nel modello scaricato. Mantieni invariata qualsiasi riga della versione e la riga di intestazione delle colonne.

Ulteriori indicazioni

  • Mantenete qualsiasi riga della versione e riga di intestazione delle colonne nel modello di caricamento esattamente come è stato scaricato, altrimenti il caricamento non potrà 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.
  • Aggiungere almeno due UPN o ID oggetto degli utenti per caricare correttamente il file.
  • Immettere un membro per riga. Non usare punti e virgola o altri delimitatori per separare più membri in una singola riga.

File CSV di esempio

Di seguito è riportato un esempio di file CSV completato pronto per il caricamento, corrispondente al formato del modello di importazione del membro del gruppo corrente. In questo esempio vengono usati nomi dell'entità utente (UPN):

Member object ID or user principal name [memberObjectIdOrUpn] Required
alain@contoso.com
isabella@contoso.com
joseph@contoso.com
chaya@contoso.com

In alternativa, è possibile usare gli ID oggetto anziché gli UPN:

Member object ID or user principal name [memberObjectIdOrUpn] Required
00aa00aa-bb11-cc22-dd33-44ee44ee44ee
11bb11bb-cc22-dd33-ee44-55ff55ff55ff
22cc22cc-dd33-ee44-ff55-66aa66aa66aa

Suggerimento

Per trovare l'ID oggetto di un utente, passare a Identità>Utenti>tutti gli utenti, selezionare l'utente e copiare l'ID oggetto dalla pagina del profilo dell'utente.

Importare in blocco i membri del gruppo

  1. Accedere all’interfaccia di amministrazione di Microsoft Entra almeno con il ruolo diAmministratore di gruppi.

  2. Passare a Identità.

    Nota

    I proprietari del gruppo possono anche importare in blocco i membri dei gruppi di cui sono proprietari.

  3. Selezionare Gruppi>Tutti i gruppi.

  4. Aprire il gruppo a cui devono essere aggiunti i membri e quindi selezionare Membri.

  5. Nella pagina Membri, selezionare le Operazioni collettive e quindi, scegliere l'opzione Importa membri.

  6. Nella pagina Importa in blocco i membri del gruppo selezionare Scarica per scaricare il modello di file CSV con le proprietà obbligatorie per i membri del gruppo.

    Schermata che mostra il comando Importa membri nella pagina del profilo per il gruppo.

  7. Aprire il file CSV e aggiungere una riga per ogni membro del gruppo da importare nel gruppo. Per ogni membro, immettere il User principal name dell'utente (UPN, ad esempio user@contoso.com) o il relativo ID oggetto (un GUID come aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb). Immettere un membro per riga. Salvare quindi il file.

  8. Nella pagina Importa in blocco i membri del gruppo, sotto Carica il file CSV, navigare fino al file. Quando si seleziona il file, viene avviata la convalida del file CSV.

  9. Dopo la convalida del contenuto del file, nella pagina di importazione in blocco viene visualizzato il messaggio Il file è stato caricato. Se sono presenti errori, è necessario correggerli prima di poter inviare il lavoro.

  10. Quando il file supera la convalida, selezionare Invia per avviare l'operazione in blocco che importa i membri del gruppo nel gruppo.

  11. Al termine dell'operazione di importazione, una notifica indica che l'operazione bulk è riuscita.

Se si verificano degli errori, è possibile scaricare e visualizzare il file dei risultati nella pagina dei risultati delle operazioni 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.

Controllare lo stato dell'importazione

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

  1. Passare a Identità>Utenti>Risultati dell'operazione in blocco.

  2. Trova l'operazione di massa nell'elenco. La colonna Stato indica se l'operazione è In corso, Operazione riuscita o Non riuscita.

    Screenshot che mostra l'opzione Controlla stato nella pagina Risultati dell'operazione in blocco.

Per informazioni dettagliate su ogni voce all'interno dell'operazione in blocco, selezionare i valori nelle colonne N. operazioni riuscite, N. errori o Richieste totali. Se si verificano errori, verranno elencati i motivi dell'errore.

Scaricare il file dei risultati

Per scaricare i risultati dettagliati:

  1. Nella pagina Risultati dell'operazione bulk selezionare l'operazione da esaminare.
  2. Selezionare Scarica per ottenere un file CSV contenente lo stato di ogni riga dal caricamento originale.
  3. Aprire il file CSV per vedere quali membri sono stati aggiunti correttamente e quali non sono riusciti, insieme a messaggi di errore specifici.

Di seguito sono riportati gli errori più comuni.

  • Membro non trovato: l'UPN o l'ID oggetto non esiste nella directory.
  • Membro già esistente: l'utente è già membro del gruppo.
  • Formato non valido: il formato UPN o ID oggetto non è corretto.

Limiti del servizio di importazione in blocco

Nota

Quando si eseguono operazioni bulk, ad esempio l'importazione o la creazione, è possibile riscontrare un problema se l'operazione bulk non viene completata entro l'ora. Per risolvere questo problema, è consigliabile suddividere il numero di record elaborati per batch. Ad esempio, prima di avviare un'esportazione, è possibile limitare il set di risultati filtrando in base a un tipo di gruppo o a un nome utente per ridurre le dimensioni dei risultati. Perfezionando i filtri, essenzialmente si limitano i dati restituiti dall'operazione in massa. Per altre informazioni, vedere Limitazioni del servizio delle operazioni in blocco.

Passaggi successivi

  • Last updated on