Algemene CSV-connector - Technische naslaghandleiding (preview)

In dit artikel wordt de algemene CSV-connector (GCSV) beschreven. Het artikel is van toepassing op de volgende producten:

• Microsoft Entra Connect-inrichtingsagent (ECMA2Host)
• Microsoft Identity Manager 2016 (MIM2016)

Voor MIM 2016 is de connector beschikbaar als download in het Microsoft Downloadcentrum.

Zie het stapsgewijze artikel Algemene SQL-connector om deze connector in actie te zien.

Notitie

De Azure AD-inrichtingsservice biedt nu een lichtgewicht oplossing op basis van agents voor het inrichten van gebruikers in CSV-bestanden, zonder een volledige MIM-synchronisatie-implementatie. We raden u aan te evalueren of deze voldoet aan uw behoeften. Meer informatie.

Overzicht van de algemene CSV-connector

Met de algemene CSV-connector (GCSV) kunt u gebruikers- en groepsidentiteitsgegevens die in CSV-bestanden worden onderhouden, integreren met Microsoft-producten, zoals de Microsoft Entra Ecma2Host (Connect Provisioning Agent) en Microsoft Identity Manager 2016 (MIM2016).

Het heeft verschillende functies, zoals de mogelijkheid om het gebruik van PowerShell te organiseren voor het beheren van identiteitsgegevens vóór of na import- of exportbewerkingen. Het biedt ondersteuning voor meerdere gegevenstypen, waaronder binaire en verwijzingen, ondersteuning voor gekwalificeerde tekenreekswaarden en tekenreeksen met meerdere waarden.

In dit artikel worden de functies en functies van de algemene CSV-connector beschreven en hoe u deze configureert voor MIM 2016.

De volgende tabel bevat de functies die door de huidige release van de connector worden ondersteund, op hoog niveau:

Functie	Details
Ondersteuning voor meerdere producten	Het gebruik van deze connector wordt ondersteund met de volgende Microsoft-producten: Microsoft Entra Connect-inrichtingsagent (ECMA2Host) Microsoft Identity Manager 2016 (MIM2016)
Ondersteunde CSV-bestanden	Deze connector ondersteunt het beheer van gebruikers (vereist) en groepen (optioneel), via de configuratie van maximaal drie CSV-bestanden: CSV-bestand van gebruikers (bijvoorbeeld Users.csv) CSV-bestand voor groepen (bijvoorbeeld Groups.csv) CSV-bestand groepsleden (bijvoorbeeld Members.csv)
Verwerking vooraf/na bewerking met PowerShell	Deze connector ondersteunt de configuratie van maximaal vier (4) PowerShell-scripts om voor- of naverwerking van gebruikers- en groepsidentiteitsgegevens vóór of na het importeren of exporteren te vergemakkelijken.
Csv-bestandscodering ondersteund	De connector ondersteunt alle standaard (of geïnstalleerde) servercoderingstypen: (bijvoorbeeld Unicode, UTF-8, UTF-7, ASCII, enzovoort)
Ondersteunde CSV-veldgegevenstypen	De connector ondersteunt de volgende kenmerkgegevenstypen: Binair : (als base64-tekenreeksen) Booleaanse waarde : (als waar/onwaar) Gehele getallen Tekenreeksen/tekenreeksen met meerdere waarden Referentie
CSV-veldscheidingstekens	Ondersteuning voor komma's (,) of een afdrukbaar alfamerisch teken om het begin en einde van een tekenreekswaarde te kwalificeren.
Ondersteuning voor tekenreekskwalificatie	Ondersteuning voor dubbele aanhalingstekens (") of een afdrukbaar alfamerisch teken om het begin en einde van een tekenreekswaarde te kwalificeren.
Ondersteuning voor tekenreeksen met meerdere waarden	Ondersteuning voor tekenreeksen met meerdere waarden
Ondersteunde connectorbewerkingen	De connector ondersteunt de volgende bewerkingen: Volledig importbewerking Exporteren Volledige export
Schema	Schemadetectie is dynamisch, maar vereist handmatige configuratie voor voltooiing. Velden worden dynamisch geïdentificeerd op basis van een opgegeven scheidingsteken (of een waardescheidingsteken genoemd). Veldgegevenstypen worden handmatig aangegeven tijdens de configuratie.

Vereisten

Voordat u de connector gebruikt, moet u ervoor zorgen dat u het volgende op de synchronisatieserver hebt:

• Microsoft .NET 4.6.2 Framework of hoger
• CSV-bestanden die het gewenste schema voor de volgende identiteitstypen bevatten:
  • Gebruikersbestand (vereist)
  • Groepen (optioneel)
  • Groepsleden (vereist als groepen worden gebruikt)
• (Optioneel) PowerShell-scripts voor het beheren van voor- en naverwerking voor de volgende bewerkingstypengebeurtenissen:
  • Vooraf importeren: dit script wordt uitgevoerd voordat een importbewerking wordt uitgevoerd.
  • Post-import: dit script wordt uitgevoerd nadat een importbewerking is uitgevoerd.
  • Pre-Export: dit script wordt uitgevoerd voordat een exportbewerking wordt uitgevoerd.
  • Post-Export: dit script wordt uitgevoerd nadat een exportbewerking is uitgevoerd.

Machtigingen voor MIM-synchronisatieserviceaccounts

Belangrijk

Het MIM 2016-synchronisatieserviceaccount is de beveiligingscontext waarmee de bestandsbewerkingen naar CSV-bestanden worden uitgevoerd en de PowerShell-scripts voor-/naverwerking worden uitgevoerd. Dit serviceaccount heeft lees-/schrijfmachtigingen nodig voor alle CSV- en PowerShell-bestanden die zijn geconfigureerd. Het heeft ook de juiste PowerShell ExecutePolicy-machtigingen nodig om scripts uit te voeren die zijn geconfigureerd.

Een nieuwe connector maken

De volgende lijst is een algemeen overzicht van de stappen die in deze handleiding worden beschreven. Om te beginnen, moet een account met de rol MIM-synchronisaties Beheer worden gebruikt om deze taken uit te voeren:

• Open het venster Create New Management Agent (MA) vanuit de MIM Sync-Service Manager.
• Selecteer de Algemene CSV-connector als het connectortype.
• Geef het bestandspad en de naam op van het CSV-bestand dat moet worden geïmporteerd of geëxporteerd.
• Geef de bestandscodering, het waardescheidingsteken, het scheidingsteken voor meerdere waarden en de tekstkwalificatie voor het CSV-bestand op.
• Kies of u de waarden in de eerste rij als veldnamen wilt gebruiken of niet.
• Selecteer de objecttypen en kenmerken die u wilt importeren of exporteren uit het CSV-bestand.
• Configureer de partitie, voer het profiel uit en de toewijzingsdetails voor de MA.
• Geef de scriptpaden en parameters op voor de PowerShell-scripts, indien van toepassing.
• Voer de MA uit om de import-, synchronisatie- of exportbewerkingen uit te voeren.

Als u een algemene CSV-connector wilt maken, selecteert u in Synchronisatieservicede optie Beheeragent en Maken. Selecteer de Algemene CSV-connector (Microsoft).

Connectiviteit

De pagina Connectiviteit bevat de bestandslocaties van de CSV-bestanden Gebruikers, Groepen en Groepsleden.

De volgende afbeelding is een voorbeeld van de pagina Connectiviteit .

De locaties van de volgende CSV-bestanden worden opgegeven op deze pagina:

• Gebruikersbestand: het volledig gekwalificeerde pad van het CSV-bestand dat de gebruikersrecords en de bijbehorende kenmerkwaarden bevat. Dit bestand is vereist.
• Groepsbestand: het volledig gekwalificeerde pad van het CSV-bestand dat de groepsrecords bevat. Dit bestand is optioneel.
• Ledenbestand: het volledig gekwalificeerde pad van het CSV-bestand dat referentierecords voor groepsleden bevat.

Belangrijk

Het MIM Sync-serviceaccount moet lees- en schrijfmachtigingen hebben voor alle aangewezen CSV-bestanden. Zoals eerder vermeld, zijn de groep- en lidbestanden niet nodig als alleen gebruikers zijn geconfigureerd.

Het scherm Connectiviteit is het eerste wanneer u een nieuwe algemene SQL-connector maakt. U moet eerst de volgende sectiegegevens opgeven:

Functies

Op deze pagina worden de mogelijkheden van de connector beschreven. Connectormogelijkheden zijn vast en kunnen niet worden gewijzigd, maar ze worden hier uitgelegd om informatie te bieden over hoe de connector werkt.

De volgende afbeelding is een voorbeeld van de pagina Mogelijkheden .

In de volgende sectie vindt u een overzicht van de afzonderlijke configuraties en hun betekenis:

• Distinguished Name Style (LDAP): de GCSV-connector gebruikt de syntaxis van LDAP (Lightweight Directory Access Protocol) om de DN (DN-naam) samen te stellen om elk gebruikers- of groepsobject in de connectorruimte uniek te identificeren. Alle DN-waarden worden uitgedrukt in de volgende notatie: CN=[ANCHOR_VALUE],Object=[Gebruiker|Groep],O=CSV.
• Objectbevestiging (normaal): normaal gesproken gaat de synchronisatie-engine ervan uit dat het object opnieuw kan worden opgehaald in een volgende delta-import na een export. Dit is hoe de synchronisatie-engine meestal werkt, maar niet alle verbonden systemen werken op deze manier. Deze instelling van Normaal zorgt ervoor dat er geen exported-change-not-reimported waarschuwing is in de opvolgende import.
• Exporttype (MultivaluedReferenceAttributeUpdate): Het exporttype geeft aan hoe objecten tijdens de synchronisatie worden opgemaakt en naar het doelsysteem worden verzonden. MultivaluedReferenceAttributeUpdate is een exporttype dat is ontworpen voor gebruik met Microsoft Entra ID. Alleen de kenmerken die zijn gewijzigd, worden verzonden. Voor kenmerken van het waardetype wordt AttributeReplace gebruikt en voor referentiekenmerken wordt AttributeUpdate gebruikt.
• Normalisaties (Geen): Normalisaties verwijzen naar het standaardiseren van gegevens naar een consistente indeling. Geen betekent dat er geen specifieke normalisatieregels worden toegepast. Gegevens blijven ongewijzigd zonder extra transformaties door de connector.

Schema 1 (configuraties van CSV-bestandsindeling)

De GCSV-connector maakt gebruik van drie soorten scheidingstekens (of scheidingstekens) om CSV-velden en hun waarden te scheiden en te parseren.

Deze pagina bevat de instellingen voor tekenwaarden voor deze scheidingstekens en het coderingstype dat is gebruikt om het bestand als CSV te maken.

De volgende afbeelding is een afbeelding van de pagina Schema 1 (CSV File Format Configurations).

De volgende sectie bevat een lijst met de afzonderlijke configuraties:

• Headers gebruiken voor schemadetectie: wanneer deze optie is geselecteerd, wordt de connector geïnstrueerd om de eerste record van elk CSV-bestand te behandelen als een headerrecord en niet als een identiteitsgegevensrecord. Als deze optie niet is geselecteerd, wijst de connector de naam Kenmerk toe met een toegevoegde unieke, opgehoogd geheel getalwaarde (bijvoorbeeld Kenmerk1, Kenmerk2, enzovoort) en behandelt de eerste rij van als een identiteitsgegevensrecord.
• Scheidingsteken voor waarden: met dit teken worden de velden (waarden) van de CSV-records gescheiden. De komma (,) is de standaardwaarde, maar elk alfanumeriek teken dat kan worden afgedrukt, is toegestaan.
• Scheidingsteken voor meerdere waarden: dit type scheidingsteken wordt gebruikt om de afzonderlijke waarden van een tekenreeks met meerdere waarden (bijvoorbeeld proxyadressen) of verwijzingskenmerken (bijvoorbeeld ondergeschikten) te scheiden. De standaardwaarde is een puntkomma (;) maar elk afdrukbaar alfanumeriek teken is acceptabel.
• Tekstkwalificatie: wanneer een tekenreekswaarde tekens bevat die anders zouden worden geïnterpreteerd als scheidingstekens (bijvoorbeeld komma's), moet de waarde worden gekwalificeerd, zodat de CSV-parser de tekenreeks correct kan interpreteren als één veld. De dubbele aanhalingstekens (") zijn de standaardwaarde, maar elk alfanumeriek teken dat kan worden afgedrukt, is toegestaan.

Notitie

Hoewel de schema's van CSV-bestanden mogelijk geen velden met meerdere waarden bevatten of geen waarden bevatten waarvoor tekenreekskwalificatie is vereist, is de aanduiding van een uniek afdrukbaar teken voor elk scheidingsteken vereist.

• Bestandscodering: deze instelling geeft de codering aan die wordt gebruikt voor de CSV-bestanden die zijn toegevoegd op het tabblad Connectiviteit. Zorg ervoor dat deze overeenkomt met de codering van uw CSV-bestanden.

Notitie

Als u niet zeker weet wat het coderingstype van uw CSV-bestanden is, kunt u het standaardtype Unicode-codering gebruiken. Unicode is een algemene standaard die veel tekens en symbolen ondersteunt, waardoor het een goede optie is voor het coderen van tekstgegevens in de meeste talen of tekenset die wordt gebruikt.

Schema 2 (configuraties van identiteits- en verwijzingsvelden)

De ankerwaarde is een unieke id voor een record in een CSV-bestand. Het onderscheidt één record van de andere. De GCSV-connector gebruikt deze waarde ook om de DN (Distinguished Name) te maken die het gerelateerde connectorruimteobject identificeert.

Op deze pagina worden de instellingen voor het ankerkenmerk ingesteld voor elk van de CSV-bestanden die worden vermeld op de pagina Connectiviteit.

De volgende afbeelding is een voorbeeld van de pagina Schema 2 (Identiteits- en referentieveldconfiguraties).

De volgende sectie bevat een lijst met de afzonderlijke configuraties op deze pagina:

• Gebruiker
  • Gebruikersanker: het veld in het bestand Gebruikers dat fungeert als de ankerwaarde voor de gebruikersrecord. Het eerste headerveld in het bestand Gebruikers is de standaardkeuze.
  • Kenmerktype Gebruikersanker: dit is het kenmerktype van het geselecteerde anker.
• Groep
  • Groepsanker: het veld in het bestand Groepen dat fungeert als de ankerwaarde voor de groepsrecord. Het eerste veld voor de koptekst in het bestand Groepen is de standaardkeuze.
  • Kenmerktype Groepsanker: dit is het kenmerktype van het geselecteerde anker.
• Lid
  • Bovenliggende groeps-id: het veld in het ledenbestand met dezelfde waarde (anker) als de bovenliggende groep in het CSV-bestand Groepen. Het eerste veld in het bestand Leden wordt standaard gebruikt.
  • Lid-id: het veld in het ledenbestand met dezelfde waarde (anker) als in het CSV-bestand Gebruikers of Groepen. Het tweede veld in het bestand Leden is standaard geselecteerd.
• Objecttype lid: het veld dat een tekenreekswaarde Gebruiker of Groep bevat om het objecttype van het lid aan te geven. Dit veld is alleen vereist als het lidbestand meer dan twee velden bevat. Het veld Objecttype mag alleen de tekenreekswaarde 'Gebruiker' of een 'Groep' bevatten. Als dit veld ontbreekt, wordt in de connector ervan uitgegaan dat de records van het ledenbestand naar een lid van het gebruikersobject verwijzen. Het derde veld in het bestand Leden is standaard geselecteerd.

Belangrijk

De namen van de kenmerken die als ankers moeten worden gebruikt, moeten uniek zijn in alle objecttypeschema's. Dit omvat de ankers die zijn opgegeven in het bestand Groepsleden.

Schema 3 (Schemaconfiguraties voor bestandskenmerken van gebruikers)

Deze pagina is bedoeld voor het opgeven en uitleggen van het gegevenstype van elk van de velden die worden geïdentificeerd in het schema van het CSV-bestand Gebruikers en of deze meer dan één waarde kunnen hebben.

De volgende afbeelding is een voorbeeld van de pagina Schema 3 (Schemaconfiguraties van gebruikersbestandskenmerk).

De volgende sectie bevat overwegingen bij het maken van kenmerkgegevenstypetoewijzingen.

Ondersteunde gegevenstypen

De GCSV-connector ondersteunt het gebruik van de volgende sectiegegevenstypen:

• Booleaanse waarde: een waarde die true of false kan zijn.
• Binair: een waarde die wordt opgeslagen als een reeks bytes, die doorgaans wordt gebruikt voor het opslaan van gegevens, zoals afbeeldingen of andere bestanden.
• Geheel getal: een waarde die een geheel getal is, zonder decimalen.
• Tekenreeks: een waarde die een reeks tekens is, die doorgaans wordt gebruikt voor het opslaan van tekstgegevens.
• Verwijzing: een waarde die een verwijzing is naar een ander gebruikersobject. Als u een referentiewaarde in een CSV-bestand wilt opgeven, vult u het bijbehorende veld in met de ankerwaarde van het gebruikersobject waarnaar wordt verwezen.

Belangrijk

Gebruikers- of groepsreferentiekenmerken kunnen alleen worden gebruikt om te verwijzen naar gebruikersobjecten. Dit geldt niet voor het kenmerk Lid van groepsobjecten, dat zowel gebruikers- als groepsverwijzingen kan bevatten zolang het veld objecttype is opgegeven.

Ondersteunde Multiple-Value gegevenstypen

De connector ondersteunt het gebruik van kenmerken met meerdere waarden voor alleen de volgende gegevenstypen:

• Tekenreeks

Notitie

Als het schema van de objecten Gebruiker en Groep beide een (niet-anker) kenmerk met dezelfde naam hebben, kunnen er geen verschillende gegevenstypen tussen worden toegewezen. Ze moeten allebei hetzelfde gegevenstype delen.

Schema 4 (Schemaconfiguraties voor groepsbestandskenmerken)

Deze pagina is bedoeld voor het opgeven en uitleggen van het gegevenstype van elk van de velden die worden geïdentificeerd in het schema van het CSV-bestand groepen en of deze meer dan één waarde kunnen hebben.

De volgende afbeelding is een voorbeeld van de pagina Schema 4 (Schemaconfiguraties voor groepskenmerken van bestandskenmerken).

De richtlijnen in Schema 3 (Configuraties van gebruikersbestandskenmerken zijn ook van toepassing op deze sectie. .

Nadat een initiële volledige importbewerking is uitgevoerd, ziet de connectorruimte er ongeveer als volgt uit:

Algemene parameters (Configuratie van PowerShell-scripts)

Op deze pagina kunt u PowerShell-scripts configureren die vóór en/of na import- en/of exportbewerkingen worden uitgevoerd. Deze functies bieden mogelijkheden om een breed scala aan bewerkingen voor en na verwerking uit te voeren op uw identiteitsgebruikers- en groepsrecords.

De volgende afbeelding is een voorbeeld van de pagina Globale parameters .

De volgende sectie bevat de afzonderlijke configuratie-instellingen op deze pagina:

• Scripttime-out (minuten): het aantal minuten dat een script wordt uitgevoerd voordat het automatisch wordt afgebroken. De standaardwaarde voor deze instelling is 100 en vereist een waarde die groter is dan nul (0).
• Pre-import scriptbestand: het volledig gekwalificeerde pad naar het PowerShell-script dat moet worden uitgevoerd vóór een import. Deze instelling is optioneel en vereist geen waarde.
• Scriptbestand na import: het volledig gekwalificeerde pad naar het PowerShell-script dat moet worden uitgevoerd na een import. Deze instelling is optioneel en vereist geen waarde.
• Pre-exportscriptbestand: het volledig gekwalificeerde pad naar het PowerShell-script dat moet worden uitgevoerd vóór een export. Deze instelling is optioneel en vereist geen waarde.
• Scriptbestand na export: het volledig gekwalificeerde pad naar het PowerShell-script dat moet worden uitgevoerd na een export. Deze instelling is optioneel en vereist geen waarde.

PowerShell-scriptuitvoerings- en invoerparameters

De GCSV-connector voert elk van de geconfigureerde PowerShell-scripts uit in een eigen sessie en biedt geen ondersteuning voor het doorgeven van parameters tussen fasen wordt niet ondersteund.

De connector geeft één invoerparameter door aan elk script met de naam OperationType. De waarde van deze parameter varieert afhankelijk van de bewerking Profiel uitvoeren die wordt uitgevoerd en kan een van de drie waarden zijn:

Belangrijk

Het dynamisch maken van CSV-bestanden vóór import- of exportbewerkingen wordt niet ondersteund. Alle CSV-bestanden moeten aanwezig zijn voordat een van de uitvoeringsprofielen wordt uitgevoerd.

PowerShell-invoerparameter: OperationType

Hoewel het gebruik van invoerparameters niet wordt ondersteund, geeft de GCSV-connector wel één invoerparameter door voor de uitvoering van elk PowerShell-script: OperationType.

• Volledig : deze waarde wordt opgegeven tijdens volledige import- of volledige exportbewerkingen.
• Delta : deze waarde wordt opgegeven tijdens exportbewerkingen.

Deze parameterwaarde kan worden gebruikt in de logica van de PowerShell-scripts om te bepalen welke bewerking vóór/na de verwerking moet worden uitgevoerd of welke actie moet worden uitgevoerd.  

Inrichtingshiërarchie

Omdat CSV-bestanden geen informatie opslaan in een hiërarchische structuur, biedt de GCSV Connector geen ondersteuning voor hiërarchische inrichtingsconfiguraties.

De volgende afbeelding is een voorbeeld van de pagina Inrichtingshiërarchie .

Partities en hiërarchieën

De GCSV-connector bouwt een unieke DN (Distinguished Name) voor elke gebruikers- en groepsrecord in de connectorruimte, volgens deze LDAP-indeling:

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

De volgende afbeelding is een voorbeeld van de pagina Partities en hiërarchieën .

Objecttypen

Voor de GCSV-connector moet ten minste het objecttype Gebruiker zijn geselecteerd. De keuze van het groepsobjecttype is optioneel.

De volgende afbeelding is een voorbeeld van de pagina Objecttypen .

Kenmerken

Op deze pagina wordt een genormaliseerde lijst weergegeven met alle kenmerken in alle geselecteerde objecttypeschema's.

De volgende afbeelding is een voorbeeld van de pagina Kenmerken .

Notitie

Het kenmerk Lid bestaat alleen als Groepen zijn geselecteerd en bevat de verwijzingen naar objecten die worden onderhouden in de CSV-bestanden van de groepsleden.

Ankers

De GCSV-connector biedt geen ondersteuning voor het gebruik van complexe ankers of configuraties van ankerkenmerken die afwijken van de anker-id-velden van het bijbehorende CSV-bestand.

Als u ankeraanduidingen wilt wijzigen die op deze pagina worden weergegeven, gaat u terug naar Schema 2 (Ankerconfiguraties).

De volgende afbeelding is een voorbeeld van de pagina Ankers .

CSV-records inrichten

Als u wilt dat de GCSV-connector nieuwe gebruikers- of groepsobjecten toevoegt aan de bijbehorende CSV-bestanden, moet er een nieuw connectorruimteobject voor worden ingericht.

Of u nu MIM 2016-declaratieve inrichting gebruikt of uw eigen extensies voor MIM-synchronisatieregels schrijft, nieuwe Connector Space-objecten moeten een DN hebben die is samengesteld met de volgende indeling:

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

De volgende tabel bevat details over elk van de onderdeelwaarden:

Onderdeel	Notities
CN=[ANKERWAARDE]	De algemene naam (CN) moet een unieke waarde zijn voor en wordt geschreven in het aangewezen ankerveld van het CSV-bestand.
Object=Gebruiker/Groep	Dit onderdeel geeft het objecttype van deze connector aan. Ondersteunt alleen 'Gebruiker' of 'Groep'.
O=CSV	Het hoofdonderdeel dat gemeenschappelijk is voor alle GCSV-connectorruimteobjecten.

De volgende afbeelding is een synchronisatieregel die laat zien hoe u een DN correct maakt bij het inrichten van een nieuw gebruikersobject in een GCSV-connector:

De volgende code demonstreert de equivalente inrichtingslogica met behulp van Metaverse Rules Extensions.

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

In de vorige afbeelding ziet u het gebruik van de EcapeDNComponent() functie om ervoor te zorgen dat de ankerwaarde correct wordt ge escaped om te voldoen aan de LDAP-syntaxis.

Belangrijk

Het onjuist ontsnappen van de ankerwaarde bij het maken van een DN resulteert in een invalid‑dn fout.

Voorbeelden van CSV-veldopmaak

De volgende secties bevatten voorbeelden van het opmaken van verschillende gegevenstypen in CSV-bestanden. Alle voorbeelden In de volgende sectie wordt ervan uitgegaan dat de standaardinstellingen voor veldscheidingstekens van de connector worden gebruikt:

• Waarde gescheiden: komma (,)
• Scheidingsteken voor meerdere waarden: Semi-Colon (;)
• Tekstscheidingsteken: Dubbele aanhalingstekens (")

Voorbeeld: Tekstkwalificatie

Als een tekenreekswaarde tekens bevat die anders zouden worden geïnterpreteerd als scheidingstekens (bijvoorbeeld komma's), moet de waarde worden gekwalificeerd, zodat de CSV-parser de tekenreeks correct kan interpreteren als één veld.

In het volgende csv-voorbeeld van de sectie ziet u hoe het veld DisplayName waarden bevat die zijn opgemaakt als gekwalificeerde tekst:

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

Voorbeeld: Tekenreeksen met meerdere waarden scheidingstekens

Als u meerdere tekenreekswaarden in één tekenreeksveld wilt opgeven, moet u de waarden scheiden met het scheidingsteken voor meerdere waarden. In het volgende csv-voorbeeld van de sectie ziet u hoe het veld ProxyAddress meerdere waarden bevat:

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

Notitie

Tekenreeks met meerdere waarden ondersteunt ook het gebruik van gekwalificeerde tekenreekswaarden. Door tekst gekwalificeerde waarden kunnen worden gescheiden door scheidingstekens met meerdere waarden.

Voorbeeld: Verwijzingsvelden

Als u een referentiewaarde in een CSV-bestand wilt opgeven, vult u het veld in met de ankerwaarde van het gebruikersobject waarnaar wordt verwezen. In het volgende csv-voorbeeld van de sectie bevat het veld Manager de ankerwaarde van de gebruikersrecord waarnaar het verwijst:

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

Voorbeeld: Binaire velden

Als u binaire waarden in CSV-bestanden wilt uitdrukken, moeten ze worden geconverteerd naar base64-tekenreeksen die hetzelfde coderingstype gebruiken als het CSV-bestand. De volgende sectie PowerShell-functie laat zien hoe u een tekenreekswaarde coderen in de base64 gecodeerde tekenreeks in Unicode:

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

Dit is de equivalente functie in C# die een invoerparameter met de naam tekst accepteert en een base64-gecodeerde tekenreeks in Unicode retourneert.

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

Voorbeeld: Booleaanse velden

CSV-bestanden die Booleaanse velden bevatten, moeten de tekst Waar of Onwaar gebruiken om hun waarde aan te geven. De volgende sectie is een

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

Bekende beperkingen

De volgende lijst bevat de bekende beperkingen van de GCSV-connector.

• Referentiekenmerken
  • Afgezien van het kenmerk lid van de groep, worden verwijzingskenmerken met meerdere waarden niet ondersteund.
  • De referentiewaarde moet verwijzen naar gebruikersobjecten. Verwijzingen naar groepsobjecten worden niet ondersteund.
• Ankers
  • Dubbele ankerwaarden tussen gebruikers- en groepsobjecten worden niet ondersteund.
  • De namen van de ankerkenmerken moeten uniek zijn in gebruikers- en groepsschema's.
• PowerShell
  • Het doorgeven van invoervariabelen aan PowerShell-scripts wordt niet ondersteund.