Active Directory: Miten viedään mukautetun skeeman attribuutteja | eADM

Yleiskatsaus

Export AD tuntee jo ennalta määritetyn luettelon Active Directory -attribuuteista (samAccountName, department, extensionAttribute1, ja niin edelleen). Se Mukautetut attribuutit Tämä parametri lisää nimiä kyseiseen luetteloon, jotta voit määrittää ne vientimallissa.

Parametri ei kirjoita mitään itsestään. Kun olet tallentanut sen, lisää kartoitusrivi ”Export AD” -vaiheen malliin. eADM ei luo attribuutteja hakemistoon. Nimen on jo oltava olemassa Active Directory -skeemassa siinä objektissa, johon kirjoitat (käyttäjä, ryhmä tai organisaatioyksikkö).

Tämä parametri löytyy jokaisesta paikallisesta Export AD -vaiheesta (Export AD, Export AD 2 ja muut Export AD -vaiheet). Sitä ei ole Export Azure / Entra -vaiheissa. Jokaisella Export AD -vaiheella on oma luettelonsa.

Parametri on ollut käytettävissä helmikuusta 2026 lähtien.

Tuote	Yksityiskohdat
Missä	Synkronointijakso → ”Vie AD” -vaihe → Mukautetut attribuutit
Muoto	`ldapDisplayName=Type`, useita pilkuilla erotettuja pareja
Kirjoittavat tyypit	`String`, `Multivalue`, `Bool`, `Int`
Mitä teet edelleen	Lisää attribuutti vientimalliin ja määritä sille lauseke

Missä asetukset määritetään

Avaa synkronointisyklin ja valitse ”Vie AD” -vaihe, jonka tulisi tallentaa kyseinen attribuutti.
Sarja Mukautetut attribuutit. Älä lisää välilyöntejä = tai ,.
Avaa kyseisen vaiheen ja objektityypin (käyttäjä, ryhmä tai organisaatioyksikkö) vientimalli.
Lisää kartoitusrivi. Uusi nimi löytyy kohdeattribuuttiluettelosta. Lauseke on arvo, jonka eADM lähettää.
Tallenna malli. Kartoitusrivin tyyppi otetaan luettelosta tallennuksen yhteydessä. Jos muutat tyyppiä myöhemmin kohdassa ”Mukautetut attribuutit”, avaa malli ja tallenna se uudelleen.

Käytä LDAP-näyttönimeä, eli samaa nimeä, joka näkyy ADSI Edit -ohjelmassa. middleName on oikein. Middle-Name on skeemaobjektin nimi, eikä se ole.

Toinen metsä käyttää ”Custom attributes” -kenttää Export AD 2:ssa (tai Export AD 3:ssa jne.). Se ei peri luetteloa Export AD:sta.

Miten arvo kirjoitetaan

Tyyppi on sana, joka tulee sanan jälkeen =. Näitä neljää tyyppiä kannattaa käyttää:

Tyyppi	Kirjoituskäyttäytyminen
`String`	Yksi arvo. Tyhjä tulos tyhjentää attribuutin.
`Multivalue`	Lauseke jaetaan kohdasta `\|`. eADM tyhjentää attribuutin ja lisää sitten jokaisen ei-tyhjän osan. Tyhjä tulos tyhjentää attribuutin.
`Bool`	Vain `True` tai `False`. `1` ja `0` hyläetään.
`Int`	Kokonaisluku. Tyhjä tulos on virhe, ei nollaus.

Tyyppi on kirjoitettava täsmälleen tuolla tavalla. string tai MultiValue ei täsmää, jolloin eADM ohittaa kirjoituksen. Asiakkaan lokissa ei ole kyseistä attribuuttia koskevaa ”Setting … to value” -riviä.

Reference, Mail, Powershellja RDN on varattu jo valmiiksi sisäänrakennetuille attribuuteille. Älä käytä niitä Mukautetut attribuutit.

Pituusrajoitukset määritetään Active Directoryn kautta, ei eADM:n kautta. Katso Active Directory: Attribuuttien merkkimäärärajoitukset.

merkkijono

Yksi tekstiarvo.

Vakiomääritelmä, jota ei ole mallissa: profilePath. Tämä on käyttäjän roaming-profiilin polku. Schemassa ei ole määritelty enimmäispituutta.

Vakiomääritelmä, jota ei ole mallissa: middleName. Enintään 64 merkkiä.

Vakiomääritelmä, jota ei ole mallissa: co. Tämä on maan nimi (United Kingdom). Enintään 128 merkkiä. Mallissa on jo c, joka on 2- tai 3-kirjaiminen maakoodi ja koostuu 3 merkistä. Älä kirjoita maan nimeä kenttään c.

Asentamasi skeema: norEduPersonNIN. Feiden norEduPerson-skeema. Se ei ole oletuskäyttäjällä, ennen kuin kyseinen skeema on tuotu ja luokka on sallittu kyseiselle käyttäjälle. Liitä se kansalliseen henkilötunnukseen.

Schema Fableton lisäsi: fabletonCostCenter. Luodaan yksiarvoinen merkkijono apuluokkaan Fableton. Nimen on oltava ldapDisplayName tuosta skeemasta.

Kohde-attribuutti	Esimerkkilauseke	Tulos AD:ssä
`profilePath`	`\\files.fableton.example\profiles\[samaccountname]`	`\\files.fableton.example\profiles\jsmith`
`middleName`	`[middlename]`	`Anne`
`co`	`United Kingdom`	`United Kingdom`
`norEduPersonNIN`	`[socialsecuritynumber]`	Käyttäjän laitteelle tallennettu tunnistenumero
`fabletonCostCenter`	`[departmentnumber]`	`FIN-014`

Moniarvoinen

Useita arvoja yhdessä attribuuttissa. Erota ne toisistaan merkillä |. eADM korvaa nykyiset arvot. Se ei lisää tietoja AD:ssä jo oleviin tietoihin.

Vakiomääritelmä, jota ei ole mallissa: otherMobile. Jokainen numero voi olla 64 merkkiä pitkä. Mallissa on jo mobile (yksi luku) ja otherTelephone.

Julkaistu skeema: eduPersonAffiliation. Useita arvoja. Tyypillisiä arvoja ovat staff, employeeja member. eduPerson-skeema on asennettava, ja käyttäjäobjektin on oltava oikeutettu sisältämään kyseinen attribuutti.

Schema Fableton lisäsi: fabletonRoleCodes. Moniarvoinen merkkijono roolikoodeille, jotka eivät sovi vakiomuotoiseen attribuuttiin.

Kohde-attribuutti	Esimerkkilauseke	Kirjatut arvot
`otherMobile`	`+447700900123\|+447700900456`	`+447700900123` ja `+447700900456`
`eduPersonAffiliation`	`staff\|employee\|member`	`staff`, `employee`ja `member`
`fabletonRoleCodes`	`Teacher\|Principal`	`Teacher` ja `Principal`

Perässä oleva putki käy hyvin. Putkien välissä olevat tyhjät osat ohitetaan. Teacher||Principal kirjoittaa edelleen kaksi arvoa.

Bool

Vakiomääritelmä, jota ei ole mallissa: msNPAllowDialin. Tämä on Salli pääsy Active Directory -käyttäjät ja -tietokoneet -sovelluksen käyttäjän Dial-in-välilehdellä. Määritä tämä asetus vain, jos haluat hallita etäkäyttöä.

Tekstiattribuuttia varten ei tarvitse keksiä erillistä boolean-tyyppiä. Jos Fableton lisäisi oman boolean-tyyppinsä, se nimettäisiin samalla tavalla, esimerkiksi fabletonIsManager=Bool, ja lähetä True tai False.

Kohde-attribuutti	Esimerkkilauseke	Tulos
`msNPAllowDialin`	`True`	Soittaminen sallittu
`msNPAllowDialin`	`False`	Soittopyyntö hylätty

Int

Kokonaisluku, joka lähetetään numerona eikä tekstinä.

Vakiomääritelmä, jota ei ole mallissa: countryCode. Tämä on numeerinen ISO-maakoodi, ei teksti, joka on c tai co. Yhdistynyt kuningaskunta on 826. Schema hyväksyy suurimmaksi arvoksi 65535.

employeeNumber on tekstiä. Se on jo mallissa muodossa String. Älä lisää sitä uudelleen muodossa Int.

Kohde-attribuutti	Esimerkkilauseke	Tulos
`countryCode`	`826`	Maakoodi 826

Ominaisuudet, jotka ovat jo vakioluettelossa

Jo vientimallissa olevan attribuutin lisääminen ei muuta sen tyyppiä.

eADM säilyttää sisäänrakennetun merkinnän ja lisää toisen merkinnän, jolla on sama nimi. Kun avaat mallin, käytössä on sisäänrakennettu tyyppi. Mallin tallentaminen kirjoittaa kyseisen sisäänrakennetun tyypin takaisin kartoitusriville.

department on sisäänrakennettu seuraavasti: String. Tämä ei tee siitä moniarvoista attribuuttia:

department=Multivalue

Tulet huomaamaan, että department kahdesti luettelossa. eADM:n käyttämä rivi on edelleen String. Jätä vakiomääritteet pois Mukautetut attribuutit.

Esimerkki

Fabletonin kunta (NO999000001) tallentaa profiilin polun, toisen nimen, ylimääräiset matkapuhelinnumerot, Feide-tunnusnumeron sekä kaksi omasta skeemastaan peräisin olevaa attribuuttia. Kaikki nämä tiedot sisältyvät Export AD:n käyttäjämalliin.

Kyseisen vaiheen mukautetut attribuutit:

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

Lisää sitten yksi kartoitusrivi kutakin attribuuttia kohti käyttäen yllä olevissa taulukoissa olevia lausekkeita.

extensionAttribute1 kautta extensionAttribute15 ja msDS-cloudExtensionAttribute1 kautta msDS-cloudExtensionAttribute20 ne ovat jo mallissa. Niitä ei tarvitse lisätä tähän.

Testaus

Tarkista	Mitä tehdä
Nimi näkyy	Avaa kyseisen ”Vie AD” -vaiheen käyttäjien vientimalli. Uusi attribuutti näkyy kohdeluettelossa. Tyyppitiedotteessa näkyy määrittämäsi tyyppi.
Yksi käyttäjä	Lisää testikäyttäjä mallin sääntöjoukkoon tai suorita yhden objektin vienti, jos käytät sitä.
Asiakas	eADM-asiakaskoneella: `eadm.client.exe exportad NO999000001`
Active Directory	Tarkista kyseisen käyttäjän arvo ADSI Edit -ohjelmassa tai Attribute Editorissa. Jos `Multivalue`, varmista, että vanhat arvot on korvattu.

Toista toiminto ”Export AD 2” vasta sen jälkeen, kun sama parametri on määritetty kohdassa ”Export AD 2”.

Vianmääritys

Oire	Todennäköinen syy	Toiminta
Mallin kohdeluetteloa ei saada ladattua	Parilla ei ole `=`, tai arvo ei muuten ole `name=Type`	Korjaus Mukautetut attribuutit. Jokaisessa parissa on oltava täsmälleen yksi `=`.
Tämä attribuutti ei muutu koskaan AD:ssä, eikä asiakkaan lokissa mainita koskaan, että kyseistä attribuuttia asetettaisiin	Tyyppi ei ole `String`, `Multivalue`, `Bool`, tai `Int`	Korjaa teksti ja tallenna malli uudelleen.
`Bool` epäonnistuu	Lauseke on `1`, `0`, `yes`, tai `no`	Lähetä `True` tai `False`.
Active Directory hylkää kirjoituksen	Attribuuttia ei ole kyseisessä objektiluokassa, arvo on liian pitkä tai palvelutili ei voi kirjoittaa sitä	Asenna tai liitä skeemaluokka, lyhennä arvoa ja delegoi kyseisen attribuutin kirjoitusoikeus.
Lisäsit `department=Multivalue` ja se on edelleen yksi arvo	Sisäänrakennetut attribuuttien säilyttävät sisäänrakennetun tyyppinsä	Poista se kohdasta ”Mukautetut attribuutit”.
Export AD 2 ei näytä attribuutteja	Luettelo on vaiheittain	Määritä mukautetut attribuutit myös Export AD 2:ssa.
Nimi on luettelossa, mutta AD ilmoittaa, että attribuuttia ei ole olemassa	LDAP-näyttönimi on väärä tai skeemaa ei ole ladattu	Vertaa nimeä ADSI Edit -ohjelmaan.

Pikaopas

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

Sääntö	Yksityiskohdat
Nimi	LDAP-näyttönimi
Tyyppi	`String`, `Multivalue`, `Bool`, tai `Int`
Määritteiden välinen erottimerkki	Pilkku, ilman välilyöntejä
Useita arvoja yhden attribuutin sisällä	Putki `\|` mallilausekkeessa
Jo mallissa	Älä lisää sitä luetteloon. Sisäänrakennettu tyyppi säilyy.
Kaavio	Sen on oltava jo olemassa. eADM ei laajenna skeemaa.

Viimeksi päivitetty: 2. marraskuuta 2026