Generischer CSV-Connector – Schritt-für-Schritt-Referenzhandbuch (Vorschau)

In diesem Artikel wird der generische CSV-Connector beschrieben. Der Artikel bezieht sich auf folgende Produkte:

• Microsoft Identity Manager 2016 (MIM2016)

Für MIM 2016 steht der Connector im Microsoft Download Center als Download zur Verfügung.

Hinweis

Der Azure AD-Bereitstellungsdienst bietet jetzt eine einfache agentbasierte Lösung für die Bereitstellung von Benutzern in CSV-Dateien ohne vollständige MIM-Synchronisierungsbereitstellung. Es wird empfohlen, zu bewerten, ob es Ihren Anforderungen entspricht. Weitere Informationen.

Vorbereiten der CSV-Beispieldateien

Erstellen Sie auf einem Server, auf dem der MIM-Synchronisierungsserver ausgeführt wird, den Ordner C:\GCSV , und kopieren Sie die folgenden CSV-Dateien in Anhang A – Csv-Beispieldateien . Stellen Sie sicher, dass Sie dem KONTO des MIM-Synchronisierungsdiensts lese- und schreibberechtigungen für diesen Ordner erteilen.

Kopieren Sie die folgende CSV-Datei in den Ordner C:\GCSV\SCRIPTS :

• CSV-Beispieldatei für Benutzer (Users.csv)
• CSV-Beispieldatei für Gruppen (Groups.csv)
• CSV-Beispieldatei für Member (Members.csv)

Hinweis

In diesem Leitfaden wird davon ausgegangen, dass sich die CSV-Dateien im folgenden Pfad auf Ihrem MIM-Synchronisierungsserver befinden: C:\GCSV und dass sie mit den angegebenen Dateinamen gespeichert werden. Wenn Sie sie an einem anderen Speicherort installieren oder diese Dateien umbenennen, müssen Sie die entsprechenden Änderungen durch das Zurücksetzen dieses Handbuchs vornehmen.

Vorbereiten der PowerShell-Beispielskripts

Erstellen Sie auf einem Server, auf dem der MIM-Synchronisierungsserver ausgeführt wird, den Ordner C:\GCSV\SCRIPTS , und kopieren Sie die PowerShell-Beispielskripts in Anhang B – PowerShell-Beispieldateien . Stellen Sie sicher, dass das KONTO des MIM-Synchronisierungsdiensts über die entsprechenden PowerShell ExecutePolicy-Berechtigungen verfügt , um die Skripts auszuführen.

Kopieren Sie die folgenden PowerShell-Skripts in den Ordner C:\GCSV\SCRIPTS :

• Beispielskript vor dem Import (Pre-Import.ps1)
• Beispielskript nach dem Import (Post-Import.ps1)
• Beispielskript vor dem Export (Pre-Export.ps1)
• Beispielskript nach dem Export (Post-Export.ps1)

Hinweis

In diesem Leitfaden wird davon ausgegangen, dass sich die CSV-Dateien im folgenden Pfad auf Ihrem MIM-Synchronisierungsserver befinden: C:\GCSV\SCRIPTS. Wenn Sie sie an einem anderen Speicherort installieren, müssen Sie die entsprechenden Änderungen durch das Zurücksetzen dieses Handbuchs vornehmen.

Wichtig

Das MIM-Synchronisierungsdienstkonto erfordert die entsprechenden PowerShell ExecutePolicy-Berechtigungen auf dem MIM-Synchronisierungsserver, um die PowerShell-Beispielskripts auszuführen.

Erstellen eines neuen Connectors

Die folgende Liste enthält eine allgemeine Übersicht über die in diesem Leitfaden beschriebenen Schritte. Um zu sein, muss ein Konto mit der Rolle MIM-Synchronisierungen Admin verwendet werden, um die folgenden Aufgaben auszuführen:

• Öffnen Sie das Fenster Neuen Verwaltungs-Agent (MA) erstellen über die MIM-Synchronisierungs-Service Manager.
• Wählen Sie den generischen CSV-Connector als Connectortyp aus.
• Geben Sie den Dateipfad und den Namen der CSV-Datei an, die importiert oder exportiert werden soll.
• Geben Sie die Dateicodierung, das Werttrennzeichen, das Mehrwerttrennzeichen und den Textqualifizierer für die CSV-Datei an.
• Wählen Sie aus, ob die Werte in der ersten Zeile als Kopfzeilenfelder verwendet werden sollen oder nicht.
• Wählen Sie die Objekttypen und Attribute aus, die aus der CSV-Datei importiert oder exportiert werden sollen.
• Konfigurieren Sie die Partition, das Ausführen des Profils und die Zuordnungsdetails für den MA.
• Geben Sie ggf. die Skriptpfade und Parameter für die PowerShell-Skripts an.
• Führen Sie den MA aus, um die Import-, Synchronisierungs- oder Exportvorgänge auszuführen.
• Bewerten Sie die Ergebnisse.

Fangen wir an!

Um einen generischen CSV-Connector zu erstellen, wählen Sie unter MIM-Synchronisierung Service ManagerVerwaltungs-Agent und Erstellen aus. Wählen Sie den Generischen CSV-Connector (Microsoft) aus.

Probide den Namen für den Connector (z. B . generisches CSV), und klicke auf die Schaltfläche Weiter .

Konnektivität

Die Seite Konnektivität enthält die Dateipfade, in denen der Connector die CSV-Dateien "Benutzer", "Gruppen" und "Gruppenmitglieder" finden kann.

Die folgende Abbildung zeigt ein Beispiel für die Konnektivitätsseite :

Im Folgenden finden Sie eine Liste der Werte, die für die Einstellungen auf dieser Seite angegeben werden sollten:

Einstellungsname	Wert festlegen	Hinweise
Benutzerdatei	C:\GCSV\USERS.CSV	(Der vollqualifizierte Pfad und der verwendete Dateiname.)
Gruppendatei	C:\GCSV\GROUPS.CSV	(Der vollqualifizierte Pfad und der verwendete Dateiname.)
Memberdatei	C:\GCSV\MEMBERS.CSV	(Der vollqualifizierte Pfad und der verwendete Dateiname.)

Nachdem Sie überprüft haben, ob die Einstellungen mit den angegebenen Werten übereinstimmen, klicken Sie auf die Schaltfläche Weiter .

Funktionen

Auf dieser Seite werden die Funktionen des Connectors beschrieben. Die GCSV-Connectorfunktionen sind behoben und können nicht geändert werden.

Die folgende Abbildung zeigt ein Beispiel für die Seite "Funktionen" :

Eine ausführliche Beschreibung dieser Funktioneneinstellungen finden Sie im Leitfaden zum generischen CSV-Connector – Technische Referenz.

Nachdem Sie die Konfigurationen überprüft haben, klicken Sie auf die Schaltfläche Weiter .

Schema 1 (CSV-Dateiformatkonfigurationen)

Der Generische CSV-Connector (GCSV) verwendet drei Arten von Trennzeichen (oder Trennzeichen), um CSV-Felder und deren Werte zu trennen und zu analysieren: Werttrennzeichen, Mehrwerttrennzeichen und Textqualifizierer. Ausführlichere Erläuterungen zu diesen Trennzeichentypen finden Sie im Leitfaden zum generischen CSV-Connector – Technische Referenz

Diese Seite enthält die Zeichenwerteinstellungen für diese Trennzeichen und den Codierungstyp, der zum Erstellen der Datei als CSV verwendet wurde.

Die folgende Abbildung zeigt ein Beispiel für die Seite Schema 1 (CSV-Dateiformatkonfigurationen):

Der folgende Abschnitt enthält eine Liste der einzelnen Konfigurationen:

• Verwenden von Headern für die Schemaermittlung: Wenn diese Option ausgewählt ist, weist sie den Connector an, den ersten Datensatz jeder CSV-Datei als Datensatz zu ignorieren und ihn als Headerdatensatz zu verwenden (d. h., der die Namen der einzelnen Felder enthält.) Wenn diese Option nicht ausgewählt ist, gibt der Connector jedem Feld einen generischen Namen (z. B. Attribut1, Attribut2 usw.) und verwendet die erste Zeile als Datensatz.
• Wertetrennzeichen: Dieses Zeichen trennt die Felder (d. h. Werte) der CSV-Datensätze. Das Komma (,) ist die Standardeinstellung, aber jedes alphanumerische Zeichen, das gedruckt werden kann, ist zulässig.
• Mehrwerttrennzeichen: Dieser Typ von Trennzeichen wird verwendet, um die einzelnen Werte einer mehrwertigen Zeichenfolge (z. B. Proxyadressen) oder Verweisattributen (z. B. Untergeordnete) zu trennen. Der Standardwert ist ein Semikolon (;) aber jedes druckbare alphanumerische Zeichen ist akzeptabel.
• Textqualifizierer: Wenn ein Zeichenfolgenwert Zeichen enthält, die andernfalls als Trennzeichen interpretiert würden (z. B. Kommas), muss der Wert qualifiziert sein, damit der CSV-Parser die Zeichenfolge ordnungsgemäß als einzelnes Feld interpretieren kann. Die doppelten Anführungszeichen (") sind standardmäßig, aber alle alphanumerischen Zeichen, die gedruckt werden können, sind zulässig.
• Dateicodierung: Diese Einstellung gibt die Codierung an, die für die CSV-Dateien verwendet wird, die auf der Registerkarte Konnektivität hinzugefügt wurden. Stellen Sie sicher, dass sie mit der Codierung Ihrer CSV-Dateien übereinstimmt.

Hinweis

Wenn Sie sich über den Codierungstyp Ihrer CSV-Dateien nicht sicher sind, sollten Sie versuchen, den Standardmäßigen Unicode-Codierungstyp zu verwenden. Unicode ist ein gängiger Standard, der viele Zeichen und Symbole unterstützt, sodass es eine gute Option zum Codieren von Textdaten in den meisten Sprachen oder Zeichensätze ist.

Schema 2 (Identitäts- und Referenzfeldkonfigurationen)

Der Ankerwert ist ein eindeutiger Bezeichner für einen Datensatz in einer CSV-Datei. Es unterscheidet einen Datensatz von den anderen. Der GCSV-Connector verwendet diesen Wert auch, um den distinguished Name (DN) zu erstellen, der sein Connectorraumobjekt eindeutig identifiziert.

Auf dieser Seite werden die Ankerattributeeinstellungen für jede der CSV-Dateien eingerichtet, die auf der Seite Konnektivität aufgeführt sind.

Die folgende Abbildung ist ein Beispiel für die Seite Schema 2 (Identitäts- und Referenzfeldkonfigurationen).

In der folgenden Tabelle sind die einzelnen Werte aufgeführt, die den einzelnen Einstellungen auf dieser Seite zugewiesen werden sollten:

Einstellungsname	Wert festlegen
Benutzerdatensatz-ID-Feld	EmployeeID
Attributtyp des Benutzerdatensatz-ID-Felds	String
Feld "Gruppendatensatz-ID"	GroupID
Gruppendatensatz-ID Feldattributetyp	String
Übergeordnete Gruppen-ID	ParentID
Mitglieds-ID	MemberID
Elementobjekttyp	ObjectType

Nachdem Sie überprüft haben, ob die Einstellungen mit den angegebenen Werten übereinstimmen, klicken Sie auf die Schaltfläche Weiter .

Schema 3 (Benutzerdateiattribute Schemakonfigurationen)

Diese Seite wird verwendet, um jedem Attribut im Schema der Benutzer-CSV-Datei einen Datentyp zuzuweisen und ob sie mehrere Werte aufweisen können.

Die folgende Abbildung ist ein Beispiel für die Seite Schema 3 (Benutzerdateiattribute Schemakonfigurationen).

In der folgenden Tabelle sind die einzelnen Werte aufgeführt, die den einzelnen Einstellungen auf dieser Seite zugewiesen werden sollten:

Einstellungsname	Wert festlegen	Hinweise
DisplayName-Attributtyp	String	Beispiele für qualifizierte Zeichenfolgen befinden sich in diesem Feld
DisplayName ist mehrwertig	false	--
AccountName-Attributtyp	String	--
AccountName ist mehrwertig	false	--
CountryCode-Attributtyp	Integer	--
CountryCode ist mehrwertig	false	--
Manager-Attributtyp	Referenz	Enthält die Ankerattributewerte des zugewiesenen Manager-Benutzerdatensatzes (z. B. E001)
Manager ist mehrwertig	false	--
ProxyAddresses-Attributtyp	String	--
ProxyAddresses ist mehrwertig	TRUE	Enthält Beispiele zum Trennen von mehrwertigen Zeichenfolgen
IsActive-Attributtyp	Boolescher Wert	--
IsActive ist mehrwertig	false	--
ProfilePic-Attributtyp	Binär (Binary)	--
ProfilePic ist mehrwertig	false	--

Nachdem Sie überprüft haben, ob die Einstellungen mit den angegebenen Werten übereinstimmen, klicken Sie auf die Schaltfläche Weiter .

Schema 4 (Gruppen-Attributschemakonfigurationen)

Diese Seite wird verwendet, um jedem Attribut im Schema der GRUPPEN-CSV-Datei einen Datentyp zuzuweisen und ob sie mehr als einen Wert aufweisen können.

Die folgende Abbildung ist ein Beispiel für die Seite Schema 4 (Gruppendateiattribute Schemakonfigurationen).

In der folgenden Tabelle sind die einzelnen Werte aufgeführt, die den einzelnen Einstellungen auf dieser Seite zugewiesen werden sollten:

Einstellungsname	Wert festlegen	Hinweise
DisplayName-Attributtyp	String	--
DisplayName ist mehrwertig	false	Stellt ein Beispiel für qualifizierte Zeichenfolgenwerte bereit.
Description-Attributtyp	String	--
Beschreibung ist mehrwertig	false	--
Besitzerattributetyp	Referenz	Stellt ein Beispiel für Verweiswerte bereit.
Besitzer ist mehrwertig	false	--

Nachdem Sie überprüft haben, ob die Einstellungen mit den angegebenen Werten übereinstimmen, klicken Sie auf die Schaltfläche Weiter .

Globale Parameter (PowerShell-Skriptkonfiguration)

Diese Seite ermöglicht die Konfiguration von PowerShell-Skripts, die vor und/oder nach Import- und/oder Exportvorgängen ausgeführt werden. Der Wert dieser Eingabeparameter bietet die Möglichkeit, eine Vielzahl von Vor- und Nachverarbeitungsaktionen für Ihre Identitätsbenutzer- und Gruppendatensätze auszuführen.

Die folgende Abbildung ist ein Beispiel für die Seite Globale Parameter .

In der folgenden Tabelle sind die einzelnen Werte aufgeführt, die den einzelnen Einstellungen auf dieser Seite zugewiesen werden sollten:

Einstellungsname	Wert festlegen	Hinweise
Datei vor dem Importieren	C:\GCSV\SCRIPTS\PRE-IMPORT.CSV	Dieses Skript wird vor einem vollständigen Import ausgeführt.
Datei nach dem Import	C:\GCSV\SCRIPTS\POST-IMPORT.CSV	Dieses Skript wird nach einem vollständigen Import ausgeführt.
Datei vor dem Exportieren	C:\GCSV\SCRIPTS\PRE-EXPORT.CSV	Dieses Skript wird vor einem vollständigen Export oder (Delta-)Export ausgeführt.
Datei nach dem Export	C:\GCSV\SCRIPTS\POST-EXPORT.CSV	Dieses Skript wird vor einem vollständigen Export oder (Delta-)Export ausgeführt.

Nachdem Sie überprüft haben, ob die Einstellungen mit den angegebenen Werten übereinstimmen, klicken Sie auf die Schaltfläche Weiter .

PowerShell-Skriptausführung

Der GCSV-Connector führt jedes konfigurierte PowerShell-Skript in einer eigenen Sitzung aus und bietet keine Unterstützung für das Übergeben von Variablen zwischen der Ausführung von Skripts.

Darüber hinaus führt der GCSV-Connector das PowerShell-Skript in den Dateien aus, nicht als Cmdlet. Dies bedeutet, dass Eingabeparameter nicht an Skripts übergeben werden können, indem sie am Ende ihrer Path-Anweisungen hinzugefügt werden. Dies führt dazu, dass die Ausführung des Skripts fehlschlägt.

Wichtig

Der GCSV-Connector unterstützt die Verwendung der Übergabe von Eingabeparametern bei der Ausführung der PowerShell-Skripts nicht.

Wenn eine Skriptausführung vor dem Import oder Vorabexport eine Ausnahme auslöst, wird der GCSV-Connector abgebrochen und die Ausführung des gesamten Ausführungsprofils abgebrochen, um das Importieren oder Exportieren nicht ordnungsgemäß verarbeiteter Benutzer- oder Gruppendatensätze zu verhindern.

Wenn bei einem Vorgang nach dem Import oder nach dem Export eine Ausnahme auftritt, führt dies dazu, dass der Vorgang status fehlschlägt.

Fehler, die während der Ausführung von PowerShell-Skripts auftreten, werden im *Ereignisprotokoll des MIM-Synchronisierungsservers protokolliert.

PowerShell-Eingabeparameter: OperationType

Obwohl die Verwendung von Eingabeparametern nicht unterstützt wird, übergibt der GCSV-Connector einen Eingabeparameter an die Ausführung jedes PowerShell-Skripts: OperationType.

Die Eingabevariable OperationType weist den Wert Full oder Delta auf, um die Art des Vorgangs anzuzeigen (z. B. Vollständiger Import, Deltaimport, vollständiger Export, (Delta)-Export), der mit dem Skript ausgeführt wird. Mit diesem Wert können Skripts überprüfen, ob sie unter einem vollständigen oder deltabasierten Import-/Exportkontext ausgeführt werden, und ihre Vor- oder Nachverarbeitungsaufgaben entsprechend ausführen.

Bereitstellungshierarchie

Da CSV-Dateien keine Informationen in einer hierarchischen Struktur speichern; Der generische CSV-Connector unterstützt keine hierarchischen Bereitstellungskonfigurationen.

Die folgende Abbildung zeigt ein Beispiel für die Seite "Bereitstellungshierarchie" .

Nachdem Sie überprüft haben, ob die Einstellungen mit den angegebenen Werten übereinstimmen, klicken Sie auf die Schaltfläche Weiter .

Partitionen und Hierarchien

Der generische CSV-Connector erstellt einen eindeutigen Distinguished Name (DN) für jeden Benutzer- und Gruppendatensatz in seinem Connectorbereich und folgt diesem LDAP-Format:

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

Die folgende Abbildung zeigt ein Beispiel für die Seite Partitionen und Hierarchien .

Nachdem Sie überprüft haben, ob die Einstellungen mit den angegebenen Werten übereinstimmen, klicken Sie auf die Schaltfläche Weiter .

Objekttyp

Für den generischen CSV-Connector muss mindestens der Objekttyp User angegeben werden. Die Auswahl des Group-Objekttyps ist optional.

Die folgende Abbildung zeigt ein Beispiel für die Seite Objekttypen .

Nachdem Sie überprüft haben, ob die Einstellungen mit den angegebenen Werten übereinstimmen, klicken Sie auf die Schaltfläche Weiter .

Attribute

Auf dieser Seite wird eine normalisierte Liste aller Attribute für alle ausgewählten Objekttypschemas angezeigt.

Die folgende Abbildung ist ein Beispiel für die Seite Attribute .

Nachdem Sie überprüft haben, ob die Einstellungen mit den angegebenen Werten übereinstimmen, klicken Sie auf die Schaltfläche Weiter .

Hinweis

Ankerattribute sind immer erforderlich, damit der GCSV-Connector ordnungsgemäß funktioniert.

Anchors

Der generische CSV-Connector unterstützt nicht die Verwendung komplexer Anker oder Ankerattributekonfigurationen, die sich von der Anker-ID-Feldbezeichnung der entsprechenden CSV-Datei des entsprechenden Objekts unterscheiden. Aus diesem Grund sind die Ankerauswahlfelder gesperrt. Kehren Sie zur Seite Schema 2 (Identitäts- und Verweisfeldkonfigurationen) zurück, um eine Änderung der Ankerattributebezeichnung vorzunehmen.

Die folgende Abbildung zeigt ein Beispiel für die Seite Anker .

Nachdem Sie die Standardeinstellungen auf der Seite überprüft haben, klicken Sie auf die Schaltfläche Weiter .

Connectorfilter

In diesem Leitfaden werden keine Connectorfilterkonfigurationen verwendet. In diesem Abschnitt wird die Kontinuität im Leitfaden bereitgestellt.

Die folgende Abbildung zeigt ein Beispiel für die Seite Connectorfilter .

Nachdem Sie die Standardeinstellungen auf der Seite überprüft haben, klicken Sie auf die Schaltfläche Weiter .

Zusammenführungs- und Projektionsregeln

In diesem Leitfaden werden keine Join- und Projektionsregelnkonfigurationen verwendet. In diesem Abschnitt wird die Kontinuität im Leitfaden bereitgestellt.

Die folgende Abbildung zeigt ein Beispiel für die Seite Verknüpfungs- und Projektionsregeln .

Nachdem Sie die Standardeinstellungen auf der Seite überprüft haben, klicken Sie auf die Schaltfläche Weiter .

Attributfluss

In dieser Anleitung werden keine Konfigurationen von Attributflussregeln verwendet. In diesem Abschnitt wird die Kontinuität im Leitfaden bereitgestellt.

Die folgende Abbildung ist ein Beispiel für die Seite Attributfluss .

Nachdem Sie überprüft haben, ob die Einstellungen mit den Standardwerten übereinstimmen, klicken Sie auf die Schaltfläche Weiter .

Aufheben der Bereitstellung

In diesem Leitfaden werden die Standardeinstellungen für die Aufhebung der Bereitstellung dieses Connectors nicht geändert. In diesem Abschnitt wird die Kontinuität im Leitfaden bereitgestellt.

Die folgende Abbildung zeigt ein Beispiel für die Seite Aufhebung der Bereitstellung .

Nachdem Sie überprüft haben, ob die Einstellungen mit den Standardwerten übereinstimmen, klicken Sie auf die Schaltfläche Weiter .

Erstellen eines vollständigen Importausführungsprofils

Ein vollständiges Importausführungsprofil ist erforderlich, um Benutzer- und Gruppenidentitätsdaten aus den CSV-Datensätzen in Connectorbereichsobjekte zu importieren.

Führen Sie die folgenden Schritte aus, um ein neues Vollständiges Importausführungsprofil zu erstellen:

• Zurück zum Service Manager Synchronisierung.
• Wählen Sie den GCSV-Verwaltungs-Agent aus.
• Klicken Sie mit der rechten Maustaste darauf, und wählen Sie Ausführungsprofile konfigurieren aus.
• Klicken Sie auf Neues Profil.

Das Fenster Ausführungsprofil konfigurieren wird angezeigt.

Benennen Sie das Ausführungsprofil.

Geben Sie auf der Seite Profilname den Namen Vollständiger Import ein.

Die folgende Abbildung ist ein Beispiel für die Profilseite.

Nachdem Sie überprüft haben, ob die Einstellungen mit den angegebenen Werten übereinstimmen, klicken Sie auf die Schaltfläche Weiter .

Typ angeben

Wählen Sie auf der Seite Schritt konfigurieren den Typ: Vollständiger Import aus.

Die Connectorfilterung funktioniert im GCSV-Connector genauso wie in jedem anderen ECMA-Connector.

Die folgende Abbildung zeigt ein Beispiel für die Seite Connectorfilter .

Nachdem Sie überprüft haben, ob die Einstellungen mit den angegebenen Werten übereinstimmen, klicken Sie auf die Schaltfläche Weiter .

Konfigurationstyp des Verwaltungs-Agents

Stellen Sie auf der Seite Konfigurationstyp des Verwaltungs-Agents sicher, dass die O=CSV-Partition ausgewählt ist.

Behalten Sie für die restlichen Einstellungen die Standardwerte bei. Wenn Sie auf die Schaltfläche Fertig stellen klicken, wird das Ausführungsprofil erstellt.

Überprüfen der Ergebnisse

In diesem Abschnitt werden die schritte beschrieben, die zum Überprüfen der Ergebnisse der Erstellung eines neuen GCSV-Connectors und zum Importieren der Benutzer- und Gruppendatensätze aus den CSV-Beispieldateien erforderlich sind.

Vollständigen Import ausführen

Führen Sie nach dem Erstellen des Ausführungsprofils die folgenden Schritte aus, um dieses neue Vollständige Importausführungsprofil auszuführen:

• Zurück zum Service Manager Synchronisierung.
• Wählen Sie den GCSV-Verwaltungs-Agent aus.
• Klicken Sie mit der rechten Maustaste darauf, und wählen Sie Ausführen aus.
• Wählen Sie Vollständig importieren aus, und klicken Sie auf OK.

Überprüfen der Ergebnisse des vollständigen Importvorgangs

Es sollte fünf (5) Adds basierend auf dem Inhalt der CSV-Beispieldateien geben:

Die folgende Abbildung zeigt ein Beispiel für die Ergebnisse des erfolgreichen Importierens des Inhalts der CSV-Beispieldateien:

Untersuchen des GCSV-Connectorbereichs

Führen Sie nach dem Erstellen des Run-Profils die folgenden Schritte aus, um dieses neue vollständige Importausführungsprofil auszuführen:

• Zurück zum Service Manager Synchronisierung.
• Wählen Sie den GCSV Connector-Verwaltungs-Agent aus.
• Klicken Sie mit der rechten Maustaste darauf, und wählen Sie Search Connectorraum aus.
• Überlassen Sie den Bereich dem Standardwert Subtree, und klicken Sie auf die Schaltfläche Search.

Die folgende Abbildung ist ein Beispiel für das fenster Search Connectorraum, das angezeigt wird.

Überprüfen des Benutzerobjekts

Wählen Sie eines der Benutzerobjekte für die Überprüfung aus. Die folgende Abbildung ist ein Beispiel für das GCSV-Connectorraumobjekt eines Benutzers:

Die Untersuchung des Felds DisplayName zeigt, wie eine qualifizierte Zeichenfolge ordnungsgemäß analysiert wurde.

Wenn Sie im Eintrag ProxyAddresses auf die Schaltfläche klicken, wird angezeigt, dass die mehrwertige Zeichenfolge auch ordnungsgemäß in einzelne Werte analysiert wurde:

Überprüfen des Gruppenobjekts

Auswählen eines der Gruppenobjekte für die Überprüfung. Die folgende Abbildung ist ein Beispiel für das GCSV-Connectorraumobjekt einer Gruppe:

Durch Klicken auf die Schaltfläche innerhalb des Member-Eintrags wird angezeigt, wie die zugeordneten Datensätze der Gruppendateimitgliedsdatensätze mit der Members-Datei ordnungsgemäß als Member geladen wurden:

Überprüfen von PowerShell-Ausführungsprotokollen

Die in diesem Leitfaden bereitgestellten PowerShell-Beispielskripts sind darauf ausgelegt, einem zentralen Protokoll einen CSV-Eintrag hinzuzufügen, um die erfolgreiche Ausführung zu veranschaulichen.

Der Standardspeicherort für dieses Protokoll ist C:\GCSV\PS_Run_Ledger.csv.

Das Öffnen des Protokolls zeigt Folgendes an:

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

Diese beiden Datensätze weisen darauf hin, dass sowohl die PowerShell-Skripts "Pre-Import" als auch "Post-Import" erfolgreich ausgeführt wurden. Beachten Sie, dass das Feld Typ angibt, dass diese PowerShell-Skripts während eines vollständigen Imports ausgeführt wurden. Diese Werte werden vom PowerShell-Eingabeparameter OperationType abgerufen, der angibt, ob das Skript während eines Full- oder Delta-Vorgangs ausgeführt wurde.

Anhang A: CSV-Beispieldateien

Die folgenden Abschnitte enthalten die in diesem Handbuch verwendeten CSV-Dateien.

CSV-Beispieldatei für Benutzer

In der Konfiguration des Connectors wird in dieser Anleitung der Dateiname vonUSERS.CSVvorausgesetzt.

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-Datei für Beispielgruppen

In der Konfiguration des Connectors wird in dieser Anleitung der Dateiname vonGROUPS.CSVvorausgesetzt.

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-Beispieldatei für Member

In der Konfiguration des Connectors wird in dieser Anleitung der Dateiname vonMEMBERS.CSVvorausgesetzt.

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

Anhang B: PowerShell-Beispieldateien

In diesem Anhang finden Sie eine Reihe von PowerShell-Beispielskripts, die in diesem Handbuch verwendet werden. In den folgenden Abschnitten werden einige der Überlegungen erläutert, die bei

Wichtig

Jede Verwendung von write-hostBefehlen in den PowerShell-Skripts führt dazu, dass die Ausführung des Skripts fehlschlägt.

PowerShell-Beispielskript vor dem Import

In der Konfiguration des Connectors wird in dieser Anleitung der Dateiname vonPRE-IMPORT.PS1vorausgesetzt.

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

Beispielskript nach dem Import von PowerShell

In der Konfiguration des Connectors wird in dieser Anleitung der Dateiname vonPOST-IMPORT.PS1vorausgesetzt.

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

PowerShell-Beispielskript vor dem Export

In der Konfiguration des Connectors wird in dieser Anleitung der Dateiname vonPRE-EXPORT.PS1vorausgesetzt.

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-Beispielskript nach dem Export

In der Konfiguration des Connectors wird in dieser Anleitung der Dateiname vonPOST-EXPORT.PS1vorausgesetzt.

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