Algemene CSV-connector - Stapsgewijze naslaghandleiding (preview)
In dit artikel wordt de algemene CSV-connector beschreven. Het artikel is van toepassing op de volgende producten:
Voor MIM 2016 is de connector beschikbaar als download in het Microsoft Downloadcentrum.
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.
De CSV-voorbeeldbestanden voorbereiden
Op een server waarop de MIM-synchronisatieserver wordt uitgevoerd, maakt u de map C:\GCSV en kopieert u de volgende CSV-bestanden in bijlage A – Voorbeeld van CSV-bestanden . Zorg ervoor dat u het MIM-synchronisatieserviceaccount zowel lees- als schrijfmachtigingen voor die map verleent.
Kopieer het volgende CSV-bestand naar de map C:\GCSV\SCRIPTS :
- CSV-voorbeeldbestand van gebruikers (Users.csv)
- CSV-bestand voor voorbeeldgroepen (Groups.csv)
- CSV-voorbeeldbestand voor leden (Members.csv)
Notitie
In deze handleiding wordt ervan uitgegaan dat de CSV-bestanden zich in het volgende pad op uw MIM-synchronisatieserver bevinden: C:\GCSV en dat ze worden opgeslagen met behulp van de aangegeven bestandsnamen. Als u ze op een andere locatie installeert of de naam van deze bestanden wijzigt, moet u de juiste wijzigingen aanbrengen via het opnieuw instellen van deze handleiding.
De PowerShell-voorbeeldscripts voorbereiden
Op een server waarop de MIM-synchronisatieserver wordt uitgevoerd, maakt u de map C:\GCSV\SCRIPTS en kopieert u de PowerShell-voorbeeldscripts in bijlage B - PowerShell-voorbeeldbestanden . Zorg ervoor dat het MIM-synchronisatieserviceaccount de juiste PowerShell ExecutePolicy-machtigingen heeft om de scripts uit te voeren.
Kopieer de volgende PowerShell-scripts naar de map C:\GCSV\SCRIPTS :
- Voorbeeld van pre-importscript (Pre-Import.ps1)
- Voorbeeldscript na importeren (Post-Import.ps1)
- Voorbeeld van pre-exportscript (Pre-Export.ps1)
- Voorbeeldscript na export (Post-Export.ps1)
Notitie
In deze handleiding wordt ervan uitgegaan dat de CSV-bestanden zich in het volgende pad op de MIM-synchronisatieserver bevinden: C:\GCSV\SCRIPTS. Als u ze op een andere locatie installeert, moet u de juiste wijzigingen aanbrengen via het opnieuw instellen van deze handleiding.
Belangrijk
Het account van de MIM-synchronisatieservice vereist de juiste PowerShell ExecutePolicy-machtigingen op de MIM-synchronisatieserver om de PowerShell-voorbeeldscripts uit te voeren.
Een nieuwe connector maken
De volgende lijst is een algemeen overzicht van de stappen die in deze handleiding worden beschreven. Om dit te kunnen doen, moet een account met de mim-synchronisaties Beheer rol worden gebruikt om de volgende 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.
- Selecteer de objecttypen en kenmerken die u wilt importeren of exporteren uit het CSV-bestand.
- Configureer de partitie, het uitvoeringsprofiel 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.
- Evalueer de resultaten.
Laten we beginnen!
Als u een algemene CSV-connector wilt maken, selecteert u in Service Manager MIM-synchronisatiede optie Beheeragent en Maken. Selecteer de Algemene CSV-connector (Microsoft).
Probide de naam voor de connector (bijvoorbeeld : Algemene CSV) en klik op de knop Volgende .
Connectiviteit
De pagina Connectiviteit bevat de bestandspaden waar de connector de CSV-bestanden Gebruiker, Groepen en Groepsleden kan vinden.
De volgende afbeelding is een voorbeeld van de pagina Connectiviteit :
Hier volgt een lijst met de waarden die moeten worden opgegeven voor de instellingen op deze pagina:
| Instellingsnaam | Waarde instellen | Notities |
|---|---|---|
| Gebruikersbestand | C:\GCSV\USERS.CSV | (Het volledig gekwalificeerde pad en de gebruikte bestandsnaam.) |
| Groepsbestand | C:\GCSV\GROUPS.CSV | (Het volledig gekwalificeerde pad en de gebruikte bestandsnaam.) |
| Ledenbestand | C:\GCSV\MEMBERS.CSV | (Het volledig gekwalificeerde pad en de gebruikte bestandsnaam.) |
Nadat u hebt gecontroleerd of de instellingen overeenkomen met de opgegeven waarden, klikt u op de knop Volgende .
Functies
Op deze pagina worden de mogelijkheden van de connector beschreven. De mogelijkheden van de GCSV-connector zijn vast en kunnen niet worden gewijzigd.
De volgende afbeelding is een voorbeeld van de pagina Mogelijkheden :
Raadpleeg de Generic CSV Connector – Technical Reference Guide voor een gedetailleerde beschrijving van de instellingen voor deze mogelijkheden.
Nadat u de configuraties over hebt bekeken, klikt u op de knop Volgende .
Schema 1 (configuraties van CSV-bestandsindeling)
De algemene CSV-connector (GCSV) maakt gebruik van drie soorten scheidingstekens (of scheidingstekens) voor het scheiden en parseren van CSV-velden en hun waarden: waardescheidingstekens, scheidingstekens met meerdere waarden en tekstscheidingstekens. Zie de Algemene CSV-connector – Technische handleiding voor meer informatie over deze scheidingstekens
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 voorbeeld van de pagina Schema 1 (CSV File Format Configurations):
De volgende sectie bevat een lijst met de afzonderlijke configuraties:
- Kopteksten gebruiken voor schemadetectie: als deze optie is geselecteerd, wordt de connector geïnstrueerd om de eerste record van elk CSV-bestand te negeren als een gegevensrecord en deze te gebruiken als een headerrecord (met de namen van elk veld).) Als deze optie niet is geselecteerd, geeft de connector een algemene naam aan elk veld (bijvoorbeeld Kenmerk1, Kenmerk2, enzovoort) en gebruikt de eerste rij als een gegevensrecord.
- 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.
- Tekstscheidingsteken: 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. De dubbele aanhalingstekens (") zijn de standaardwaarde, maar elk alfanumeriek teken dat kan worden afgedrukt, is toegestaan.
- 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 bouwen die het connectorruimteobject uniek 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).
In de volgende tabel staan de afzonderlijke waarden die moeten worden toegewezen aan elk van de instellingen op deze pagina:
| Instellingsnaam | Waarde instellen |
|---|---|
| Record-id van gebruikers | Employeeid |
| Kenmerktype Veld van gebruikersrecord-id | Tekenreeks |
| Veld Groepsrecord-id | GroupID |
| Kenmerktype Veld van groepsrecord-id | Tekenreeks |
| Bovenliggende groeps-id | ParentID |
| Lid-id | MemberID |
| Objecttype lid | ObjectType |
Nadat u hebt gecontroleerd of de instellingen overeenkomen met de opgegeven waarden, klikt u op de knop Volgende .
Schema 3 (schemaconfiguraties voor gebruikersbestandskenmerken)
Deze pagina wordt gebruikt om een gegevenstype toe te wijzen voor elk kenmerk in het schema van het CSV-bestand Gebruikers en of ze meer dan één waarde kunnen hebben.
De volgende afbeelding is een voorbeeld van de pagina Schema 3 (Schemaconfiguraties van gebruikersbestandskenmerken).
In de volgende tabel staan de afzonderlijke waarden die moeten worden toegewezen aan elk van de instellingen op deze pagina:
| Instellingsnaam | Waarde instellen | Notities |
|---|---|---|
| Kenmerktype DisplayName | Tekenreeks | Voorbeelden van gekwalificeerde tekenreeksen bevinden zich in dit veld |
| DisplayName heeft meerdere waarden | Valse | -- |
| Kenmerktype AccountName | Tekenreeks | -- |
| AccountName heeft meerdere waarden | Valse | -- |
| Kenmerktype CountryCode | Geheel getal | -- |
| CountryCode heeft meerdere waarden | Valse | -- |
| Type managerkenmerk | Verwijzing | Bevat de ankerkenmerkwaarden van hun toegewezen beheerdersgebruikersrecord (bijvoorbeeld E001) |
| Manager heeft meerdere waarden | Valse | -- |
| Kenmerktype ProxyAddresses | Tekenreeks | -- |
| ProxyAddresses heeft meerdere waarden | TRUE | Bevat voorbeelden van het afbakenen van tekenreeksen met meerdere waarden |
| IsActive-kenmerktype | Booleaanse | -- |
| IsActive heeft meerdere waarden | Valse | -- |
| Kenmerktype ProfilePic | Binair | -- |
| ProfilePic heeft meerdere waarden | Valse | -- |
Nadat u hebt gecontroleerd of de instellingen overeenkomen met de opgegeven waarden, klikt u op de knop Volgende .
Schema 4 (schemaconfiguraties voor groepsbestandskenmerken)
Deze pagina wordt gebruikt om een gegevenstype toe te wijzen voor elk kenmerk in het schema van het CSV-bestand groepen en of ze meer dan één waarde kunnen hebben.
De volgende afbeelding is een voorbeeld van de pagina Schema 4 (Schemaconfiguraties van groepsbestandskenmerken).
In de volgende tabel staan de afzonderlijke waarden die moeten worden toegewezen aan elk van de instellingen op deze pagina:
| Instellingsnaam | Waarde instellen | Notities |
|---|---|---|
| Kenmerktype DisplayName | Tekenreeks | -- |
| DisplayName heeft meerdere waarden | Valse | Biedt een voorbeeld van gekwalificeerde tekenreekswaarden. |
| Type beschrijvingskenmerk | Tekenreeks | -- |
| Beschrijving heeft meerdere waarden | Valse | -- |
| Kenmerktype eigenaar | Verwijzing | Biedt een voorbeeld van referentiewaarden. |
| Eigenaar heeft meerdere waarden | Valse | -- |
Nadat u hebt gecontroleerd of de instellingen overeenkomen met de opgegeven waarden, klikt u op de knop Volgende .
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. De waarde van deze invoerparameters biedt een mogelijkheid om een groot aantal bewerkingen voor en na verwerking uit te voeren op uw identiteitsgebruikers- en groepsrecords.
De volgende afbeelding is een voorbeeld van de pagina Globale parameters .
In de volgende tabel staan de afzonderlijke waarden die moeten worden toegewezen aan elk van de instellingen op deze pagina:
| Instellingsnaam | Waarde instellen | Notities |
|---|---|---|
| Bestand vooraf importeren | C:\GCSV\SCRIPTS\PRE-IMPORT.CSV | Dit script wordt uitgevoerd vóór een volledige import |
| Bestand na importeren | C:\GCSV\SCRIPTS\POST-IMPORT.CSV | Dit script wordt uitgevoerd na een volledige import |
| Bestand vóór exporteren | C:\GCSV\SCRIPTS\PRE-EXPORT.CSV | Dit script wordt uitgevoerd vóór een volledige export of (delta)export |
| Bestand na export | C:\GCSV\SCRIPTS\POST-EXPORT.CSV | Dit script wordt uitgevoerd vóór een volledige export of (delta)export |
Nadat u hebt gecontroleerd of de instellingen overeenkomen met de opgegeven waarden, klikt u op de knop Volgende .
Uitvoering van PowerShell-script
De GCSV-connector voert elk geconfigureerd PowerShell-script uit in een eigen sessie en biedt geen ondersteuning voor het doorgeven van variabelen tussen de uitvoering van scripts.
Bovendien voert de GCSV-connector het PowerShell-script uit in de bestanden, niet als een cmdlet. Dit betekent dat invoerparameters niet kunnen worden doorgegeven aan scripts door ze toe te voegen aan het einde van hun padinstructies. Als u dit doet, mislukt de uitvoering van het script.
Belangrijk
De GCSV-connector biedt geen ondersteuning voor het gebruik van het doorgeven van invoerparameters bij het uitvoeren van de PowerShell-scripts.
Als een pre-import of pre-export scriptuitvoering een uitzondering genereert, om te voorkomen dat onjuist verwerkte gebruikers- of groepsrecords worden geïmporteerd of geëxporteerd, zal de GCSV-connector de uitvoering van het hele uitvoeringsprofiel afbreken en stoppen.
Als een bewerking na het importeren of exporteren een uitzondering aantreft, mislukt de bewerkingsstatus.
Fouten die zijn opgetreden tijdens het uitvoeren van het PowerShell-script, worden geregistreerd in het *Gebeurtenis*-logboek van de MIM-synchronisatieserver.
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.
De invoervariabele OperationType heeft de waarde Volledig of Delta om het type bewerking weer te geven (bijvoorbeeld Volledig importeren, Delta Importeren, Volledig exporteren, (Delta) Exporteren) dat wordt uitgevoerd met het script. Met deze waarde kunnen scripts controleren of ze worden uitgevoerd onder een volledige of delta-import-/exportcontext en hun taken voor- of naverwerking dienovereenkomstig uitvoeren.
Inrichtingshiërarchie
Omdat CSV-bestanden geen informatie opslaan in een hiërarchische structuur; de algemene CSV-connector biedt geen ondersteuning voor configuraties voor hiërarchische inrichting.
De volgende afbeelding is een voorbeeld van de pagina Inrichtingshiërarchie .
Nadat u hebt gecontroleerd of de instellingen overeenkomen met de opgegeven waarden, klikt u op de knop Volgende .
Partities en hiërarchieën
De algemene CSV-connector bouwt een unieke DN -naam (DN) 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 .
Nadat u hebt gecontroleerd of de instellingen overeenkomen met de opgegeven waarden, klikt u op de knop Volgende .
Objecttypen
Voor de algemene CSV-connector moet ten minste het objecttype Gebruiker worden opgegeven. De keuze van het groepsobjecttype is optioneel.
De volgende afbeelding is een voorbeeld van de pagina Objecttypen .
Nadat u hebt gecontroleerd of de instellingen overeenkomen met de opgegeven waarden, klikt u op de knop Volgende .
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 .
Nadat u hebt gecontroleerd of de instellingen overeenkomen met de opgegeven waarden, klikt u op de knop Volgende .
Notitie
Ankerkenmerken zijn altijd vereist om de GCSV-connector goed te laten werken.
Ankers
De algemene CSV-connector biedt geen ondersteuning voor het gebruik van complexe ankers of configuraties van ankerkenmerken die verschillen van de veldaanduiding anker-id van het bijbehorende object van het CSV-bestand. Daarom zijn de ankerselectievelden vergrendeld. Als u een wijziging wilt aanbrengen in de toewijzing van het ankerkenmerk, gaat u terug naar de pagina Schema 2 (Configuraties voor identiteits- en verwijzingsvelden).
De volgende afbeelding is een voorbeeld van de pagina Ankers .
Nadat u de standaardinstellingen op de pagina hebt bekeken, klikt u op de knop Volgende .
Connectorfilters
Deze handleiding maakt geen gebruik van connectorfilterconfiguraties. Deze sectie is hier om continuïteit in de handleiding te bieden.
De volgende afbeelding is een voorbeeld van de pagina Connectorfilters .
Nadat u de standaardinstellingen op de pagina hebt bekeken, klikt u op de knop Volgende .
Regels voor deelname en projectie
In deze handleiding wordt geen gebruikgemaakt van configuraties voor join- en projectieregels. Deze sectie is hier om continuïteit in de handleiding te bieden.
De volgende afbeelding is een voorbeeld van de pagina Join- en Projectieregels .
Nadat u de standaardinstellingen op de pagina hebt bekeken, klikt u op de knop Volgende .
Kenmerkstroom
Deze handleiding maakt geen gebruik van configuraties van kenmerkstroomregels. Deze sectie is hier om continuïteit in de handleiding te bieden.
De volgende afbeelding is een voorbeeld van de pagina Kenmerkstroom .
Nadat u hebt gecontroleerd of de instellingen overeenkomen met de standaardwaarden, klikt u op de knop Volgende .
Inrichting ongedaan maken
In deze handleiding worden de standaardinstellingen voor het ongedaan maken van de inrichting van deze connector niet gewijzigd. Deze sectie is hier om continuïteit in de handleiding te bieden.
De volgende afbeelding is een voorbeeld van de pagina Inrichting ongedaan maken .
Nadat u hebt gecontroleerd of de instellingen overeenkomen met de standaardwaarden, klikt u op de knop Volgende .
Een volledig importrunprofiel maken
Een volledig importuitvoeringsprofiel is vereist om gebruikers- en groepsidentiteitsgegevens uit de CSV-records te importeren in Connector Space-objecten.
Gebruik de volgende stappen om een nieuw profiel voor volledige importuitvoering te maken:
- Terug naar de Service Manager Synchronisatie.
- Selecteer de GCSV-beheeragent.
- Klik er met de rechtermuisknop op en kies Uitvoeringsprofielen configureren.
- Klik op Nieuw profiel.
Het venster Run Profile configureren wordt weergegeven.
Geef het run-profiel de naam
Voer op de pagina Profielnaam de naam Volledige import in
De volgende afbeelding is een voorbeeld van de pagina Profiel.
Nadat u hebt gecontroleerd of de instellingen overeenkomen met de opgegeven waarden, klikt u op de knop Volgende .
Type opgeven
Selecteer op de pagina Stap configureren het type: Volledige import.
De connectorfiltering werkt op dezelfde manier in de GCSV-connector als in elke andere ECMA-connector.
De volgende afbeelding is een voorbeeld van de pagina Connectorfilter .
Nadat u hebt gecontroleerd of de instellingen overeenkomen met de opgegeven waarden, klikt u op de knop Volgende .
Configuratietype beheeragent
Controleer op de pagina Configuratietype beheeragent of de O=CSV-partitie is geselecteerd.
Laat de standaardwaarden voor de overige instellingen ongewijzigd. Als u op de knop Voltooien klikt, wordt het uitvoeringsprofiel gemaakt.
Resultaten valideren
In deze sectie worden de stappen beschreven die nodig zijn voor het valideren van de resultaten van het maken van een nieuwe GCSV-connector en het importeren van de gebruikers- en groepsrecords uit de CSV-voorbeeldbestanden.
Volledige import uitvoeren
Nadat u het Run-profiel hebt gemaakt, gebruikt u de volgende stappen om dit nieuwe profiel voor volledige importuitvoering uit te voeren:
- Terug naar het Service Manager Synchronisatie.
- Selecteer de GCSV-beheeragent.
- Klik er met de rechtermuisknop op en kies Uitvoeren.
- Selecteer Volledig importeren en klik op OK.
Resultaten van volledige importbewerking valideren
Er moeten vijf (5) oplagen zijn op basis van de inhoud van de CSV-voorbeeldbestanden:
De volgende afbeelding is een voorbeeld van de resultaten van het importeren van de inhoud van de CSV-voorbeeldbestanden:
De GCSV-connectorruimte onderzoeken
Nadat u het Run-profiel hebt gemaakt, voert u de volgende stappen uit om dit nieuwe profiel voor volledige importuitvoering uit te voeren:
- Terug naar het Service Manager Synchronisatie.
- Selecteer de beheeragent van de GCSV-connector .
- Klik er met de rechtermuisknop op en kies Search Verbindingslijn.
- Laat het bereik ingesteld op de standaardwaarde Substructuur en klik op de knop Search.
De volgende afbeelding is een voorbeeld van het venster Search Connectorruimte dat wordt weergegeven.
Gebruikersobject valideren
Selecteer een van de gebruikersobjecten voor inspectie. De volgende afbeelding is een voorbeeld van het GCSV-connectorruimteobject van een gebruiker:
Onderzoek van het veld DisplayName laat zien hoe een gekwalificeerde tekenreeks correct is geparseerd.
Als u op de knop in de vermelding ProxyAddresses klikt, ziet u dat de tekenreeks met meerdere waarden ook correct is geparseerd in afzonderlijke waarden:
Groepsobject valideren
Een van de groepsobjecten selecteren voor inspectie. De volgende afbeelding is een voorbeeld van het GCSV-connectorruimteobject van een groep:
Als u op de knop in de vermelding Lid klikt, ziet u hoe de gekoppelde records voor groepsleden met het ledenbestand correct zijn geladen als leden:
PowerShell-uitvoeringslogboeken valideren
De PowerShell-voorbeeldscripts in deze handleiding zijn ontworpen om een CSV-vermelding toe te voegen aan een centraal logboek om de geslaagde uitvoering te demonstreren.
De standaardlocatie voor dit logboek is C:\GCSV\PS_Run_Ledger.csv.
Als u het logboek opent, wordt het volgende weergegeven:
"DateTime","Stage","Name","Type","Description"
"3/17/2024 1:05:44 PM","Pre","Import","Full","The Pre-Import PowerShell script was executed successfully."
"3/17/2024 1:05:46 PM","Pre","Import","Full","The Post-Import PowerShell script was executed successfully."
Deze twee records geven aan dat zowel de PowerShell-scripts vooraf als na het importeren zijn uitgevoerd. Opmerking het veld Type geeft aan dat deze PowerShell-scripts zijn uitgevoerd tijdens een volledige importbewerking. Deze waarden worden opgehaald uit de PowerShell-invoerparameter OperationType die aangeeft of het script is uitgevoerd tijdens een volledige of Delta-bewerking.
Bijlage A - Voorbeeld van CSV-bestanden
De volgende secties bevatten de CSV-bestanden die in deze handleiding worden gebruikt.
CSV-bestand van voorbeeldgebruikers
In de configuratie van de connector wordt in deze handleiding uitgegaan van de bestandsnaam van USERS.CSV.
EmployeeID,DisplayName,AccountName,CountryCode,Manager,ProxyAddresses,IsActive,ProfilePic
E001,"Smith, John",JS001,1,,SMTP:john.smith@contoso.com;smtp:js001@contoso.com,True,SgBTADAAMAAxAA==
E002,"Doe, Jane",JD003,1,E001,SMTP:jane.doe@contoso.com;smtp:jd002@contoso.com,True,SgBEADAAMAAyAA==
E003,"Perez, Juan",JP003,1,E001,SMTP:juan.perez@contoso.com;smtp:jp003@contoso.com,False,SgBEADAAMAAyAA==
CSV-bestand voor voorbeeldgroepen
In de configuratie van de connector wordt in deze handleiding uitgegaan van de bestandsnaam van GROUPS.CSV.
GroupID,DisplayName,Description,Owner
G001,Test Group (G001),"This group is for teams A, B, and C",E002
G002,Test Group (G002),"This group is for teams D, E, and F",E003
CSV-voorbeeldbestand voor leden
In de configuratie van de connector wordt in deze handleiding uitgegaan van de bestandsnaam van MEMBERS.CSV.
ParentID,MemberID,ObjectType
G001,E001,USER
G001,E002,USER
G001,E003,USER
G002,E001,USER
G002,E002,USER
G002,E003,USER
G002,G001,GROUP
G003,E001,USER
G003,E002,USER
G003,E003,USER
G003,G001,GROUP
Bijlage B - PowerShell-voorbeeldbestanden
Deze bijlage bevat de set PowerShell-voorbeeldscripts die in deze handleiding worden gebruikt. In de volgende secties worden enkele overwegingen beschreven die moeten worden gemaakt wanneer
Belangrijk
elk gebruik van write-hostopdrachten in de PowerShell-scripts zorgt ervoor dat het uitvoeren van het script mislukt.
Voorbeeld van een PowerShell-script dat vooraf wordt geïmporteerd
In de configuratie van de connector wordt in deze handleiding uitgegaan van de bestandsnaam van PRE-IMPORT.PS1.
param ([string]$OperationType)
[string]$stage = "Pre"
[string]$operation = "Import"
[string]$filePath = "C:\GCSV\PS_Run_Ledger.csv"
# Create a new record
$record = [PSCustomObject]@{
"DateTime" = (Get-Date).ToString()
"Stage" = $stage
"Type" = $OperationType
"Name" = $operation
"Description" = "The $stage-$operation PowerShell script was successfully executed before a $OperationType-$operation."
}
$record | Export-Csv -Path $FilePath -NoTypeInformation -Append
PowerShell-voorbeeldscript na import
In de configuratie van de connector wordt in deze handleiding uitgegaan van de bestandsnaam van POST-IMPORT.PS1.
param ([string]$OperationType)
[string]$stage = "Post"
[string]$operation = "Import"
[string]$filePath = "C:\GCSV\PS_Run_Ledger.csv"
# Create a new record
$record = [PSCustomObject]@{
"DateTime" = (Get-Date).ToString()
"Stage" = $stage
"Type" = $OperationType
"Name" = $operation
"Description" = "The $stage-$operation PowerShell script was successfully executed after a $OperationType-$operation."
}
$record | Export-Csv -Path $FilePath -NoTypeInformation -Append
Voorbeeld van Een PowerShell-script vooraf exporteren
In de configuratie van de connector wordt in deze handleiding uitgegaan van de bestandsnaam van PRE-EXPORT.PS1.
param ([string]$OperationType)
[string]$stage = "Pre"
[string]$operation = "Export"
[string]$filePath = "C:\GCSV\PS_Run_Ledger.csv"
# Create a new record
$record = [PSCustomObject]@{
"DateTime" = (Get-Date).ToString()
"Stage" = $stage
"Type" = $OperationType
"Name" = $operation
"Description" = "The $stage-$operation PowerShell script was successfully executed before a $OperationType-$operation."
}
$record | Export-Csv -Path $FilePath -NoTypeInformation -Append
PowerShell-voorbeeldscript na export
In de configuratie van de connector wordt in deze handleiding uitgegaan van de bestandsnaam van POST-EXPORT.PS1.
param ([string]$OperationType)
[string]$stage = "Post"
[string]$operation = "Export"
[string]$filePath = "C:\GCSV\PS_Run_Ledger.csv"
# Create a new record
$record = [PSCustomObject]@{
"DateTime" = (Get-Date).ToString()
"Stage" = $stage
"Type" = $OperationType
"Name" = $operation
"Description" = "The $stage-$operation PowerShell script was successfully executed after a $OperationType-$operation."
}
$record | Export-Csv -Path $FilePath -NoTypeInformation -Append