Ajouter en bloc des membres de groupe dans Microsoft Entra ID

Aperçu

Vous pouvez ajouter plusieurs membres à un groupe en utilisant un fichier de valeurs séparées par des virgules (CSV) pour importer en bloc des membres de groupe dans le portail de Microsoft Entra ID.

Comprendre le modèle CSV

Téléchargez et renseignez le modèle CSV de chargement en bloc pour ajouter des membres du groupe Microsoft Entra en bloc. Utilisez le modèle que vous téléchargez pour l’opération d’importation des membres du groupe. Le modèle de membre de groupe actuel commence par l’en-tête de colonne, et non par une version:v1.0 ligne.

Structure du modèle CSV

Les lignes d’un modèle CSV téléchargé sont les suivantes :

  • En-têtes de colonne : Conservez l’intégralité de l’en-tête de colonne téléchargé exactement tel quel. Le nom de propriété entre crochets n’est qu’une partie de l’en-tête. Ne remplacez donc pas l’en-tête complet par uniquement memberObjectIdOrUpn. L’en-tête actuel de l’importation des membres du groupe est Member object ID or user principal name [memberObjectIdOrUpn] Required. Pour les modifications d’appartenance au groupe, vous pouvez utiliser l’ID d’objet membre ou le nom d’utilisateur principal (UPN) dans les lignes sous cet en-tête.
  • Lignes d’exemples : si le modèle inclut une ligne d’exemples de valeurs, par Example: 9832aad8-e4fe-496b-a604-95c6eF01ae75exemple, supprimez la ligne d’exemples et remplacez-la par vos propres entrées.

Remarque

Les formats de modèle CSV varient selon l’opération. Certains modèles, tels que la création en bloc ou la suppression d’utilisateurs, incluent version:v1.0 comme première ligne. D’autres modèles, tels que les opérations de membre de groupe, commencent par les en-têtes de colonne. Téléchargez le modèle pour votre opération spécifique à partir du portail. N’ajoutez pas de ligne de version ou toute autre ligne qui n’est pas dans le modèle téléchargé. Conservez toute ligne de version et toute ligne d’en-tête de colonne inchangées.

Autres conseils

  • Conservez intactes la ligne de version et la ligne d’en-tête des colonnes dans le modèle d’importation exactement telles qu’elles ont été téléchargées, sinon l’importation ne pourra pas être traitée.
  • Les colonnes obligatoires sont listées en premier.
  • Nous vous déconseillons d’ajouter des colonnes au modèle. Les colonnes que vous ajouterez seront ignorées et ne seront pas traitées.
  • Nous vous recommandons de télécharger la version la plus récente du modèle CSV aussi souvent que possible.
  • Ajoutez au moins deux UPN ou ID d’objet pour télécharger le fichier avec succès.
  • Entrez un membre par ligne. N’utilisez pas de points-virgules ou d’autres délimiteurs pour séparer plusieurs membres d’une seule ligne.

Exemple de fichier CSV

Voici un exemple de fichier CSV terminé prêt pour le chargement, correspondant au format de modèle d’importation de membre de groupe actuel. Cet exemple utilise des noms d’utilisateur principaux (UPN) :

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

Vous pouvez également utiliser des ID d’objet plutôt que des 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

Conseil / Astuce

Pour rechercher l’ID d’objet d’un utilisateur, accédez à Identité>Utilisateurs>Tous les utilisateurs, sélectionnez l'utilisateur et copiez l'ID d'objet à partir de la page de profil de l'utilisateur.

Importer en bloc les membres du groupe

  1. Connectez-vous au centre d'administration Microsoft Entra en tant qu'administrateur de groupes au moins.

  2. Accédez à Identité.

    Remarque

    Les propriétaires de groupes peuvent également importer en bloc les membres de groupes qu'ils possèdent.

  3. Sélectionnez Groupes>Tous les groupes.

  4. Ouvrez le groupe auquel vous ajoutez des membres, puis sélectionnez Membres.

  5. Dans la page Membres , sélectionnez Opérations en bloc , puis importez des membres.

  6. Dans la page Importer en bloc les membres du groupe, sélectionnez Télécharger pour obtenir le modèle de fichier CSV avec les propriétés des membres du groupe requises.

    Capture d’écran montrant la commande Importer des membres dans la page de profil du groupe.

  7. Ouvrez le fichier CSV et ajoutez une ligne pour chaque membre de groupe que vous souhaitez importer dans le groupe. Pour chaque membre, entrez son nom d’utilisateur principal (UPN, par exemple user@contoso.com) ou son ID d’objet (guid tel que aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb). Entrez un membre par ligne. Puis enregistrez le fichier.

  8. Dans la page Importer en bloc les membres du groupe, sous Chargez votre fichier .csv, accédez au fichier. Quand vous sélectionnez le fichier, la validation du fichier CSV démarre.

  9. Quand le contenu du fichier est validé, la page d’importation en bloc affiche Fichier chargé. Si des erreurs sont présentes, vous devez les corriger avant de pouvoir envoyer le travail.

  10. Une fois votre fichier validé, sélectionnez Envoyer pour démarrer l’opération en bloc qui importe les membres du groupe dans le groupe.

  11. Une fois l’opération d’importation terminée, une notification indique que l’opération en bloc a réussi.

Si vous rencontrez des erreurs, vous pouvez télécharger et consulter le fichier de résultats dans la page Résultats de l’opération en bloc. Le fichier contient la raison de chaque erreur. L’envoi du fichier doit correspondre au modèle fourni et inclure les noms de colonnes exacts.

Pour plus d’informations sur les limitations des opérations en bloc, consultez Limites du service d’importation en bloc.

Vérifier l'état de l'importation

Vous pouvez voir l’état de toutes vos demandes en bloc en attente dans la page de résultats de l’opération en bloc .

  1. Accédez à Identité>Utilisateurs>Résultats des opérations en bloc.

  2. Recherchez votre opération en bloc dans la liste. La colonne État indique si l’opération est en cours, réussie ou ayant échoué.

    Capture d’écran montrant l’option Vérifier l’état dans la page des résultats de l’opération en bloc.

Pour plus d’informations sur chaque élément de ligne au sein de l’opération en bloc, sélectionnez les valeurs sous les colonnes Nombre de réussites, Nombre d’échecs ou Nombre total de requêtes. Si des défaillances se sont produites, les raisons sont affichées.

Télécharger le fichier de résultats

Pour télécharger des résultats détaillés :

  1. Dans la page des résultats de l’opération en bloc , sélectionnez l’opération que vous souhaitez examiner.
  2. Sélectionnez Télécharger pour obtenir un fichier CSV contenant l’état de chaque ligne à partir de votre chargement d’origine.
  3. Ouvrez le fichier CSV pour voir quels membres ont été ajoutés correctement et qui ont échoué, ainsi que des messages d’erreur spécifiques.

Les erreurs courantes sont les suivantes :

  • Membre introuvable : l’UPN ou l’ID d’objet n’existe pas dans votre répertoire.
  • Membre existe déjà : l’utilisateur est déjà membre du groupe.
  • Format non valide : le format UPN ou ID d’objet est incorrect.

Limites du service d’importation en bloc

Remarque

Lorsque vous effectuez des opérations en bloc, telles que l’importation ou la création, vous pouvez rencontrer un problème si l’opération en bloc ne se termine pas dans l’heure. Pour contourner ce problème, nous vous recommandons de fractionner le nombre d’enregistrements traités par lot. Par exemple, avant de commencer une exportation, vous pouvez limiter le jeu de résultats en filtrant par type de groupe ou nom d’utilisateur pour réduire la taille des résultats. En affinant vos filtres, vous limitez essentiellement les données retournées par l’opération en bloc. Pour plus d’informations, veuillez consulter Limitations du service des opérations en masse.

Étapes suivantes