Obecný konektor CSV – technická referenční příručka (Preview)

Tento článek popisuje konektor Generic CSV (GCSV). Článek se vztahuje na následující produkty:

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

Pro MIM 2016 je konektor k dispozici ke stažení z webu Microsoft Download Center.

Pokud chcete vidět tento konektor v akci, přečtěte si podrobný článek o obecném konektoru SQL .

Poznámka

Služba Azure AD zřizování teď poskytuje jednoduché řešení založené na agentech pro zřizování uživatelů do souborů CSV bez úplného nasazení synchronizace MIM. Doporučujeme vyhodnotit, jestli splňuje vaše potřeby. Další informace.

Přehled obecného konektoru CSV

Konektor Generic CSV (GCSV) umožňuje integrovat data identit uživatelů a skupin uchováná v souborech CSV s produkty Microsoftu, jako je Microsoft Entra Connect Provisioning Agent (ECMA2Host) a Microsoft Identity Manager 2016 (MIM2016).

Má různé funkce, jako je například možnost orchestrace použití PowerShellu ke správě dat identit před nebo po operacích importu nebo exportu. Nabízí podporu pro více datových typů, včetně binárních a odkazů, podpory pro kvalifikované řetězcové hodnoty a řetězců s více hodnotami.

Tento článek popisuje funkce obecného konektoru sdíleného svazku clusteru a jeho konfiguraci pro MIM 2016.

V následující tabulce jsou uvedené funkce, které aktuální verze konektoru podporuje z hlavního hlediska:

Funkce	Podrobnosti
Podpora pro více produktů	Použití tohoto konektoru je podporováno v následujících produktech Microsoftu: Microsoft Entra Connect Provisioning Agent (ECMA2Host) Microsoft Identity Manager 2016 (MIM2016)
Podporované soubory CSV	Tento konektor podporuje správu uživatelů (povinné) a skupin (volitelné) prostřednictvím konfigurace až tří souborů CSV: Soubor CSV uživatele (např. Users.csv) Soubor CSV skupin (např. Groups.csv) Soubor CSV členů skupiny (např. Members.csv)
Zpracování před a po operaci pomocí PowerShellu	Tento konektor podporuje konfiguraci až čtyř (4) skriptů PowerShellu pro usnadnění předběžného nebo následného zpracování dat identit uživatelů a skupin před importem nebo exportem nebo po jeho importu nebo exportu.
Podporované kódování souborů CSV	Konektor podporuje všechny výchozí (nebo nainstalované) typy kódování serveru: (např. Unicode, UTF-8, UTF-7, ASCII atd.).
Podporované datové typy polí CSV	Konektor podporuje následující datové typy atributů: Binary – (jako řetězce base64) Logická hodnota – (jako true/false) Celá čísla Řetězce / řetězce s více hodnotami Reference
Oddělovač polí CSV	Podpora pro čárky (,) nebo jakýkoli tisknutelný alfamerický znak pro kvalifikaci začátku a konce libovolné hodnoty řetězce.
Podpora kvalifikace řetězců	Podpora dvojitých uvozovek (") nebo libovolného tisknutelného alfamerického znaku pro kvalifikaci začátku a konce libovolné řetězcové hodnoty.
Podpora vícehodnotových řetězců	Podpora vícehodnotových řetězců
Podporované operace konektoru	Konektor podporuje následující operace: Full Import Export Úplný export
Schéma	Zjišťování schématu je dynamické, ale k dokončení vyžaduje ruční konfiguraci. Pole jsou dynamicky identifikována na základě zadaného oddělovače (nebo označovaného jako oddělovač hodnot). Datové typy polí jsou ručně určeny během konfigurace.

Požadavky

Před použitím konektoru se ujistěte, že na synchronizačním serveru máte následující:

• Microsoft .NET 4.6.2 Framework nebo novější
• Soubory CSV, které obsahují požadované schéma pro následující typy identit:
  • Soubor uživatelů (povinné)
  • Skupiny (volitelné)
  • Členové skupiny (povinné, pokud se používají skupiny)
• (Volitelné) Skripty PowerShellu pro správu předběžného a následného zpracování pro následující události typů operací:
  • Před importem – tento skript se spustí před spuštěním operace importu.
  • Po importu – tento skript se spustí po spuštění operace importu.
  • Před exportem – tento skript se spustí před spuštěním operace exportu.
  • Post-Export – tento skript se spustí po spuštění operace exportu.

Oprávnění účtu synchronizační služby MIM

Důležité

Účet synchronizační služby MIM 2016 je kontext zabezpečení, který provádí operace se soubory se soubory CSV a spouští skripty PowerShellu před a po zpracování. Tento účet služby potřebuje oprávnění ke čtení a zápisu pro všechny nakonfigurované soubory CSV a PowerShellu. Ke spouštění všech nakonfigurovaných skriptů potřebuje také příslušná oprávnění PowerShell ExecutePolicy .

Vytvoření nového konektoru

Následující seznam obsahuje základní přehled kroků popsaných v této příručce. Abyste mohli začít, je potřeba použít účet s rolí MIM Syncs Správa k provádění těchto úloh:

• Otevřete okno Vytvořit nového agenta pro správu (MA) z Service Manager MIM Sync.
• Jako typ konektoru vyberte Obecný konektor CSV .
• Zadejte cestu k souboru a název souboru CSV, který se má importovat nebo exportovat.
• Zadejte kódování souboru, oddělovač hodnot, oddělovač více hodnot a kvalifikátor textu pro soubor CSV.
• Zvolte, jestli chcete hodnoty v prvním řádku použít jako pole záhlaví nebo ne.
• Vyberte typy objektů a atributy, které se mají importovat nebo exportovat ze souboru CSV.
• Nakonfigurujte oddíl, profil spuštění a podrobnosti mapování pro ma.
• Zadejte cesty ke skriptům a parametry pro skripty PowerShellu, pokud existují.
• Spuštěním ma proveďte operace importu, synchronizace nebo exportu.

Pokud chcete vytvořit obecný konektor CSV, v synchronizační službě vyberte Agent pro správu a Vytvořit. Vyberte Konektor Generic CSV (Microsoft).

Připojení

Stránka Připojení obsahuje umístění souborů CSV Uživatelé, Skupiny a Členové skupiny.

Následující obrázek je příkladem stránky Připojení .

Na této stránce jsou uvedena umístění následujících souborů CSV:

• Soubor uživatelů: Plně kvalifikovaná cesta k souboru CSV, který obsahuje záznamy uživatelů a jejich hodnoty atributů. Tento soubor je povinný.
• Soubor skupin: Plně kvalifikovaná cesta k souboru CSV, který obsahuje záznamy skupiny. Tento soubor je volitelný.
• Soubor členů: Plně kvalifikovaná cesta k souboru CSV, který obsahuje referenční záznamy členů skupiny.

Důležité

Účet služby MIM Sync musí mít oprávnění ke čtení a zápisu ke všem určeným souborům CSV. Jak už bylo zmíněno dříve, skupinové a členské soubory nejsou nutné, pokud jsou nakonfigurováni pouze uživatelé.

Obrazovka Připojení je první při vytváření nového obecného konektoru SQL. Nejprve je potřeba zadat následující informace v části:

Možnosti

Tato stránka popisuje možnosti konektoru. Možnosti konektoru jsou pevné a nedají se změnit, ale tady jsou vysvětlené informace o tom, jak konektor funguje.

Následující obrázek je příkladem stránky Capabilities (Možnosti ).

V následující části jsou uvedeny jednotlivé konfigurace a jejich významy:

• Styl rozlišujícího názvu (LDAP): Konektor GCSV používá syntaxi LDAP (Lightweight Directory Access Protocol) k vytvoření DN (rozlišující název) k jedinečné identifikaci každého objektu uživatele nebo skupiny v prostoru konektoru. Všechny hodnoty DN jsou vyjádřeny v následujícím formátu: CN=[ANCHOR_VALUE],Object=[User|Skupina],O=CSV.
• Potvrzení objektu (normální):: Za normálních okolností synchronizační modul předpokládá, že může objekt znovu načíst v následném rozdílovém importu po exportu. Takto obvykle funguje synchronizační modul, ale ne všechny připojené systémy. Toto nastavení Normální zajistí, že se při následném importu nezobrazí žádné exported-change-not-reimported upozornění.
• Typ exportu (MultivaluedReferenceAttributeUpdate): Typ exportu určuje, jak se objekty během synchronizace formátují a odesílají do cílového systému. MultivaluedReferenceAttributeUpdate je typ exportu navržený pro práci s Microsoft Entra ID. Odesílá pouze atributy, které se změnily. Pro atributy typu hodnota používá AttributeReplace a pro referenční atributy používá AttributeUpdate.
• Normalizace (žádné): Normalizace označují standardizaci dat do konzistentního formátu. None znamená, že se nepoužívají žádná specifická pravidla normalizace. Data zůstanou tak, jak jsou, bez jakýchkoli dalších transformací konektoru.

Schéma 1 (Konfigurace formátu souboru CSV)

Konektor GCSV využívá tři druhy oddělovačů (neboli oddělovačů) k oddělení a parsování polí sdíleného svazku clusteru a jejich hodnot.

Tato stránka obsahuje nastavení hodnoty znaků pro tyto oddělovače a typ kódování, který byl použit k vytvoření souboru jako CSV.

Na následujícím obrázku je obrázek stránky Schéma 1 (Konfigurace formátu souboru CSV).

Následující část obsahuje seznam jednotlivých konfigurací:

• Použití hlaviček pro zjišťování schématu: Když vyberete tuto možnost, dá konektoru pokyn, aby první záznam každého souboru CSV zacházal jako se záznamem hlaviček, a ne s datovým záznamem identity. Pokud tato možnost není vybraná, konektor přiřadí název Atribut s přidanou jedinečnou celočíselnou hodnotou (například Atribut1, Atribut2 atd.) a považuje první řádek za datový záznam identity.
• Oddělovač hodnot: Tento znak odděluje pole (tj. hodnoty) záznamů CSV. Čárka (,) je výchozí, ale všechny alfanumerické znaky, které lze vytisknout, jsou povolené.
• Oddělovač více hodnot: Tento typ oddělovače slouží k oddělení jednotlivých hodnot řetězce s více hodnotami (například adres proxy) nebo referenčních atributů (například podřízených). Výchozí hodnota je středník (;) ale jakýkoli tisknutelný alfanumerický znak je přijatelný.
• Textový kvalifikátor: Pokud řetězcová hodnota obsahuje znaky, které by jinak byly interpretovány jako oddělovače (například čárky), vyžaduje, aby hodnota byla kvalifikovaná tak, aby analyzátor CSV mohl správně interpretovat řetězec jako jedno pole. Dvojité uvozovky (") jsou výchozí, ale jsou povoleny všechny alfanumerické znaky, které lze vytisknout.

Poznámka

Přestože schémata souborů CSV nemusí obsahovat žádná pole s více hodnotami nebo nesmí obsahovat žádné hodnoty, které vyžadují řetězcovou kvalifikaci, je vyžadováno označení jedinečného tisknutelného znaku pro každý typ oddělovače.

• Kódování souborů: Toto nastavení označuje kódování použité u souborů CSV přidaných na kartě Připojení. Ujistěte se, že odpovídá kódování souborů CSV.

Poznámka

Pokud si nejste jistí typem kódování souborů CSV, zkuste použít výchozí typ kódování Unicode. Unicode je běžný standard, který podporuje mnoho znaků a symbolů, takže je dobrou volbou pro kódování textových dat ve většině jazyků nebo znakové sady.

Schéma 2 (konfigurace polí identity a odkazu)

Hodnota ukotvení je jedinečný identifikátor záznamu v souboru CSV. Odlišuje jeden záznam od ostatních. Konektor GCSV také používá tuto hodnotu k vytvoření rozlišujícího názvu (DN), který identifikuje související objekt prostoru konektoru.

Na této stránce jsou nastavení atributu ukotvení nastavena pro každý soubor CSV, který je uvedený na stránce Připojení.

Následující obrázek je příkladem stránky Schématu 2 (Konfigurace polí identit a referenčních polí).

Následující část obsahuje seznam jednotlivých konfigurací na této stránce:

• Uživatel
  • Ukotvení uživatele: Pole v souboru Users, které slouží jako hodnota ukotvení záznamu uživatele. První pole záhlaví v souboru Users je výchozí volbou.
  • Typ atributu Ukotvení uživatele: Toto je typ atributu vybrané kotvy.
• Skupina
  • Ukotvení skupiny: Pole v souboru Skupiny, které slouží jako hodnota ukotvení záznamu skupiny. První pole záhlaví v souboru Skupiny je výchozí volbou.
  • Typ atributu Ukotvení skupiny: Toto je typ atributu vybrané kotvy.
• Člen
  • ID nadřazené skupiny: Pole v souboru Členové, které má stejnou hodnotu (ukotvení) jako nadřazená skupina v souboru CSV skupiny. Ve výchozím nastavení se použije první pole v souboru Členové.
  • ID člena: Pole v souboru Členové, které má stejnou hodnotu (ukotvení) jako v souboru CSV Uživatelé nebo skupiny. Ve výchozím nastavení je vybráno druhé pole v souboru Členové.
• Typ objektu člena: Pole, které obsahuje řetězcovou hodnotu "User" nebo "Group", která označuje typ objektu člena. Toto pole je povinné pouze v případě, že soubor člena obsahuje více než dvě pole. Pole Typ objektu musí obsahovat pouze řetězcovou hodnotu User nebo Group. Pokud toto pole chybí, konektor předpokládá, že záznamy souboru Members odkazují na člena objektu User. Třetí pole, které se nachází v souboru Členové, je ve výchozím nastavení vybrané.

Důležité

Názvy atributů určených k použití jako ukotvení musí být jedinečné ve všech schématech typů objektů. To zahrnuje ukotvení zadaná v souboru Členové skupiny.

Schéma 3 (Konfigurace schématu atributu souboru uživatele)

Tato stránka slouží k určení a vysvětlení datového typu jednotlivých polí, která jsou identifikována ve schématu souboru CSV Uživatelé, a k tomu, zda mohou mít více než jednu hodnotu.

Následující obrázek je příkladem stránky Schema 3 (Konfigurace schématu atributů souboru uživatele).

V následující části jsou uvedeny důležité informace o přiřazování datových typů atributů.

Podporované datové typy

Konektor GCSV podporuje použití datových typů následující části:

• Logická hodnota: Hodnota, která může být true nebo false.
• Binární: Hodnota, která je uložena jako posloupnost bajtů, která se obvykle používá k ukládání dat, jako jsou obrázky nebo jiné soubory.
• Celé číslo: hodnota, která je celé číslo bez desetinných míst.
• String: hodnota, která je posloupností znaků, která se obvykle používá k ukládání textových dat.
• Odkaz: Hodnota, která je odkazem na jiný objekt uživatele. Chcete-li zadat referenční hodnotu v souboru CSV, naplňte jeho pole hodnotou ukotvení objektu odkazovaných uživatelů.

Důležité

Atributy odkazu uživatele nebo skupiny lze použít pouze k odkaz na objekty uživatele. To se nevztahuje na atribut Člen objektu Skupiny, který může obsahovat odkazy uživatele i skupiny, pokud je zadáno pole typu objektu.

Podporované datové typy Multiple-Value

Konektor podporuje použití atributů s více hodnotami pouze pro následující datové typy:

• Řetězec

Poznámka

Pokud schéma objektu User i Group mají (neukotvovací) atribut se stejným názvem, nemusí být mezi nimi přiřazeny odlišné datové typy. Oba musí sdílet stejný datový typ.

Schéma 4 (skupiny konfigurace schématu atributů souboru)

Tato stránka slouží k určení a vysvětlení datového typu jednotlivých polí, která jsou identifikována ve schématu souboru CSV skupin, a k tomu, jestli můžou mít více než jednu hodnotu.

Následující obrázek je příkladem stránky Schéma 4 (Konfigurace schématu atributů souboru skupiny).

Pokyny nabízené ve schématu 3 (Konfigurace atributů souborů uživatelů se vztahují také na tuto část. .

Po spuštění počáteční operace úplného importu bude prostor konektoru vypadat podobně jako na následujícím obrázku:

Globální parametry (konfigurace skriptů PowerShellu)

Tato stránka umožňuje konfiguraci skriptů PowerShellu, které se spustí před a/nebo po operacích importu a exportu. Tyto funkce poskytují příležitosti k provádění široké škály akcí předběžného a následného zpracování u záznamů uživatelů a skupin vaší identity.

Následující obrázek je příkladem stránky Globální parametry .

V následující části jsou uvedena jednotlivá nastavení konfigurace na této stránce:

• Časový limit skriptu (minuty): počet minut, po které se skript spustí, než se automaticky přeruší. Výchozí hodnota tohoto nastavení je 100 a vyžaduje hodnotu větší než nula (0).
• Soubor skriptu před importem: plně kvalifikovaná cesta ke skriptu PowerShellu, který by se měl spustit před importem. Toto nastavení je volitelné a nevyžaduje hodnotu.
• Soubor skriptu po importu: plně kvalifikovaná cesta ke skriptu PowerShellu, který by se měl spustit po importu. Toto nastavení je volitelné a nevyžaduje hodnotu.
• Soubor skriptu před exportem: plně kvalifikovaná cesta ke skriptu PowerShellu, která by se měla spustit před exportem. Toto nastavení je volitelné a nevyžaduje hodnotu.
• Soubor skriptu po exportu: plně kvalifikovaná cesta ke skriptu PowerShellu, která by se měla spustit po exportu. Toto nastavení je volitelné a nevyžaduje hodnotu.

Parametry spuštění a vstupních skriptů PowerShellu

Konektor GCSV spouští každý z nakonfigurovaných skriptů PowerShellu ve své vlastní relaci a nepodporuje předávání parametrů mezi fázemi.

Konektor předá do každého skriptu jeden vstupní parametr s názvem OperationType. Hodnota tohoto parametru se liší v závislosti na provedené operaci Profilu spuštění a může to být jedna ze tří hodnot:

Důležité

Dynamické vytváření souborů CSV před operacemi importu nebo exportu není podporováno. Všechny soubory CSV musí být k dispozici před spuštěním libovolného souboru pro profily spuštění.

Vstupní parametr PowerShellu: OperationType

I když se použití vstupních parametrů nepodporuje, konektor GCSV předá do spuštění každého skriptu PowerShellu jeden vstupní parametr: OperationType.

• Úplná – tato hodnota se poskytuje během operací úplného importu nebo úplného exportu.
• Delta – tato hodnota se poskytuje během operací exportu.

Tuto hodnotu parametru je možné použít v rámci logiky skriptů PowerShellu k určení odpovídající operace nebo akce před zpracováním nebo po zpracování, která se má provést.  

Zřizovací hierarchie

Vzhledem k tomu, že soubory CSV neukládají informace v hierarchické struktuře, konektor GCSV nepodporuje žádné konfigurace hierarchického zřizování.

Následující obrázek je příkladem stránky Hierarchie zřizování .

Oddíly a hierarchie

Konektor GCSV vytvoří jedinečný rozlišující název (DN) pro každý záznam uživatele a skupiny v prostoru konektoru v tomto formátu LDAP:

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

Následující obrázek je příkladem stránky Oddíly a hierarchie .

Typy objektů

Konektor GCSV vyžaduje, aby byl vybrán alespoň typ objektu User. Volba typu objektu Group je volitelná.

Následující obrázek je příkladem stránky Typy objektů .

Atributy

Na této stránce se zobrazí normalizovaný seznam všech atributů ve všech schématech vybraných typů objektů.

Následující obrázek je příkladem stránky Atributy .

Poznámka

Atribut Člen bude existovat pouze v případě, že jsou vybrány skupiny a bude obsahovat odkazy na objekty uchovány v souborech CSV členů skupiny.

Kotvy

Konektor GCSV nepodporuje použití složitých ukotvení ani konfigurací atributů ukotvení, které se liší od odpovídajících polí ID ukotvení souboru CSV.

Pokud chcete změnit označení ukotvení zobrazená na této stránce, vraťte se do části Schéma 2 (Konfigurace ukotvení).

Následující obrázek je příkladem stránky Ukotvení .

Zřizování záznamů CSV

Aby konektor GCSV přidal nové objekty uživatele nebo skupiny do příslušných souborů CSV, musí pro něj být zřízen nový objekt prostoru konektoru.

Bez ohledu na to, jestli používáte deklarativní zřizování MIM 2016 nebo píšete vlastní rozšíření pravidel synchronizace MIM, nové objekty prostoru konektorů musí mít dnovou hodnotu vytvořenou v následujícím formátu:

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

Následující tabulka obsahuje podrobnosti o jednotlivých hodnotách komponent:

Součást	Poznámky
CN=[HODNOTA UKOTVENÍ]	Běžný název (CN) musí být jedinečnou hodnotou a zapíše se do pole určeného ukotvení souboru CSV.
Object=Uživatel/skupina	Tato komponenta označuje typ objektu tohoto konektoru. Podporuje pouze uživatele nebo skupinu.
O=CSV	Kořenová komponenta společná pro všechny objekty prostoru konektoru GCSV.

Následující obrázek je synchronizační pravidlo , které ukazuje, jak správně sestavit DN při zřizování nového objektu User do konektoru GCSV:

Následující kód ukazuje ekvivalentní logiku zřizování pomocí rozšíření pravidel Metaverse.

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();
		}
	}
}

Na předchozím obrázku si všimněte použití EcapeDNComponent() funkce k zajištění, že je hodnota ukotvení správně umiscená, aby odpovídala syntaxi LDAP.

Důležité

Nesprávné úniky hodnoty ukotvení při vytváření DN způsobí invalid‑dn chybu.

Příklady formátování polí CSV

Následující části obsahují příklady formátování různých datových typů v souborech CSV. Všechny příklady: Následující část předpokládá použití výchozího nastavení oddělovače polí konektoru:

• Samostatná hodnota: Čárka (,)
• Oddělovač více hodnot: Semi-Colon (;)
• Textový kvalifikátor: Dvojité uvozovky (")

Příklad: Kvalifikace textu

Pokud řetězcová hodnota obsahuje znaky, které by jinak byly interpretovány jako oddělovače (například čárky), vyžaduje, aby hodnota byla kvalifikovaná tak, aby analyzátor CSV mohl správně interpretovat řetězec jako jedno pole.

Následující část CSV příklad ukazuje, jak pole DisplayName obsahuje hodnoty, které jsou formátovány jako kvalifikovaný text:

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

Příklad: Oddělovač vícehodnotových řetězců

Pokud chcete zadat více řetězcových hodnot v jednom řetězcovém poli, oddělte hodnoty oddělovačem více hodnot. Následující část příkladu CSV ukazuje, jak pole ProxyAddress s více hodnotami:

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

Poznámka

Vícehodnotový řetězec také podporuje použití řetězcových kvalifikovaných hodnot. Textové kvalifikované hodnoty mohou být oddělené oddělovači s více hodnotami.

Příklad: Referenční pole

Chcete-li zadat referenční hodnotu v souboru CSV, naplňte jeho pole hodnotou ukotvení objektu odkazovaných uživatelů. V následujícím příkladu csv oddílu obsahuje pole Správce hodnotu ukotvení záznamu uživatele, na který odkazuje:

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

Příklad: Binární pole

Chcete-li v souborech CSV vyjádřit binární hodnoty, musí být převedeny na řetězce base64, které používají stejný typ kódování jako soubor CSV. Následující část funkce PowerShellu ukazuje, jak kódovat řetězcovou hodnotu do řetězce s kódováním base64 v kódování Unicode:

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

Tady je ekvivalentní funkce v jazyce C#, která přijímá vstupní parametr s názvem text a vrací řetězec v kódování Unicode s kódováním base64.

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

Příklad: Logická pole

Soubory CSV, které obsahují logická pole, by měly k označení své hodnoty používat text Pravda nebo Nepravda. Následující část obsahuje

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

Známá omezení

Následující seznam obsahuje známá omezení konektoru GCSV.

• Referenční atributy
  • Kromě atributu člen skupiny nejsou vícehodnotové odkazové atributy podporovány.
  • Referenční hodnota musí odkazovat na objekty uživatele. Odkazy na objekty seskupení nejsou podporovány.
• Kotvy
  • Duplicitní hodnoty ukotvení mezi objekty uživatele a skupiny nejsou podporovány.
  • Názvy atributů ukotvení musí být jedinečné napříč schématy uživatelů a skupin.
• PowerShell
  • Předávání vstupních proměnných do skriptů PowerShellu se nepodporuje.