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 herunterladenWas 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-Spalte | Active Directory-Attribut |
|---|---|
username | sAMAccountName (Anmeldename) |
first_name | givenName |
last_name | sn (Nachname) |
email | mail |
position | title (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.
- Ein Windows-Computer, der Mitglied der Domäne ist.
- Das Active Directory-Modul für PowerShell. Jeder Domänencontroller hat es. Auf anderen Computern installieren Sie RSAT: Active Directory Domain Services and Lightweight Directory Services Tools.
- Ein Konto, das Benutzerobjekte im Active Directory lesen kann. Das kann jeder Domänenbenutzer.
1. Benutzer exportieren
- Laden Sie das Skript
ad_users_export.ps1über die Schaltfläche oben herunter. - Öffnen Sie PowerShell in dem Ordner, in dem Sie das Skript gespeichert haben.
- Führen Sie den Export für die gesamte Domäne aus:
.\ad_users_export.ps1- 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"- Das Skript erstellt die Datei
ad_users_export.csvim selben Ordner und zeigt an, wie viele Benutzer es exportiert hat.
Skriptparameter
| Parameter | Beschreibung | Erforderlich | Beispiel |
|---|---|---|---|
| -SearchBase | Exportiert nur die Benutzer aus dieser OU und ihren Unter-OUs. Ohne diesen Parameter exportiert das Skript die gesamte Domäne. | Nein | OU=Employees,DC=company,DC=local |
| -Path | Der Name oder Pfad der CSV-Ausgabedatei. | Nein | C:\Temp\users.csv |
Pfad einer OU ermitteln
- Öffnen Sie
Active Directory Users and Computers, klicken Sie aufViewund aktivieren SieAdvanced Features. - Öffnen Sie die Eigenschaften der OU und wechseln Sie zur Registerkarte
Attribute Editor. - 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
- 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.)
- Gehen Sie zu
Benutzer, klicken Sie auf die SchaltflächeBenutzer importierenund wählen Sie die Option.CSV. - Laden Sie die Datei
ad_users_export.csvhoch. Redamp.io liest die Spaltennamen aus der ersten Zeile und legt die Spaltentypen automatisch fest. Prüfen Sie diese im SchrittDatentypen auf Spalten einstellen. - 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.ps1Wenn 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 BypassDas 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.