Delen via

Groepsleden bulksgewijs toevoegen in Microsoft Entra-id

  • Artikel

U kunt meerdere leden aan een groep toevoegen met behulp van een CSV-bestand (door komma's gescheiden waarden) om groepsleden bulksgewijs te importeren in de portal voor Microsoft Entra-id.

Inzicht in de CSV-sjabloon

Download en vul de CSV-sjabloon voor bulksgewijs uploaden in om microsoft Entra-groepsleden bulksgewijs toe te voegen. Uw CSV-sjabloon kan eruitzien als in dit voorbeeld:

Schermopname van het spreadsheet voor uploaden en bijschriften waarin het doel en de waarden voor elke rij en kolom worden uitgelegd.

CSV-sjabloonstructuur

De rijen in een gedownloade CSV-sjabloon zijn:

  • Versienummer: De eerste rij die het versienummer bevat, moet worden opgenomen in het csv-uploadbestand.
  • Kolomkoppen: De indeling van de kolomkoppen is< Itemnaam> [PropertyName]< Vereist of leeg.> Een voorbeeld is Member object ID or user principal name [memberObjectIdOrUpn] Required. Sommige oudere versies van de sjabloon kunnen iets afwijken. Voor wijzigingen in het groepslidmaatschap kunt u de id van het lidobject of de principal-naam van de gebruiker kiezen.
  • Voorbeeldenrij: De sjabloon bevat een rij met voorbeelden van acceptabele waarden voor elke kolom. U moet de rij met voorbeelden verwijderen en vervangen door uw eigen invoerwaarden.

Meer richtlijnen

  • De eerste twee rijen van de uploadsjabloon mogen niet worden verwijderd of gewijzigd of het uploaden kan niet worden verwerkt.
  • De vereiste kolommen worden het eerst weergegeven.
  • Het is niet raadzaam om nieuwe kolommen aan de sjabloon toe te voegen. Alle andere kolommen die u toevoegt, worden genegeerd en worden niet verwerkt.
  • U wordt aangeraden altijd de meest recente versie van de CSV-sjabloon te downloaden.
  • Voeg ten minste twee UPN's of object-id's van gebruikers toe om het bestand te uploaden.

Groepsleden bulksgewijs importeren

Tip

Stappen in dit artikel kunnen enigszins variëren op basis van de portal waaruit u begint.

  1. Meld u als groepsbeheerder aan bij het Microsoft Entra-beheercentrum.

  2. Selecteer Microsoft Entra ID.

    Notitie

    Groepseigenaren kunnen leden uit groepen waarvan ze eigenaar zijn ook bulksgewijs importeren.

  3. Selecteer Groepen>Alle groepen.

  4. Open de groep waaraan u leden toevoegt en selecteer vervolgens Leden.

  5. Selecteer op de pagina Leden bulkbewerkingen en kies Leden importeren.

  6. Selecteer op de pagina Groepsleden bulksgewijs importeren de optie Downloaden om de CSV-bestandssjabloon met vereiste eigenschappen van groepsleden te downloaden.

    Schermopname van de opdracht Leden importeren op de profielpagina voor de groep.

  7. Open het CSV-bestand en voeg een regel toe voor elk groepslid dat u in de groep wilt importeren. Vereiste waarden zijn lidobject-id of user principal name. Sla het bestand op.

    Schermopname van het CSV-bestand met namen en id's van de leden die moeten worden geïmporteerd.

  8. Blader op de pagina Groepsleden bulksgewijs importeren onder CSV-bestand uploaden naar het bestand. Wanneer u het bestand selecteert, wordt de validatie van het CSV-bestand gestart.

  9. Wanneer de bestandsinhoud is gevalideerd, wordt op de pagina voor bulkimport Het bestand is geüpload weergegeven. Als er fouten zijn, moet u deze corrigeren voordat u de taak kunt verzenden.

  10. Wanneer het bestand is gevalideerd, selecteert u Verzenden om de bulkbewerking te starten waarmee de groepsleden naar de groep worden geïmporteerd.

  11. Wanneer de importbewerking is voltooid, wordt in een melding aangegeven dat de bulkbewerking is geslaagd.

Als er fouten optreden, kunt u het resultatenbestand downloaden en weergeven op de pagina met resultaten van bulkbewerkingen. Het bestand bevat de reden voor elke fout. De bestandsverzending moet met de opgegeven sjabloon overeenkomen en de exacte kolomnamen bevatten. Zie Servicelimieten voor bulkimport voor meer informatie over beperkingen voor bulkbewerkingen.

Importstatus controleren

U kunt de status van al uw in behandeling zijnde bulkaanvragen bekijken op de pagina met resultaten van bulkbewerkingen.

Schermopname van de optie Status controleren op de pagina Resultaten van bulkbewerking.

Selecteer de waarden onder de kolommen Aantal geslaagd, Aantal mislukt of Totaal aantal aanvragen voor details over elk regelitem in de bulkbewerking. Als er fouten zijn opgetreden, worden de oorzaken van de fout vermeld.

Servicelimieten voor bulkimport

Notitie

Bij het uitvoeren van bulkbewerkingen, zoals importeren of maken, kan er een probleem optreden als de bulkbewerking niet binnen het uur wordt voltooid. U kunt dit probleem omzeilen door het aantal records dat per batch is verwerkt, te splitsen. Voordat u bijvoorbeeld een export start, kunt u de resultatenset beperken door te filteren op een groepstype of gebruikersnaam om de grootte van de resultaten te verkleinen. Door uw filters te verfijnen, beperkt u in wezen de gegevens die worden geretourneerd door de bulkbewerking. Zie Beperkingen voor bulkbewerkingen voor de service voor meer informatie.

Volgende stappen