Hinzufügen von Gruppenmitgliedern zu Microsoft Entra ID per Massenvorgang

Übersicht

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. Verwenden Sie die Vorlage, die Sie für den Importvorgang für Gruppenmitglieder herunterladen. Die aktuelle Gruppenmitgliedsvorlage beginnt mit der Spaltenüberschrift, nicht mit einer version:v1.0 Zeile.

CSV-Vorlagenstruktur

Die Zeilen der heruntergeladenen CSV-Vorlage lauten wie folgt:

  • Spaltenüberschriften: Behalten Sie die vollständige heruntergeladene Spaltenüberschrift genau wie sie ist bei. Der Eigenschaftsname in eckigen Klammern ist nur ein Teil der Kopfzeile, sodass Sie die vollständige Kopfzeile nicht durch nur memberObjectIdOrUpnersetzen. Der aktuelle Importheader des Gruppenmitglieds lautet Member object ID or user principal name [memberObjectIdOrUpn] Required. Bei Änderungen an der Gruppenmitgliedschaft können Sie in den Zeilen unter dieser Überschrift entweder die Objekt-ID des Mitglieds oder den Benutzerprinzipalnamen (UPN) verwenden.
  • Beispielzeile: Wenn die Vorlage eine Zeile mit Beispielwerten enthält, z Example: 9832aad8-e4fe-496b-a604-95c6eF01ae75. B. , entfernen Sie die Beispielzeile, und ersetzen Sie sie durch Ihre eigenen Einträge.

Hinweis

Csv-Vorlagenformate variieren je nach Vorgang. Einige Vorlagen, z. B. zum massenhaften Erstellen oder Löschen von Benutzern, enthalten version:v1.0 als erste Zeile. Andere Vorlagen, z. B. Gruppenmitgliedsvorgänge, beginnen mit Spaltenüberschriften. Laden Sie die Vorlage für Ihren spezifischen Vorgang aus dem Portal herunter. Fügen Sie keine Versionszeile oder eine andere Zeile hinzu, die sich nicht in der heruntergeladenen Vorlage befindet. Behalten Sie jede Versionszeile und jede Spaltenkopfzeile unverändert bei.

Weitere Leitfäden

  • Behalten Sie jede Versionszeile und die Zeile mit den Spaltenüberschriften in der Uploadvorlage exakt wie heruntergeladen bei, anderenfalls kann der Upload nicht verarbeitet werden.
  • Die erforderlichen Spalten werden zuerst aufgelistet.
  • Es wird davon abgeraten, der Vorlage neue Spalten hinzuzufügen. Jegliche Spalten, die Sie zusätzlich hinzufügen, 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.
  • Geben Sie ein Mitglied pro Zeile ein. Verwenden Sie keine Semikolons oder andere Trennzeichen, um mehrere Elemente in einer einzelnen Zeile zu trennen.

Beispiel für eine CSV-Datei

Hier ist ein Beispiel für eine fertige CSV-Datei, die für den Upload bereit ist und dem aktuellen Importvorlagenformat des Gruppenmitglieds entspricht. In diesem Beispiel werden Benutzerprinzipalnamen (UPNs) verwendet:

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

Alternativ können Sie Objekt-IDs anstelle von UPNs verwenden:

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

Tipp

Um die Objekt-ID eines Benutzers zu finden, wechseln Sie zu Identität>Benutzer>Alle Benutzer, wählen Sie den Benutzer aus, und kopieren Sie die Objekt-ID auf der Profilseite des Benutzers.

Massenimport von Gruppenmitgliedern

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

  2. Navigieren Sie zu Identität.

    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. Geben Sie für jedes Mitglied entweder den oder die user@contoso.com (eine GUID wie ) ein. Geben Sie ein Mitglied pro Zeile ein. Speichern Sie dann die Datei.

  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 gibt eine Benachrichtigung an, dass der Sammelvorgang erfolgreich abgeschlossen wurde.

Wenn Fehler auftreten, können Sie die Ergebnisdatei auf der Seite Ergebnisse von Massenoperationen anzeigen und herunterladen. 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.

  1. Navigieren Sie zu Identität>Benutzer>Ergebnisse von Massenvorgängen.

  2. Suchen Sie den Massenvorang in der Liste. In der Spalte "Status " wird angezeigt, ob der Vorgang "In Bearbeitung", "Erfolgreich" oder "Fehlgeschlagen" ist.

    Screenshot: Option „Status überprüfen“ auf der Ergebnisseite des Massenvorgangs

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.

Herunterladen der Ergebnisdatei

So laden Sie detaillierte Ergebnisse herunter:

  1. Wählen Sie auf der Massenoperationsergebnisse-Seite den Vorgang aus, den Sie überprüfen möchten.
  2. Wählen Sie "Herunterladen " aus, um eine CSV-Datei abzurufen, die den Status jeder Zeile aus dem ursprünglichen Upload enthält.
  3. Öffnen Sie die CSV-Datei, um zu sehen, welche Elemente erfolgreich hinzugefügt wurden und welche fehlgeschlagen sind, zusammen mit bestimmten Fehlermeldungen.

Häufige Fehler sind z.B. folgende:

  • Mitglied nicht gefunden: Der UPN oder die Objekt-ID ist in Ihrem Verzeichnis nicht vorhanden.
  • Mitglied ist bereits vorhanden: Der Benutzer ist bereits Mitglied der Gruppe.
  • Ungültiges Format: Das UPN- oder Objekt-ID-Format ist falsch.

Einschränkungen des Massenimportdienstes

Hinweis

Beim Ausführen von Massenvorgängen, z. B. importieren oder erstellen, können Sie ein Problem feststellen, 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

  • Last updated on