re:ADM macht sich bereits nach einem Jahr bezahlt. Bestellen Sie bis zum 18. Dezember und erhalten Sie 20 % Rabatt www.identum.no/re-adm

Active Directory: So exportieren Sie benutzerdefinierte Schemaattribute

Übersicht

Export AD kennt bereits eine feste Liste von Active Directory-Attributen (samAccountName, department, extensionAttribute1, und so weiter). Die Benutzerdefinierte Attribute Der Parameter fügt dieser Liste weitere Namen hinzu, sodass Sie diese einer Exportvorlage zuordnen können.

Der Parameter schreibt von sich aus nichts. Nachdem Sie ihn gespeichert haben, fügen Sie in der Vorlage für den Schritt „Export AD“ eine Zuordnungszeile hinzu. eADM erstellt keine Attribute im Verzeichnis. Der Name muss bereits im Active Directory-Schema vorhanden sein, und zwar für das Objekt, in das Sie schreiben (Benutzer, Gruppe oder Organisationseinheit).

Dieser Parameter ist in jedem lokalen „Export AD “-Schritt enthalten (Export AD, Export AD 2 und weitere „Export AD“-Schritte). Er ist nicht in „Export Azure / Entra“ enthalten. Jeder „Export AD“-Schritt verfügt über eine eigene Liste.

Der Parameter ist seit Februar 2026 verfügbar.

Artikel

Details

Wo

Synchronisierungszyklus → Schritt „AD exportieren“ → Benutzerdefinierte Attribute

Format

ldapDisplayName=Type, mehrere durch Kommas getrennte Paare

Typen, die schreiben

String, Multivalue, Bool, Int

Was du noch tust

Fügen Sie das Attribut in die Exportvorlage ein und ordnen Sie ihm einen Ausdruck zu


Wo kann man das konfigurieren?

  1. Öffnen Sie den Synchronisationszyklus und wählen Sie den Schritt „AD exportieren“ aus, der das Attribut schreiben soll.

  2. Set Benutzerdefinierte Attribute. Setze keine Leerzeichen um = oder ,.

  3. Öffnen Sie die Exportvorlage für denselben Schritt und denselben Objekttyp (Benutzer, Gruppe oder Organisationseinheit).

  4. Fügen Sie eine Zuordnungszeile hinzu. Der neue Name befindet sich in der Liste der Zielattribute. Der Ausdruck entspricht dem Wert, den eADM übermittelt.

  5. Speichern Sie die Vorlage. Der Typ in der Zuordnungszeile wird beim Speichern aus der Liste übernommen. Wenn Sie den Typ später unter „Benutzerdefinierte Attribute“ ändern, öffnen Sie die Vorlage und speichern Sie sie erneut.

Verwenden Sie den LDAP-Anzeigenamen, also denselben Namen, der in ADSI Edit angezeigt wird. middleName ist richtig. Middle-Name ist der Name des Schemaobjekts und ist es nicht.

Ein zweiter Wald nutzt das Feld „Benutzerdefinierte Attribute “ in „Export AD 2“ (oder „Export AD 3“ usw.). Er übernimmt die Liste nicht aus „Export AD“.


Wie ein Wert geschrieben wird

Der Typ ist das Wort nach =. Diese vier Typen sollten verwendet werden:

Typ

Schreibverhalten

String

Ein Wert. Ein leeres Ergebnis löscht das Attribut.

Multivalue

Der Ausdruck wird aufgeteilt in |. eADM löscht das Attribut und fügt anschließend jeden nicht leeren Teil hinzu. Ein leeres Ergebnis löscht das Attribut.

Bool

Nur True oder False. 1 und 0 werden abgelehnt.

Int

Eine ganze Zahl. Ein leeres Ergebnis ist ein Fehler, kein „clear“.

Der Typ muss genau so geschrieben werden. string oder MultiValue stimmt nicht überein, und eADM überspringt daraufhin den Schreibvorgang. Das Client-Protokoll enthält für dieses Attribut keine Zeile vom Typ „Setting … to value“.

Reference, Mail, Powershell, und RDN sind für bereits integrierte Attribute reserviert. Verwenden Sie sie nicht in Benutzerdefinierte Attribute.

Die Zeichenlängen werden von Active Directory und nicht von eADM vorgegeben. Siehe „Active Directory: Zeichenbegrenzungen für Attribute“.


Zeichenkette

Ein Textwert.

Standardattribut, das nicht in der Vorlage enthalten ist: profilePath. Dies ist der Pfad zum Roaming-Profil eines Benutzers. Das Schema legt keine maximale Länge fest.

Standardattribut, das nicht in der Vorlage enthalten ist: middleName. Maximal 64 Zeichen.

Standardattribut, das nicht in der Vorlage enthalten ist: co. Dies ist der Name des Landes (United Kingdom). Maximal 128 Zeichen. Die Vorlage enthält bereits c, d. h. den 2- oder 3-buchstabigen Ländercode, der aus 3 Zeichen besteht. Geben Sie keinen Ländernamen in c.

Von Ihnen installiertes Schema: norEduPersonNIN. Das „norEduPerson“-Schema von Feide. Es ist bei keinem Standardbenutzer vorhanden, bis dieses Schema importiert und die Klasse für den Benutzer freigegeben wurde. Ordnen Sie es anhand der nationalen Identitätsnummer zu.

Schema Fableton fügte hinzu: fabletonCostCenter. Eine Zeichenkette mit einem einzigen Wert, die in einer Hilfsklasse namens „Fableton“ erstellt wurde. Der Name muss lauten: ldapDisplayName aus diesem Schema.

Zielattribut

Beispielausdruck

Ergebnis in AD

profilePath

\\files.fableton.example\profiles\[samaccountname]

\\files.fableton.example\profiles\jsmith

middleName

[middlename]

Anne

co

United Kingdom

United Kingdom

norEduPersonNIN

[socialsecuritynumber]

Die auf dem Benutzer gespeicherte Identifikationsnummer

fabletonCostCenter

[departmentnumber]

FIN-014


Mehrwert

Mehrere Werte in einem Attribut. Trennen Sie diese durch |. eADM ersetzt die aktuellen Werte. Es werden keine Daten an die bereits in AD vorhandenen angehängt.

Standardattribut, das nicht in der Vorlage enthalten ist: otherMobile. Jede Nummer kann aus 64 Zeichen bestehen. Die Vorlage enthält bereits mobile (eine Zahl) und otherTelephone.

Veröffentlichtes Schema: eduPersonAffiliation. Mehrere Werte. Typische Werte sind staff, employee, und member. Das eduPerson-Schema muss installiert sein, und das Benutzerobjekt muss das Attribut enthalten dürfen.

Schema Fableton fügte hinzu: fabletonRoleCodes. Zeichenfolge mit mehreren Werten für Rollencodes, die nicht unter ein Standardattribut fallen.

Zielattribut

Beispielausdruck

Geschriebene Werte

otherMobile

+447700900123|+447700900456

+447700900123 und +447700900456

eduPersonAffiliation

staff|employee|member

staff, employee, und member

fabletonRoleCodes

Teacher|Principal

Teacher und Principal

Ein nachgestelltes Rohr ist in Ordnung. Leere Zeichen zwischen den Rohren werden übersprungen. Teacher||Principal schreibt immer noch zwei Werte.


Bool

Standardattribut, das nicht in der Vorlage enthalten ist: msNPAllowDialin. Das ist Zugriff gewähren auf der Registerkarte „Einwahl“ des Benutzers unter „Active Directory-Benutzer und -Computer“. Legen Sie diese Option nur fest, wenn Sie den Fernzugriff steuern möchten.

Es muss kein eigener boolescher Typ für ein Textattribut erfunden werden. Wenn Fableton einen eigenen booleschen Typ hinzufügen würde, sollte dieser genauso benannt werden, zum Beispiel fabletonIsManager=Bool, und senden True oder False.

Zielattribut

Beispielausdruck

Ergebnis

msNPAllowDialin

True

Einwahl erlaubt

msNPAllowDialin

False

Einwahl verweigert


Int

Eine ganze Zahl, die als Zahl und nicht als Text gesendet wird.

Standardattribut, das nicht in der Vorlage enthalten ist: countryCode. Dies ist der numerische ISO-Ländercode, nicht der Text in c oder co. Das Vereinigte Königreich ist 826. Der höchste Wert, den das Schema zulässt, ist 65535.

employeeNumber ist Text. Er ist bereits in der Vorlage enthalten als String. Füge es nicht erneut hinzu als Int.

Zielattribut

Beispielausdruck

Ergebnis

countryCode

826

Numerischer Ländercode 826


Attribute, die bereits in der Standardliste enthalten sind

Das Auflisten eines Attributs, das bereits in der Exportvorlage enthalten ist, ändert dessen Typ nicht.

eADM behält den integrierten Eintrag bei und fügt einen zweiten Eintrag mit demselben Namen hinzu. Wenn Sie die Vorlage öffnen, wird der integrierte Typ verwendet. Beim Speichern der Vorlage wird dieser integrierte Typ wieder in die Zuordnungszeile geschrieben.

department ist integriert als String. Dadurch wird es jedoch nicht zu einem Attribut mit mehreren Werten:

department=Multivalue

Du wirst sehen department zweimal in der Liste. Die von eADM verwendete Zeile lautet weiterhin String. Standardattribute aus Benutzerdefinierte Attribute.


Beispiel mit Lösung

Gemeinde Fableton (NO999000001) gibt einen Profilpfad, einen zweiten Vornamen, zusätzliche Handynummern, eine Feide-Identifikationsnummer sowie zwei Attribute aus dem eigenen Schema an. All dies ist in der Benutzervorlage für den AD-Export enthalten.

Benutzerdefinierte Attribute in diesem Schritt:

profilePath=String,middleName=String,otherMobile=Multivalue,norEduPersonNIN=String,fabletonCostCenter=String,fabletonRoleCodes=Multivalue

Fügen Sie anschließend für jedes Attribut eine Zuordnungszeile hinzu, wobei Sie die Ausdrücke aus den obigen Tabellen verwenden.

extensionAttribute1 durch extensionAttribute15 und msDS-cloudExtensionAttribute1 durch msDS-cloudExtensionAttribute20 sind bereits in der Vorlage enthalten. Diese müssen Sie hier nicht hinzufügen.


Testen

Überprüfen

Was ist zu tun?

Der Name taucht auf

Öffnen Sie die Benutzerexportvorlage für diesen „AD exportieren“-Schritt. Das neue Attribut befindet sich in der Zielliste. Der Tooltip zeigt den von Ihnen festgelegten Typ an.

Ein Nutzer

Fügen Sie einen Testbenutzer in den Regelsatz der Vorlage ein oder führen Sie einen Export mit einem einzelnen Objekt durch, falls Sie diese Funktion nutzen.

Kunde

Auf dem eADM-Client-Host: eadm.client.exe exportad NO999000001

Active Directory

Überprüfen Sie in ADSI Edit oder im Attribut-Editor den Wert für diesen Benutzer. Für Multivalue, überprüfen Sie, ob die alten Werte ersetzt wurden.

Wiederholen Sie diesen Vorgang für „Export AD 2“ erst, nachdem derselbe Parameter unter „Export AD 2“ eingestellt wurde.


Fehlerbehebung

Symptom

Mögliche Ursache

Aktion

Die Zielliste in der Vorlage wird nicht geladen

Ein Paar hat keine =, oder der Wert ist anderweitig nicht name=Type

Korrektur Benutzerdefinierte Attribute. Jedes Paar benötigt genau eines =.

Das Attribut ändert sich in AD nie, und im Client-Protokoll wird nie vermerkt, dass dieses Attribut gesetzt wird.

Der Typ ist nicht String, Multivalue, Bool, oder Int

Korrigieren Sie den Text und speichern Sie die Vorlage erneut.

Bool scheitert

Der Ausdruck lautet 1, 0, yes, oder no

Senden True oder False.

Active Directory lehnt den Schreibvorgang ab

Das Attribut ist in dieser Objektklasse nicht vorhanden, der Wert ist zu lang oder das Dienstkonto kann ihn nicht schreiben.

Installieren oder fügen Sie die Schemaklasse hinzu, kürzen Sie den Wert und delegieren Sie die Schreibberechtigung für dieses Attribut.

Du hast hinzugefügt department=Multivalue und es ist immer noch ein Wert

Integrierte Attribute behalten ihren integrierten Typ bei

Entfernen Sie es aus den benutzerdefinierten Attributen.

Der Export AD 2 zeigt die Attribute nicht an

Die Liste ist nach Schritten gegliedert

Legen Sie auch bei „Export AD 2“ benutzerdefinierte Attribute fest.

Der Name ist in der Liste enthalten, aber AD meldet, dass das Attribut nicht existiert.

Der LDAP-Anzeigename ist falsch oder das Schema wurde nicht geladen

Vergleichen Sie den Namen mit dem ADSI-Editor.


Kurzübersicht

profilePath=String,middleName=String,co=String,otherMobile=Multivalue,msNPAllowDialin=Bool,countryCode=Int,norEduPersonNIN=String,eduPersonAffiliation=Multivalue,fabletonCostCenter=String,fabletonRoleCodes=Multivalue

Regel

Details

Name

LDAP-Anzeigename

Typ

String, Multivalue, Bool, oder Int

Trennzeichen zwischen Attributen

Komma, ohne Leerzeichen

Mehrere Werte innerhalb eines Attributs

Rohr | im Vorlagenausdruck

Bereits in der Vorlage enthalten

Führen Sie ihn nicht auf. Der integrierte Typ bleibt erhalten.

Schema

Muss bereits vorhanden sein. eADM erweitert das Schema nicht.

Zuletzt aktualisiert: