Freigeben über

Hinzufügen von Gruppenmitgliedern zu Microsoft Entra ID per Massenvorgang

  • Artikel

Sie können einer Gruppe mehrere Mitglieder hinzufügen, indem Sie eine Datei mit durch Trennzeichen getrennten Werten (CSV) verwenden, um damit den Massenimport von Gruppenmitgliedern im Portal für Microsoft Entra ID, einem Teil von Microsoft Entra, durchzuführen.

Grundlegendes zur CSV-Vorlage

Laden Sie die CSV-Vorlage für den Massenupload herunter, und füllen Sie sie aus, um Microsoft Entra-Gruppenmitglieder in einem einzigen Vorgang hinzuzufügen. Ihre CSV-Vorlage ähnelt etwa dem folgenden Beispiel:

Screenshot, der das hochzuladende Arbeitsblatts und Call-Outs zur Erläuterung des Zwecks und der Werte für jede Zeile und Spalte anzeigt.

CSV-Vorlagenstruktur

Die Zeilen der heruntergeladenen CSV-Vorlage lauten wie folgt:

  • Versionsnummer: Die erste Zeile, die die Versionsnummer enthält, muss in der hochzuladenden CSV-Datei enthalten sein.
  • Spaltenüberschriften: Das Format der Spaltenüberschriften lautet <Elementname> [Eigenschaftenname] <Required (erforderlich) oder leer>. z. B. Member object ID or user principal name [memberObjectIdOrUpn] Required. Einige ältere Versionen der Vorlage können geringfügige Abweichungen aufweisen. Bei Änderungen an der Gruppenmitgliedschaft können Sie die Elementobjekt-ID oder den Benutzerprinzipalnamen auswählen.
  • Beispielzeile: In der Vorlage ist eine Zeile mit Beispielen für zulässige Werte für alle Spalten enthalten. Sie müssen die Beispielzeile entfernen und durch Ihre eigenen Einträge ersetzen.

Weitere Leitfäden

  • Die ersten zwei Zeilen der hochzuladenden Vorlage dürfen nicht entfernt oder geändert werden, da der Upload sonst nicht verarbeitet werden kann.
  • Die erforderlichen Spalten werden zuerst aufgelistet.
  • Es wird davon abgeraten, der Vorlage neue Spalten hinzuzufügen. Alle anderen von Ihnen hinzugefügten Spalten werden ignoriert und nicht verarbeitet.
  • Es wird empfohlen, möglichst häufig die neueste Version der CSV-Vorlage herunterzuladen.
  • Fügen Sie mindestens die UPNs oder Objekt-IDs von zwei Benutzern hinzu, um die Datei erfolgreich hochzuladen.

Massenimport von Gruppenmitgliedern ausführen

Tipp

Die Schritte in diesem Artikel können je nach dem Portal, mit dem Sie beginnen, geringfügig variieren.

  1. Melden Sie sich beim Microsoft Entra Admin Center mindestens als Gruppenadministrator an.

  2. Wählen Sie Microsoft Entra ID aus.

    Hinweis

    Gruppenbesitzer können Mitglieder von Gruppen, die ihnen gehören, ebenfalls in einem Massenvorgang importieren.

  3. Wählen Sie Gruppen>Alle Gruppen aus.

  4. Öffnen Sie die Gruppe, der Sie Mitglieder hinzufügen möchten, und wählen Sie Mitglieder aus.

  5. Wählen Sie auf der Seite Mitglieder die Option Massenvorgänge und dann Mitglieder importieren aus.

  6. Wählen Sie auf der Seite Massenimport von Gruppenmitgliedern die Option Herunterladen aus, um die CSV-Dateivorlage mit den erforderlichen Gruppenmitgliedseigenschaften zu erhalten.

    Screenshot, der zeigt, dass sich der Befehl „Mitglieder importieren“ auf der Profilseite für die Gruppe befindet.

  7. Öffnen Sie die CSV-Datei, und fügen Sie für jedes Gruppenmitglied, das Sie in die Gruppe importieren möchten, eine Zeile hinzu. Erforderliche Werte sind entweder Member-Objekt-ID oder Benutzerprinzipalname. Speichern Sie dann die Datei.

    Screenshot, der zeigt, dass die CSV-Datei Namen und IDs der zu importierenden Mitglieder enthält.

  8. Navigieren Sie auf der Seite Massenimport von Gruppenmitgliedern unter CSV-Datei hochladen zur entsprechenden Datei. Wenn Sie die Datei auswählen, wird mit der Überprüfung der CSV-Datei begonnen.

  9. Nach der Überprüfung des Dateiinhalts wird auf der Seite für den Massenimport die Meldung Datei erfolgreich hochgeladen angezeigt. Wenn Fehler vorliegen, müssen Sie diese beheben, bevor Sie den Auftrag übermitteln können.

  10. Wenn die Datei die Überprüfung bestanden hat, wählen Sie Senden aus, um den Massenvorgang zu starten, der die Gruppenmitglieder in die Gruppe importiert.

  11. Nach Abschluss des Importvorgangs wird eine Benachrichtigung angezeigt, dass der Massenvorgang erfolgreich abgeschlossen wurde.

Wenn Fehler auftreten, können Sie die Ergebnisdatei auf der Seite Ergebnisse von Massenvorgängen herunterladen und anzeigen. Die Datei enthält den Grund für die einzelnen Fehler. Die Dateiübermittlung muss mit der angegebenen Vorlage übereinstimmen und die genauen Spaltennamen enthalten. Weitere Informationen zu Einschränkungen für Massenvorgänge finden Sie unter Diensteinschränkungen beim Massenimport.

Überprüfen des Importstatus

Sie können den Status aller Ihrer ausstehenden Massenanforderungen auf der Seite Ergebnisse von Massenvorgängen anzeigen.

Screenshot, der die Option „Status überprüfen“ auf der Ergebnisseite des Massenvorgangs anzeigt.

Wenn Sie ausführliche Informationen zu jedem Zeilenelement des Massenvorgangs erhalten möchten, markieren Sie die Werte unter der Spalte # Erfolg, # Fehler oder Anforderungen insgesamt. Wenn Fehler aufgetreten sind, werden die Fehlerursachen aufgeführt.

Diensteinschränkungen beim Massenimport

Hinweis

Beim Ausführen von Massenvorgängen, z. B. Importieren oder Erstellen, tritt möglicherweise ein Problem auf, wenn der Massenvorgang nicht innerhalb der Stunde abgeschlossen ist. Um dieses Problem zu umgehen, empfehlen wir, die Anzahl der pro Batch verarbeiteten Datensätze aufzuteilen. Vor dem Starten eines Exports können Sie z. B. das Resultset einschränken, indem Sie nach einem Gruppentyp oder Benutzernamen filtern, um die Größe der Ergebnisse zu verringern. Indem Sie Ihre Filter verfeinern, beschränken Sie im Wesentlichen die vom Massenvorgang zurückgegebenen Daten. Weitere Informationen finden Sie unter Einschränkungen des Massenvorgangsdiensts.

Nächste Schritte