Export von Benutzern aus Active Directory

Erfahren Sie, wie Sie Benutzer aus Ihrem lokalen Active Directory mit einem PowerShell-Skript in eine CSV-Datei exportieren und gesammelt in Redamp.io importieren.

Verwalten Sie Ihre Benutzer in einem lokalen (On-Premise) Active Directory? Dann müssen Sie sie nicht einzeln in Redamp.io eingeben. Unser PowerShell-Skript exportiert sie in eine CSV-Datei, und Sie importieren diese Datei in die Redamp.io-Konsole.

ad_users_export.ps1 herunterladen

Was das Skript exportiert

Das Skript exportiert jedes aktivierte Benutzerkonto, das eine E-Mail-Adresse hat. Deaktivierte Konten und Konten ohne E-Mail-Adresse überspringt es.

CSV-SpalteActive Directory-Attribut
usernamesAMAccountName (Anmeldename)
first_namegivenName
last_namesn (Nachname)
emailmail
positiontitle (Stellenbezeichnung)

Redamp.io weist allen importierten Benutzern die Rolle User zu. Sie können die Rolle jedes Benutzers ändern, bevor Sie den Import abschließen.

Voraussetzungen

Wir empfehlen, das Skript direkt auf Ihrem Active Directory-Server (Domänencontroller) auszuführen. Dort ist bereits alles vorhanden, was das Skript braucht. Sie müssen also nichts installieren.

1. Benutzer exportieren

  1. Laden Sie das Skript ad_users_export.ps1 über die Schaltfläche oben herunter.
  2. Öffnen Sie PowerShell in dem Ordner, in dem Sie das Skript gespeichert haben.
  3. Führen Sie den Export für die gesamte Domäne aus:
.\ad_users_export.ps1
  1. Oder exportieren Sie nur eine Organisationseinheit (OU) und die OUs darin. Das ist zum Beispiel sinnvoll, wenn Ihre Dienstkonten in einer anderen OU liegen:
.\ad_users_export.ps1 -SearchBase "OU=Employees,DC=company,DC=local"
  1. Das Skript erstellt die Datei ad_users_export.csv im selben Ordner und zeigt an, wie viele Benutzer es exportiert hat.

Skriptparameter

ParameterBeschreibungErforderlichBeispiel
-SearchBaseExportiert nur die Benutzer aus dieser OU und ihren Unter-OUs. Ohne diesen Parameter exportiert das Skript die gesamte Domäne.NeinOU=Employees,DC=company,DC=local
-PathDer Name oder Pfad der CSV-Ausgabedatei.NeinC:\Temp\users.csv

Pfad einer OU ermitteln

  1. Öffnen Sie Active Directory Users and Computers, klicken Sie auf View und aktivieren Sie Advanced Features.
  2. Öffnen Sie die Eigenschaften der OU und wechseln Sie zur Registerkarte Attribute Editor.
  3. Kopieren Sie den Wert des Attributs distinguishedName. Das ist der Wert für -SearchBase.

2. CSV-Datei prüfen

Öffnen Sie ad_users_export.csv und sehen Sie die Zeilen durch. Löschen Sie die Zeilen von Dienstkonten, freigegebenen Postfächern und anderen Konten, die Sie nicht importieren möchten.

Die Datei ist UTF-8-codiert. Namen mit Umlauten und anderen diakritischen Zeichen bleiben daher korrekt.

3. Datei in Redamp.io importieren

  1. Melden Sie sich als Administrator bei Redamp.io an. (Wenn Sie Partner sind, klicken Sie zuerst auf einen bestimmten Kunden, um dessen Dashboard zu öffnen.)
  2. Gehen Sie zu Benutzer, klicken Sie auf die Schaltfläche Benutzer importieren und wählen Sie die Option .CSV.
  3. Laden Sie die Datei ad_users_export.csv hoch. Redamp.io liest die Spaltennamen aus der ersten Zeile und legt die Spaltentypen automatisch fest. Prüfen Sie diese im Schritt Datentypen auf Spalten einstellen.
  4. Klicken Sie auf Überprüfung Import, prüfen Sie die Benutzer und schließen Sie den Import ab.

Redamp.io kann jedem importierten Benutzer eine Einladung per E-Mail senden. Damit legt der Benutzer ein Passwort fest und koppelt seine Geräte. Alle Schritte des Imports finden Sie unter Benutzer importieren .

Fehlerbehebung

Windows blockiert das Skript

Windows kann ein Skript blockieren, das Sie aus dem Internet heruntergeladen haben. Heben Sie die Blockierung einmal auf und führen Sie das Skript dann erneut aus:

Unblock-File .\ad_users_export.ps1

Wenn die Ausführungsrichtlinie das Skript weiterhin blockiert, erlauben Sie Skripte nur für dieses PowerShell-Fenster. Führen Sie das Skript dann erneut aus:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

Das ActiveDirectory-Modul fehlt

Der Fehler The specified module 'ActiveDirectory' was not loaded bedeutet, dass auf dem Computer das Active Directory-Modul fehlt. Führen Sie das Skript auf einem Domänencontroller aus, oder installieren Sie RSAT wie unter Voraussetzungen  beschrieben.

Keine Benutzer gefunden

Das Skript zeigt No enabled users with an e-mail address were found. an, wenn kein aktivierter Benutzer in der Domäne oder OU das Attribut mail hat. Prüfen Sie den Wert von -SearchBase. Prüfen Sie auch, ob Ihre Benutzer im Feld E-mail ihrer Eigenschaften eine E-Mail-Adresse haben.