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

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

• Microsoft Entra Connect Létesítési ügynök (ECMA2Host)
• Microsoft Identity Manager 2016 (MIM2016)

A csatlakozó letöltésként érhető el a Microsoft Letöltőközpontból MIM 2016-hoz .

Az csatlakozó működés közbeni szemléltetéséhez tekintse meg a generikus SQL csatlakozó lépésről lépésre cikket.

Jegyzet

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

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ás vagy exportálás előtti vagy utáni kezelésére. Több adattípust támogat, beleértve a bináris és 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, valamint a MIM 2016-hoz való konfigurálását ismerteti.

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:

Jellemző	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 telepítési ügynök (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ói CSV-fájl (például Users.csv) Csoportok CSV-fájlja (például Groups.csv) 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 a felhasználói és csoporti identitásadatok importálás vagy exportálás előtti vagy utáni feldolgozásának megkönnyítése érdekében.
CSV-fájlkódolás támogatott	Az összekötő támogatja az összes alapértelmezett (vagy telepített) kiszolgálókódolási típust: (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 – (alap64 sztringként) Boolean – (Igaz/Hamis) Egészek Húrok / Többszörös értékű húrok Hivatkozás
CSV mezőelválasztó	A vesszők (,) vagy bármely nyomtatható alfamerikus karakter támogatása a sztringértékek elejének és végének minősítéséhez.
Sztring-minősítés támogatása	Dupla idézőjelek (") vagy bármely nyomtatható alfamerikus karakter támogatása a sztringértékek elejének és végének minősítéséhez.
Többértékű karakterlánc támogatása	Többértékű karakterláncok támogatása
Támogatott összekötőműveletek	Az összekötő a következő műveleteket támogatja: Teljes importálás Kivitel 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 azonosíthatók 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 verzió
• A következő identitástípusokhoz a kívánt sémát tartalmazó CSV-fájlok:
  • 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 – Ez a szkript egy importálási művelet futtatása után lesz végrehajtva.
  • 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ásfiók engedélyei

Fontos

A MIM 2016 szinkronizálási szolgáltatásfiókja az a biztonsági környezet, amely csv-fájlokon hajtja végre a fájlműveleteket, és futtatja a PowerShell-szkriptek feldolgozását megelőző/utáni műveleteket. Ehhez a szolgáltatásfiókhoz olvasási/írási engedélyekre van szükség az összes konfigurált CSV- és PowerShell-fájlhoz. Emellett a megfelelő PowerShell ExecutePolicy-engedélyekre van szüksége a konfigurált szkriptek futtatásához.

Ú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 Szinkronizálása rendszergazdai 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 ki az Általános CSV-összekö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 lévő értékeket fejlécmezőként szeretné-e használni.
• 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, a futtatási profilt és a leképezési részleteket az MA részére.
• Adja meg a PowerShell-szkriptek szkriptútvonalait és paramétereit, ha vannak ilyenek.
• Az importálási, szinkronizálási vagy exportálási műveletek végrehajtásához futtassa a ma-t.

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

Hálózati csatlakozás

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ó.

Ezen a lapon a következő CSV-fájlok helyei 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.
• Csoportok fájl: A csoportrekordokat tartalmazó CSV-fájl teljes elérési útja. Ez a fájl nem kötelező.
• tagok fájlja: A csoporttagok hivatkozási rekordjait 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.

Az ú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é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 a Képességek oldal látható.

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

• Megkülönböztető névstílus (LDAP): A GCSV-összekötő az LDAP (Lightweight Directory Access Protocol) szintaxissal hozza létre a DN -t (megkülönböztető név), hogy egyedileg azonosítsa az összekötőtérben lévő összes felhasználó- vagy csoportobjektumot. Az összes 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): A szinkronizálási motor általában feltételezi, hogy az exportálást követően egy későbbi delta importálás sorá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. A normál beállítás biztosítja, hogy a következő importálás során ne legyen exported-change-not-reimported figyelmeztetés.
• Exportálás típusa (MultivaluedReferenceAttributeUpdate): Az exportálási típus azt határozza meg, hogy az objektumok hogyan legyenek formázva és küldve a célrendszernek a szinkronizálás során. MultivaluedReferenceAttributeUpdate olyan exportálási típus, amely a Microsoft Entra ID-val való használatra készült. Csak a módosított attribútumokat küldi el. Az értéktípusú attribútumok esetében az AttributeReplace-t, míg a referenciaattribútumoknál az AttributeUpdate-et használja.
• Normalizálások (Nincs): A normalizálások az adatok egységes formátumra való szabványosítására vonatkoznak. Egyik sem azt jelenti, hogy a rendszer nem alkalmaz konkrét normalizálási szabályokat. Az adatok as-is 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ót (vagy elválasztót) használ a CSV-mezők és azok értékeinek elválasztására és elemzésére.

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

Az alábbi kép a Schema 1 (CSV fájlformátum konfigurációi) lap képe.

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

• Használjon fejléceket sémafelderítési: Ha ezt a beállítást választja, az összekötőt arra utasítja, 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 a nevet Attribútum hozzáfűzött egyedi növekményes egész számértékkel (például Attribútum1, Attribútum2stb.), és identitásadat-rekordként kezeli az első sort.
• Értékelválasztó: Ez a karakter elválasztja a CSV-rekordok mezőit (vagyis értékeit). A vessző (,) az alapértelmezett érték, de minden nyomtatható alfanumerikus karakter engedélyezett.
• 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öveg minősítője: Ha egy sztringérték olyan karaktereket tartalmaz, amelyek egyébként elválasztóként (például vesszőként) értelmezve lennének, az értéknek minősítettnek kell lennie ahhoz, hogy a CSV-elemző megfelelően értelmezhesse a sztringet egyetlen mezőként. A dupla idézőjelek (") az alapértelmezettek, de minden nyomtatható alfanumerikus karakter megengedett.

Jegyzet

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 kijelölni.

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

Jegyzet

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

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

A horgonyérték egy CSV-fájlban lévő rekord egyedi azonosítója. Megkülönböztet egy rekordot a többitől. A GCSV-összekötő ezzel az értékkel hozza létre a kapcsolódó összekötőtér-objektumot azonosító megkülönböztető nevet (DN).

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 a Schema 2 (Identitás- és referenciamező-konfigurációk) lap látható.

Az alábbi szakasz az ezen a lapon található egyéni konfigurációk listáját tartalmazza:

• Felhasználó
  • Felhasználói horgony: A Felhasználói 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 Csoport 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 a Csoportok CSV-fájl szülőcsoportjával azonos (horgony) értékkel rendelkezik. 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 "Felhasználó" vagy a "Csoport" sztringet tartalmazó mező, amely a tag objektumtípusát jelzi. Ez a mező csak akkor szükséges, ha a Tag fájl két mező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ő feltételezi, hogy a Tagok fájlrekordok egy Felhasználói objektum tagra 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útum-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 egynél több értékkel rendelkezhetnek-e.

Az alábbi képen a Séma 3 (Felhasználói fájl attribútum sémabeállítások) lap látható.

Az alábbi szakasz az attribútum-adattípus-hozzárendelések során megfontolandó szempontokat sorolja fel.

Támogatott adattípusok

A GCSV-összekötő az alábbi szakasz adattípusok használatát támogatja:

• Boolean: egy érték, ami lehet igaz vagy hamis.
• bináris: bájtok sorozataként tárolt érték, amely á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: egy karaktersorozatot tartalmazó érték, 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. 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 hivatkozhatnak. Ez nem vonatkozik a Csoportobjektumok Tag attribútumára, amely mind a felhasználói, mind a csoporthivatkozásokat tartalmazhat, 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:

• Húr

Jegyzet

Ha mind a Felhasználó, mind a Csoport objektum sémája ugyanazzal a névvel rendelkezik (nem horgony) attribútummal, előfordulhat, hogy eltérő adattípusok nem lesznek hozzárendelve közöttük. Mindkettőnek azonos adattípussal kell rendelkeznie.

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

Ez a lap a Csoportok 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 egynél több értékkel rendelkezhetnek-e.

Az alábbi kép a Séma 4 (Csoportok fájl-attribútumséma-konfigurációi) lap példáját mutatja.

A Schema 3 (Users File Attribute Configurations) című témakörben található útmutatás erre a szakaszra is vonatkozik. .

A kezdeti teljes importálási művelet futtatása után az összekötő területe a következő képhez hasonlóan fog kinézni:

-ről

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

Ezen a lapon olyan PowerShell-szkriptek konfigurálhatók, amelyek importálási és/vagy exportálási műveletek előtt és/vagy után fognak futni. Ezek a funkciók számos elő- és utófeldolgozási műveletet hajtanak végre az identitásfelhasználói és csoportrekordokon.

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

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

• szkript időtúllépése (perc): a szkript automatikus megszakítása előtt futtatott percek száma. Ennek a beállításnak az alapértelmezett értéke 100 , és nullánál (0) 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: a PowerShell-szkript teljes elérési útja, amelyet az importálás után kell futtatni. Ez a beállítás nem kötelező, és nem igényel értéket.
• Az exportálás előtti szkriptfájl: a PowerShell-szkript teljes elérési útja, amelyet az exportálás előtt kell futtatni. 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 saját munkamenetében hajtja végre a konfigurált PowerShell-szkripteket, é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 Futtatási profil 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. A futtatási profilok végrehajtása előtt az összes CSV-fájlnak jelen kell lennie.

PowerShell bemeneti paraméter: OperationType

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

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

Ez a paraméterérték a PowerShell-szkriptek logikája szerint használható a megfelelő előfeldolgozási vagy utófeldolgozási művelet vagy lépés 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 az Ellá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ér minden felhasználó- és csoportrekordjához, 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 ki kell jelö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 az összes kijelölt objektumtípus-séma összes attribútumának normalizált listája látható.

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

Jegyzet

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 az ö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ói vagy csoportobjektumokat vegyen fel a megfelelő CSV-fájljaikba, új összekötőtér-objektumot kell kiépíteni.

Akár a MIM 2016 deklaratív rendelkezés használatával, akár a saját MIM szinkronizálási szabálykiterjesztéseinekírásával, az új összekötőtér-objektumoknak a következő formátumban kell lenniük:

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

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

Komponens	Jegyzetek
CN=[HORGONYÉRTÉK]	A Közös névnek (CN) egyedi értéknek kell lennie, és a kijelölt horgonyszerű mezőjébe kell írni a CSV-fájlban.
Objektum=Felhasználó/Csoport	Ez az összetevő az összekötő objektumtípusát jelzi. Csak a "Felhasználó" vagy a "Csoport" támogatott.
O=CSV	Az összes GCSV-összekötőtér-objektumhoz gyakran használt 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 az egyenértékű kiépítési logikát mutatja be Metaverse Rules Extensionshasználatával.

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 megadva, hogy megfeleljen az LDAP-szintaxisnak.

Fontos

A DN létrehozásakor a horgonyérték helytelenül való elérése invalid‑dn hibát eredményez.

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

Az alábbi szakaszok példákat sorolnak fel a különböző adattípusok CSV-fájlokban való formázására. 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 elválasztó: vessző (,)
• Többértékű elválasztó: Semi-Colon (;)
• Szöveg minősítő: Dupla idézőjelek (")

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

Ha egy sztringérték olyan karaktereket tartalmaz, amelyek egyébként elválasztóként (például vesszőként) értelmezve lennének, az értéknek minősítettnek kell lennie, hogy a CSV-elemző megfelelően értelmezhesse a sztringet egyetlen mezőként.

A következő szakasz CSV-példája bemutatja, hogy a DisplayName mező rendelkezik minősített szövegként formázott értékekkel:

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őn belül, az értékeket a Többértékű elválasztóelválasztóval kell elválasztani. A következő CSV-példa bemutatja, hogyan néz ki 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

Jegyzet

A többértékű sztringek is támogatják a minősített értékek használatát. A szöveges minősített értékeket többértékű elválasztójelek is elválaszthatják.

Példa: Referenciamezők

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. A következő CSV-példában a Manager 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 base64 sztringekké kell konvertálni őket, amelyek ugyanazt a kódolási típust használják, mint a CSV-fájl. Az alábbi szakasz PowerShell-függvénye bemutatja, hogyan kódolhat egy karakterlánc értéket Base64 formátumúra 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 egy szöveg nevű bemeneti paramétert fogad el, é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. A következő 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 csoport tag attribútumon kívül a többértékű referenciaattribútumok nem támogatottak.
  • A hivatkozási é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.