Általános CSV-összekötő – Műszaki referencia-útmutató (előzetes verzió)

Ez a cikk az Általános CSV-összekötőt ismerteti. A cikk a következő termékekre vonatkozik:

• Microsoft Entra Connect Provisioning Agent (ECMA2Host)
• Microsoft Identity Manager 2016 (MIM2016)

A MIM 2016 esetében az összekötő letölthető a Microsoft letöltőközpontból.

Az összekötő működés közbeni megtekintéséhez tekintse meg az Általános SQL Connector részletes cikkét .

Megjegyzés

A Azure AD kiépítési szolgáltatás mostantól egy egyszerű ügynökalapú megoldást biztosít a felhasználók CSV-fájlokba való kiépítéséhez, teljes MIM-szinkronizálási üzembe helyezés nélkül. Azt javasoljuk, hogy értékelje ki, hogy megfelel-e az Igényeinek. További információk.

Az általános CSV-összekötő áttekintése

Az Általános CSV-összekötővel a CSV-fájlokban tárolt felhasználói és csoporti identitásadatokat integrálhatja a Microsoft-termékekkel, például a Microsoft Entra Connect Provisioning Agent (ECMA2Host) és a Microsoft Identity Manager 2016 (MIM2016).

Különböző funkciókkal rendelkezik, például a PowerShell használatának vezénylésére az identitásadatok importálási vagy exportálási műveletek előtti vagy utáni kezelésére. Több adattípust is támogat, beleértve a bináris és a hivatkozásokat, a minősített sztringértékek és a többértékű sztringek támogatását.

Ez a cikk az általános CSV-összekötő funkcióit és funkcióit ismerteti, valamint azt, hogyan konfigurálható a MIM 2016-hoz.

Az alábbi táblázat az összekötő aktuális kiadása által támogatott funkciókat sorolja fel magas szintű perspektívából:

Szolgáltatás	Részletek
Több terméktámogatás	Az összekötő használatát a következő Microsoft-termékek támogatják: Microsoft Entra Connect Provisioning Agent (ECMA2Host) Microsoft Identity Manager 2016 (MIM2016)
CSV-fájlok támogatottak	Ez az összekötő legfeljebb három CSV-fájl konfigurálásával támogatja a felhasználó (kötelező) és a csoportok (nem kötelező) kezelését: Felhasználók CSV-fájlja (például Users.csv) CSV-fájl (például Groups.csv) csoportosítása Csoporttagok CSV-fájlja (például Members.csv)
Művelet előtti/utáni feldolgozás a PowerShell-lel	Ez az összekötő legfeljebb négy (4) PowerShell-szkript konfigurálását támogatja, hogy megkönnyítse a felhasználói és csoporti identitásadatok importálás vagy exportálás előtti vagy utáni feldolgozását.
CSV-fájlkódolás támogatott	Az összekötő minden alapértelmezett (vagy telepített) kiszolgálókódolási típust támogat: (például Unicode, UTF-8, UTF-7, ASCII stb.)
A CSV-mező adattípusai támogatottak	Az összekötő a következő attribútum-adattípusokat támogatja: Bináris – (base64 sztringként) Logikai – (igaz/hamis) Egész számok Sztringek / Többértékű sztringek Referencia
CSV mezőelválasztó	A vesszők (,) vagy bármely nyomtatható alfamer karakter támogatása a sztringértékek elején és végének minősítéséhez.
Sztringek minősítésének támogatása	A dupla idézőjelek (") vagy bármely nyomtatható alfamerikus karakter támogatása a sztringértékek elején és végének minősítéséhez.
Többértékű sztring támogatása	Többértékű sztringek támogatása
Támogatott összekötőműveletek	Az összekötő a következő műveleteket támogatja: Teljes importálás Exportálás Teljes exportálás
Séma	A sémafelderítés dinamikus, de manuális konfigurálást igényel a befejezéshez. A mezők dinamikusan vannak azonosítva egy megadott elválasztó (vagy más néven "Értékelválasztó") alapján. A mezők adattípusai manuálisan vannak kijelölve a konfiguráció során.

Előfeltételek

Az összekötő használata előtt győződjön meg arról, hogy rendelkezik a következőkkel a szinkronizálási kiszolgálón:

• Microsoft .NET 4.6.2-keretrendszer vagy újabb
• CSV-fájlok, amelyek a következő identitástípusokhoz a kívánt sémát tartalmazzák:
  • Felhasználói fájl (kötelező)
  • Csoportok (nem kötelező)
  • Csoporttagok (csoportok használata esetén kötelező)
• (Nem kötelező) PowerShell-szkriptek a következő művelettípusok eseményeinek előzetes és utólagos feldolgozásának kezeléséhez:
  • Importálás előtti – Ezt a szkriptet az importálási művelet futtatása előtt hajtja végre a rendszer.
  • Importálás utáni – Ezt a szkriptet az importálási művelet futtatása után hajtja végre a rendszer.
  • Exportálás előtti – Ezt a szkriptet az exportálási művelet futtatása előtt hajtja végre a rendszer.
  • Exportálás utáni – Ezt a szkriptet az exportálási művelet futtatása után hajtja végre a rendszer.

MIM szinkronizálási szolgáltatás fiókengedélyek

Fontos

A MIM 2016 szinkronizálási szolgáltatásfiókja az a biztonsági környezet, amely elvégzi a fájlműveleteket a CSV-fájlokon, és futtatja a feldolgozás előtti/utáni PowerShell-szkripteket. Ehhez a szolgáltatásfiókhoz olvasási/írási engedélyekre van szükség a konfigurált ÖSSZES CSV- és PowerShell-fájlhoz. A konfigurált szkriptek futtatásához a megfelelő PowerShell ExecutePolicy-engedélyekre is szükség van.

Új összekötő létrehozása

Az alábbi lista az útmutatóban ismertetett lépések magas szintű áttekintését tartalmazza. A kezdéshez a MIM Syncs Rendszergazda szerepkörrel rendelkező fiókot kell használni a következő feladatok végrehajtásához:

• Nyissa meg az Új felügyeleti ügynök létrehozása (MA) ablakot a MIM Sync Service Manager.
• Válassza az Általános CSV-összekötőt összekötőtípusként.
• Adja meg az importálni vagy exportálni kívánt CSV-fájl elérési útját és nevét.
• Adja meg a CSV-fájl fájlkódolását, az értékelválasztót, a többértékű elválasztót és a szöveges minősítőt.
• Adja meg, hogy az első sorban szereplő értékeket használja-e fejlécmezőként, vagy sem.
• Válassza ki a CSV-fájlból importálni vagy exportálni kívánt objektumtípusokat és attribútumokat.
• Konfigurálja a partíciót, futtassa a profilt és a leképezés részleteit a ma számára.
• Adja meg a PowerShell-szkriptek szkriptútvonalait és paramétereit, ha vannak ilyenek.
• Futtassa a ma-t az importálási, szinkronizálási vagy exportálási műveletek végrehajtásához.

Általános CSV-összekötő létrehozásához a Szinkronizálási szolgáltatásban válassza a Felügyeleti ügynök és a Létrehozás lehetőséget. Válassza ki az Általános CSV-összekötőt (Microsoft).

Kapcsolatok

A Kapcsolat lap a Felhasználók, Csoportok és Csoporttagok CSV-fájlok fájlhelyeit tartalmazza.

Az alábbi képen a Kapcsolat lap látható.

A következő CSV-fájlok helyei ezen a lapon vannak megadva:

• Felhasználói fájl: A felhasználói rekordokat és attribútumértékeket tartalmazó CSV-fájl teljes elérési útja. Ez a fájl szükséges.
• Csoportfájl: A csoportrekordokat tartalmazó CSV-fájl teljes elérési útja. Ez a fájl nem kötelező.
• Tagfájl: A csoporttagok referenciarekordjait tartalmazó CSV-fájl teljes elérési útja.

Fontos

A MIM Sync szolgáltatásfióknak olvasási és írási engedélyekkel kell rendelkeznie az összes kijelölt CSV-fájlhoz. Ahogy korábban említettük, a csoport- és tagfájlokra nincs szükség, ha csak a felhasználók vannak konfigurálva.

Új általános SQL-összekötő létrehozásakor a Kapcsolat képernyő az első. Először meg kell adnia a következő szakaszadatokat:

Képességek

Ez a lap az összekötő képességeit ismerteti. Az összekötők képességei javítva vannak, és nem módosíthatók, de itt bemutatjuk, hogyan működik az összekötő.

Az alábbi képen egy példa látható a Képességek lapra.

Az alábbi szakasz az egyes konfigurációkat és azok jelentését sorolja fel:

• Megkülönböztető névstílus (LDAP): A GCSV-összekötő az LDAP (Lightweight Directory Access Protocol) szintaxist használja a DN (megkülönböztető név) létrehozásához az egyes felhasználói vagy csoportobjektumok egyedi azonosításához az összekötőtérben. Minden DN-érték a következő formátumban van kifejezve: CN=[ANCHOR_VALUE],Object=[User|Group],O=CSV.
• Objektum megerősítése (Normál): Általában a szinkronizálási motor feltételezi, hogy egy későbbi változásimportálás után újra le tudja kérni az objektumot. A szinkronizálási motor általában így működik, de nem minden csatlakoztatott rendszer működik így. Ez a Normál beállítás biztosítja, hogy a következő importálásban ne exported-change-not-reimported szerepeljön figyelmeztetés.
• Exportálás típusa (MultivaluedReferenceAttributeUpdate): Az exportálási típus határozza meg, hogy az objektumok hogyan legyenek formázva, és hogyan legyenek elküldve a célrendszernek a szinkronizálás során. A MultivaluedReferenceAttributeUpdate egy exportálási típus, amely Microsoft Entra ID használható. Csak a módosult attribútumokat küldi el. Az érték típusú attribútumok esetében az AttributeReplace attribútumot, a referenciaattribútumok esetében pedig az AttributeUpdate attribútumot használja.
• Normalizációk (Nincs): A normalizálások az adatok egységes formátumra való szabványosítására utalnak. A None azt jelenti, hogy a rendszer nem alkalmaz konkrét normalizálási szabályokat. Az adatok továbbra is változatlanok maradnak az összekötő további átalakításai nélkül.

1. séma (CSV-fájlformátum konfigurációi)

A GCSV-összekötő háromféle elválasztó (vagy elválasztó) használatával tagolja és elemzi a CSV-mezőket és azok értékeit.

Ez a lap az elválasztó karakterérték-beállításait és a fájl CSV-fájlként való létrehozásához használt kódolási típust tartalmazza.

Az alábbi kép a Schema 1 (CSV File Format Configurations) oldal képe.

Az alábbi szakasz az egyes konfigurációk listáját tartalmazza:

• Fejlécek használata sémafelderítéshez: Ha ezt a beállítást választja, az arra utasítja az összekötőt, hogy az egyes CSV-fájlok első rekordját kezelje fejlécrekordként, és ne identitásadat-rekordként. Ha ez a beállítás nincs bejelölve, az összekötő hozzárendeli az Attribútum nevet egy hozzáfűzött egyedi növekményes egész számértékkel (például Attribútum1, Attribútum2 stb.), és identitásadat-rekordként kezeli az első sort.
• Értékek elválasztó: Ez a karakter választja el a CSV-rekordok mezőit (vagyis értékeit). A vessző (,) az alapértelmezett érték, de minden nyomtatható alfanumerikus karakter megengedett.
• Többértékű elválasztó: Ez az elválasztótípus egy többértékű sztring (például proxycímek) vagy referenciaattribútumok (például alárendeltek) egyedi értékeinek elválasztására szolgál. Az alapértelmezett érték a pontosvessző (;), de minden nyomtatható alfanumerikus karakter elfogadható.
• Szövegjelölő: Ha egy sztringérték olyan karaktereket tartalmaz, amelyeket egyébként elválasztó karakterként (például vesszőként) értelmeznének, az értéknek minősítettnek kell lennie ahhoz, hogy a CSV-elemző helyesen értelmezhesse a sztringet egyetlen mezőként. A dupla idézőjelek (") az alapértelmezettek, de minden nyomtatható alfanumerikus karakter megengedett.

Megjegyzés

Bár a CSV-fájlok sémái nem tartalmazhatnak többértékű mezőket, vagy nem tartalmazhatnak sztring-minősítést igénylő értékeket, minden elválasztótípushoz egyedi nyomtatható karaktert kell megadni.

• Fájlkódolás: Ez a beállítás a Kapcsolat lapon hozzáadott CSV-fájlok kódolását jelzi. Győződjön meg arról, hogy az megfelel a CSV-fájlok kódolásának.

Megjegyzés

Ha nem biztos a CSV-fájlok kódolási típusában, próbálja meg az alapértelmezett Unicode kódolási típust használni. A Unicode egy gyakori szabvány, amely számos karaktert és szimbólumot támogat, így jó választás a szöveges adatok kódolásához a legtöbb nyelven vagy karakterkészletben.

2. séma (identitás- és referenciamező-konfigurációk)

A horgonyérték egy CSV-fájl rekordjának egyedi azonosítója. Megkülönböztet egy rekordot a többitől. A GCSV-összekötő ezt az értéket is használja a kapcsolódó összekötőtér-objektumot azonosító megkülönböztető név (DN) létrehozásához.

Ezen a lapon a horgonyattribútum-beállítások be vannak állítva a Kapcsolat lapon felsorolt összes CSV-fájlhoz.

Az alábbi képen egy példa látható a Schema 2 (Identitás- és referenciamező-konfigurációk) lapra .

A következő szakasz az ezen az oldalon található egyes konfigurációk listáját tartalmazza:

• Felhasználó
  • Felhasználói horgony: A Felhasználók fájl azon mezője, amely a felhasználói rekord horgonyértékeként szolgál. A Felhasználók fájl első fejlécmezője az alapértelmezett választás.
  • Felhasználói horgony attribútumtípus: Ez a kijelölt horgony attribútumtípusa.
• Csoport
  • Csoporthorgony: A Csoportok fájl azon mezője, amely a csoportrekord horgonyértékeként szolgál. A Csoportok fájl első fejlécmezője az alapértelmezett választás.
  • Csoporthorgony attribútumtípus: Ez a kijelölt horgony attribútumtípusa.
• Tag
  • Szülőcsoport azonosítója: A Tagok fájl azon mezője, amely ugyanazzal a (horgony) értékkel rendelkezik, mint a Csoportok CSV-fájl szülőcsoportja. Alapértelmezés szerint a Tagok fájl első mezőjét használja a rendszer.
  • Tagazonosító: A Tagok fájl azon mezője, amely ugyanazzal a (horgony) értékkel rendelkezik, mint a Felhasználók vagy Csoportok CSV-fájlban. A Tagok fájl második mezője alapértelmezés szerint ki van jelölve.
• Tagobjektum típusa: A tag objektumtípusát jelző "Felhasználó" vagy "Csoport" sztringértéket tartalmazó mező. Ez a mező csak akkor szükséges, ha a Tag fájl kettőnél több mezőt tartalmaz. Az Objektumtípus mező csak "Felhasználó" vagy "Csoport" sztringértéket tartalmazhat. Ha ez a mező hiányzik, az összekötő azt feltételezi, hogy a Tagok fájlrekordok felhasználói objektumtagra hivatkoznak. A Tagok fájlban található harmadik mező alapértelmezés szerint ki van jelölve.

Fontos

A horgonyként használni kívánt attribútumok nevének egyedinek kell lennie az összes objektumtípus-sémában. Ide tartoznak a Csoporttagok fájlban megadott horgonyok.

3. séma (felhasználók fájlattribútumainak sémakonfigurációi)

Ez a lap a Felhasználók CSV-fájl sémájában azonosított mezők adattípusának megadására és magyarázatára használható, valamint arra, hogy lehetnek-e egynél több értékük.

Az alábbi képen egy példa látható a Schema 3 (Users File Attribute Schema Configurations) (Felhasználók fájlattribútum-sémakonfigurációi) lapra .

A következő szakasz az attribútum-adattípus-hozzárendelések során megfontolandó szempontokat sorolja fel.

Támogatott adattípusok

A GCSV-összekötő a Következő szakasz adattípusainak használatát támogatja:

• Logikai: true (igaz) vagy false (hamis) érték.
• Bináris: olyan érték, amely bájtok sorozataként van tárolva, általában adatok, például képek vagy más fájlok tárolására szolgál.
• Egész szám: egész szám, tizedesjegyek nélkül.
• Sztring: olyan érték, amely egy karaktersorozat, amely általában szöveges adatok tárolására szolgál.
• Hivatkozás: olyan érték, amely egy másik felhasználói objektumra mutató hivatkozás. Ha referenciaértéket szeretne megadni egy CSV-fájlban, töltse ki a mezőt a hivatkozott felhasználói objektum horgonyértékével.

Fontos

A felhasználói vagy csoporthivatkozási attribútumok csak felhasználói objektumokra való hivatkozásra használhatók. Ez nem vonatkozik a Csoportobjektumok Member attribútumára, amely mindaddig tartalmazhat felhasználói vagy csoporthivatkozásokat, amíg az objektumtípus mező meg van adva.

Támogatott Multiple-Value adattípusok

Az összekötő csak a következő adattípusokhoz támogatja a többértékű attribútumok használatát:

• Sztring

Megjegyzés

Ha a Felhasználó és a Csoport objektum sémája is ugyanazzal a névvel rendelkezik (nem horgony) attribútummal, előfordulhat, hogy a különböző adattípusok nem lesznek egymáshoz rendelve. Mindkettőnek ugyanazt az adattípust kell megosztania.

4. séma (Csoportok fájlattribútumainak sémakonfigurációi)

Ez a lap a Groups CSV-fájl sémájában azonosított mezők adattípusának megadására és magyarázatára használható, valamint arra, hogy lehetnek-e egynél több értékük.

Az alábbi képen egy példa látható a Schema 4 (Groups File Attribute Schema Configurations) lapra .

A Schema 3 (Users File Attribute Configurations) (Felhasználók fájlattribútum-konfigurációi ) című szakasz útmutatása erre a szakaszra is vonatkozik. .

A kezdeti teljes importálási művelet futtatása után az összekötőtér az alábbi képhez hasonlóan fog kinézni:

Globális paraméterek (PowerShell-szkriptek konfigurálása)

Ez a lap lehetővé teszi az importálási és/vagy exportálási műveletek előtt és/vagy után futó PowerShell-szkriptek konfigurálását. Ezek a funkciók számos, az identitásfelhasználói és csoportrekordokon végzett feldolgozási műveletek széles skáláját teszik lehetővé.

Az alábbi képen a Globális paraméterek lap látható.

Az alábbi szakasz az ezen az oldalon található egyéni konfigurációs beállításokat sorolja fel:

• Szkript időtúllépése (percek): a szkript automatikus megszakítása előtt futtatott percek száma. A beállítás alapértelmezett értéke 100 , és nulla (0) értéknél nagyobb értéket igényel.
• Importálás előtti szkriptfájl: az importálás előtt futtatandó PowerShell-szkript teljes elérési útja. Ez a beállítás nem kötelező, és nem igényel értéket.
• Importálás utáni szkriptfájl: az importálás után futtatandó PowerShell-szkript teljes elérési útja. Ez a beállítás nem kötelező, és nem igényel értéket.
• Szkriptfájl előzetes exportálása: az exportálás előtt futtatandó PowerShell-szkript teljes elérési útja. Ez a beállítás nem kötelező, és nem igényel értéket.
• Exportálás utáni szkriptfájl: az exportálás után futtatandó PowerShell-szkript teljes elérési útja. Ez a beállítás nem kötelező, és nem igényel értéket.

PowerShell-szkript végrehajtása és bemeneti paraméterei

A GCSV-összekötő a konfigurált PowerShell-szkripteket a saját munkamenetében hajtja végre, és nem támogatja a paraméterek fázisok közötti átadását.

Az összekötő egy bemeneti paramétert ad át minden OperationType nevű szkriptnek. Ennek a paraméternek az értéke a futtatott Profil futtatása művelettől függően változik, és három érték egyike lehet:

Fontos

A CSV-fájlok importálási vagy exportálási műveletek előtti dinamikus létrehozása nem támogatott. Az összes CSV-fájlnak jelen kell lennie a futtatási profilok bármelyikének végrehajtása előtt.

PowerShell bemeneti paraméter: OperationType

Bár a bemeneti paraméterek használata nem támogatott, a GCSV-összekötő minden PowerShell-szkript végrehajtásához egy bemeneti paramétert ad át: OperationType.

• Teljes – ezt az értéket a teljes importálási vagy teljes exportálási műveletek során adták meg.
• Delta – ez az érték az exportálási műveletek során van megadva.

Ez a paraméterérték a PowerShell-szkriptek logikájában használható a megfelelő feldolgozási művelet vagy művelet meghatározásához.  

Kiépítési hierarchia

Mivel a CSV-fájlok nem hierarchikus struktúrában tárolják az információkat, a GCSV-összekötő nem támogatja a hierarchikus kiépítési konfigurációkat.

Az alábbi képen a Kiépítési hierarchia lap látható.

Partíciók és hierarchiák

A GCSV-összekötő külön megkülönböztető nevet (DN) hoz létre az összekötőtérben lévő összes felhasználó- és csoportrekordhoz, az ALÁBBI LDAP-formátumot követve:

CN=[ANCHOR_VALUE],Object=User|Group,O=CSV

Az alábbi képen a Partíciók és hierarchiák lap látható.

Objektumtípusok

A GCSV-összekötőnek legalább a Felhasználói objektumtípust kell kijelölni. A Csoport objektumtípus megadása nem kötelező.

Az alábbi képen az Objektumtípusok lap látható.

Attribútumok

Ezen a lapon a kijelölt objektumtípus-sémák összes attribútumának normalizált listája látható.

Az alábbi képen az Attribútumok lap látható.

Megjegyzés

A Tag attribútum csak akkor létezik, ha a csoportok ki vannak választva, és tartalmazzák a csoporttagok CSV-fájljaiban tárolt objektumokra mutató hivatkozásokat.

Horgonyok

A GCSV-összekötő nem támogatja olyan összetett horgonyok és horgonyattribútum-konfigurációk használatát, amelyek eltérnek a megfelelő CSV-fájl horgonyazonosító mezőitől.

Az oldalon megjelenő horgonyjelölések módosításához térjen vissza a 2. sémához (Horgonykonfigurációk).

Az alábbi képen a Horgonyok lap látható.

CSV-rekordok kiépítése

Ahhoz, hogy a GCSV-összekötő új felhasználó- vagy csoportobjektumokat vegyen fel a megfelelő CSV-fájlokba, új összekötőtérobjektumot kell kiépíteni.

Akár a MIM 2016 deklaratív kiépítését , akár saját MIM-szinkronizálási szabályok bővítményeinek írását használja, az új összekötőtér-objektumoknak a következő formátumot használó DN-sel kell rendelkezniük:

CN=[ANCHOR_VALUE];Object=User|Csoport,O=CSV

Az alábbi táblázat részletesen ismerteti az egyes összetevők értékeit:

Összetevő	Jegyzetek
CN=[HORGONYÉRTÉK]	A köznapi névnek (CN) egyedi értéknek kell lennie, és a CSV-fájl kijelölt horgony mezőjébe kell írnia.
Object=Felhasználó/csoport	Ez az összetevő az összekötő objektumtípusát jelzi. Csak a "Felhasználó" vagy a "Csoport" lehetőséget támogatja.
O=CSV	Az összes GCSV-összekötőtér-objektumhoz közös gyökérösszetevő.

A következő kép egy szinkronizálási szabály , amely bemutatja, hogyan hozhat létre megfelelően egy DN-t, amikor új felhasználói objektumot épít ki egy GCSV-összekötőbe:

Az alábbi kód a metaverzumszabályok bővítményeit használó egyenértékű kiépítési logikát mutatja be.

void IMVSynchronization.Provision(MVEntry mventry)
{
	if (mventry["employeeID"].IsPresent)
	{
		ConnectedMA GCSVConnector = = mventry.ConnectedMAs["Generic CSV Conenctor"];

		if (GCSVConnector.Connectors.Count == 0)
		{
			CSEntry csentry = GCSVConnector.Connectors.StartNewConnector("user");

			//Sets DN to "CN=[ANCHOR_VALUE],OBJECT=[User|Group],O=CSV"
			csentry.DN = GCSVConnector.EscapeDNComponent("CN=" + mventry["employeeID"].Value).Concat("OBJECT=User,O=CSV");

			csentry["AccountName"].StringValue = mventry["accountName"].StringValue;
			csentry["CountryCode"].IntegerValue = 1;
			csentry["DisplayName"].Value = mventry["displayName"].Value;
			csentry["ProxyAddresses"].Value = mventry["proxyAddressCollection"].Value;
			csentry["IsActive"].BooleanValue = true;
			csentry["Manager"].Value = mventry["manager"].Value;
			csentry["ProfilePic"].Value = mventry["pic"].Value;

			csentry.CommitNewConnector();
		}
	}
}

Az előző képen jegyezze fel a EcapeDNComponent() függvény használatát annak biztosítására, hogy a horgonyérték megfelelően legyen feloldva, hogy megfeleljen az LDAP-szintaxisnak.

Fontos

Ha nem megfelelően lépi ki a horgonyértéket egy DN létrehozásakor, az hibát eredményez invalid‑dn .

CSV mezőformázási példák

Az alábbi szakaszok példákat sorolnak fel arra, hogyan formázhat különböző adattípusokat CSV-fájlokban. Minden példa: Az alábbi szakasz feltételezi az összekötő alapértelmezett mezőelválasztó-beállításainak használatát:

• Érték elkülönítve: vessző (,)
• Többértékű elválasztó: Semi-Colon (;)
• Szöveg minősítője: Dupla idézőjelek (")

Példa: Szöveg minősítése

Ha egy sztringérték olyan karaktereket tartalmaz, amelyeket máskülönben elválasztóként (például vesszőként) értelmeznének, az érték minősítésére van szükség, hogy a CSV-elemző megfelelően értelmezhesse a sztringet egyetlen mezőként.

Az alábbi CSV-példa azt mutatja be, hogy a DisplayName mező hogyan tartalmaz minősített szövegként formázott értékeket:

EmployeeID,DisplayName
E001,"Smith, John"
E002,"Doe, Jane"
E003,"Perez, Juan"

Példa: Többértékű sztringek elválasztása

Ha több sztringértéket szeretne megadni egy sztringmezőben, az értékeket a Többértékű elválasztóval kell elválasztani. Az alábbi CSV-példa azt mutatja be, hogy a ProxyAddress mező több értékkel:

EmployeeID,DisplayName,ProxyAddresses
E001,"Smith, John",SMTP:john.smith@contoso.com;smtp:js001@contoso.com
E002,"Doe, Jane",SMTP:jane.doe@contoso.com;smtp:jd002@contoso.com

Megjegyzés

A többértékű sztringek a sztring minősített értékeinek használatát is támogatják. A szövegbesorolt értékeket többértékű elválasztókkal is elválaszthatja.

Példa: Referenciamezők

Ha referenciaértéket szeretne megadni egy CSV-fájlban, töltse fel a mezőt a hivatkozott felhasználói objektum horgonyértékével. A következő CSV-példában a Kezelő mező annak a felhasználói rekordnak a horgonyértéket tartalmazza, amelyre hivatkozik:

EmployeeID,DisplayName,Manager
E001,"Smith, John",
E002,"Doe, Jane",E001
E003,"Doe, Jane", 
E004,"Perez, Juan",

Példa: Bináris mezők

A bináris értékek CSV-fájlokban való kifejezéséhez azokat base64-sztringekké kell konvertálni, amelyek ugyanazt a kódolási típust használják, mint a CSV-fájl. Az alábbi PowerShell-függvény bemutatja, hogyan kódolhat sztringértéket a base64 kódolású karakterláncba Unicode-ban:

function ConvertTo-Base64([string]$text) 
{
    $bytes = [System.Text.Encoding]::Unicode.GetBytes($text)
    $encodedText = [System.Convert]::ToBase64String($bytes)
    return $encodedText
}

Itt található a C# megfelelő függvénye, amely elfogadja a szöveg nevű bemeneti paramétert, és egy Base64 kódolású sztringet ad vissza Unicode-ban.

public static string ConvertToBase64(string text)
{
    byte[] bytes = System.Text.Encoding.UTF8.GetBytes(text);
    string encodedText = System.Convert.ToBase64String(bytes);
    return encodedText;
}

Példa: Logikai mezők

A logikai mezőket tartalmazó CSV-fájloknak igaz vagy hamis szöveget kell használniuk az értékük jelzéséhez. Az alábbi szakasz egy

EmployeeID,DisplayName,IsActive
E001,"Smith, John",true
E002,"Doe, Jane",true
E003,"Perez, Juan",false

Ismert korlátozások

Az alábbi lista a GCSV-összekötő ismert korlátozásait tartalmazza.

• Referenciaattribútumok
  • A csoporttag attribútumon kívül a többértékű referenciaattribútumok nem támogatottak.
  • A referenciaértéknek felhasználói objektumokra kell hivatkoznia. A csoportobjektumokra mutató hivatkozások nem támogatottak.
• Horgonyok
  • A felhasználói és csoportobjektumok közötti horgonyértékek duplikálása nem támogatott.
  • A horgonyattribútumok nevének egyedinek kell lennie a felhasználói és csoportsémák között.
• PowerShell
  • A bemeneti változók PowerShell-szkriptekbe való átadása nem támogatott.