Wenn Sie eine Konfigurationsdatei erstellt und ihren Anforderungen entsprechend angepasst haben, können Sie mit dem Synchronization Editor Module for Windows PowerShellKomponente des Synchronization EditorWerkzeug des One Identity Manager, mit dem SynchronisationenVorgang des Datenabgleichs zwischen der One Identity Manager Datenbank und einem Zielsystem. Es werden Objekte und ihre Eigenschaften nach festgelegten Regeln angeglichen. Das Ergebnis der Synchronisation ist eine identische Datensituation im Zielsystem und der One Identity Manager Datenbank. für Zielsysteme konfiguriert werden können., mit welcher SynchronisationsprojekteZusammenstellung aller Informationen, die für die Synchronisation und Provisionierung mit einem Zielsystem benötigt werden. Dazu gehören die Verbindungsinformationen, Schemaklassen und -eigenschaften, MappingsListe von Objekt-Matching- und Property-Mapping-Regeln, nach denen die Schemaeigenschaften zweier verbundener Systeme aufeinander abgebildet werden., Synchronisationsworkflows. per PowerShell CmdLet erstellt werden können. neue Synchronisationsprojekte generieren oder bestehende Synchronisationsprojekte aktualisieren. Wahlweise können Sie dafür auch das Synchronization Editor Command Line InterfaceKomponente des Synchronization Editor, mit welcher Synchronisationsprojekte per Kommandozeilenbefehl erstellt werden können. nutzen. Weitere Informationen finden Sie unter Synchronization Editor Command Line Interface.

Um Synchronisationsprojekte mit dem Synchronization Editor Module for Windows PowerShell zu erstellen

1. Starten Sie PowerShell.

2. Wechseln Sie in das One Identity Manager Installationsverzeichnis.

3. Laden Sie das Synchronization Editor Module for Windows PowerShell.

   Import-Module .\VI.Projector.Editor.PowerShell.dll

4. Führen Sie das CmdLet New-ProjectorShell aus und setzen Sie dabei die Werte für die Parameter.

   New-ProjectorShell -Workspace <Konfigurationsdatei> {Option} {Parameter}

   Beispiel: New-ProjectorShell -Workspace D:\ActiveDirectoryProject.sews -WorkspaceParameter @{SyncProject="Synchronization Project for Active Directory Domain XYZ"}

   HINWEIS: Wenn Sie das CmdLet ohne zusätzliche Angaben ausführen, werden die Pflichtparameter einzeln abgefragt.

5. Geben Sie die Werte der Parameter ein, die eine Benutzereingabe erfordern.

   • Um einen Leerwert zu erfassen, drücken Sie ENTER.

6. (Optional) Führen Sie das CmdLet New-ProjectorShell mit der Option -Remote aus.

   Die Remoteverbindung wird hergestellt.

   Beispiel: New-ProjectorShell -Workspace D:\ActiveDirectoryProject.sews -Remote

7. Wenn keine Fehler aufgetreten sind, führen Sie Schritt 3 und 4 mit der Option -SaveToDatabase aus.

   Wenn das Synchronisationsprojekt mit einer ProjektvorlageVorlage, über die der Projektassistent ein vorkonfiguriertes Synchronisationsprojekt erstellt. erstellt wurde, werden die Schemas beim Speichern komprimiert.

Um Synchronisationsprojekte mit dem Synchronization Editor Module for Windows PowerShell zu aktualisieren

1. Starten Sie PowerShell.

2. Wechseln Sie in das One Identity Manager Installationsverzeichnis.

3. Laden Sie das Synchronization Editor Module for Windows PowerShell.

   Import-Module .\VI.Projector.Editor.PowerShell.dll

4. Führen Sie das CmdLet Update-ProjectorShell aus und setzen Sie dabei die Werte für die Parameter.

   Update-ProjectorShell -Workspace <Konfigurationsdatei> {Option} {Parameter}

   Beispiel: Update-ProjectorShell -Workspace D:\ActiveDirectoryProject.sews -WorkspaceParameter @{SyncProject="CCC-99D111DD1CF11111BCF11111E1111BE9";Patches="AllFixes,Milestone_OneIM_8.0.2017.1104,VPR#12345,VPR#23456,VPR#34567"}

   HINWEIS: Wenn Sie das CmdLet ohne zusätzliche Angaben ausführen, werden die Pflichtparameter einzeln abgefragt.

   • Wenn beim Anwenden der Patches auf das ZielsystemEine Instanz eines Zielsystemtyps, in dem die vom One Identity Manager verwalteten Identitäten Zugriff auf Netzwerkressourcen besitzen. Beispiele: eine Active Directory Domäne X für den Zielsystemtyp „Active Directory“, ein Verzeichnis Y für den Zielsystemtyp „LDAP“, ein Mandant Z für den Zielsystemtyp „SAP R/3“ zugegriffen werden muss und die Verbindungsparameter im Standardvariablenset verschlüsselte Werte enthalten, werden Sie zur Eingabe der entschlüsselten Werte aufgefordert. Dabei werden die Namen der benötigten Parameter angezeigt.

     TIPP: Nutzen Sie diese Parameternamen, um für jeden verschlüsselten Verbindungsparameter einen Parameter in der Konfigurationsdatei anzulegen. Damit können die Werte für die verschlüsselten Verbindungsparameter dem CmdLet-Aufruf mitgegeben werden.

     Die Namen der Parameter müssen folgender Namenskonvention entsprechen: Decryption_DefaultVariableSet_<Anzeigename der Variable>.

     Beispiel für eine Parameterdefinition: <Parameter Name="Decryption_DefaultVariableSet_Password" Display="Password of target system user" IsQueryParameter="False"</Parameter>

     Beispiel für den Kommandoaufruf: Update-ProjectorShell -Workspace D:\ActiveDirectoryProject.sews -WorkspaceParameter @{SyncProject="CCC-99D111DD1CF11111BCF11111E1111BE9";Patches="AllFixes";Decryption_DefaultVariableSet_Password="A123-z987"}

5. Geben Sie die Werte der Parameter ein, die eine Benutzereingabe erfordern.

   • Um einen Leerwert zu erfassen, drücken Sie ENTER.

6. (Optional) Führen Sie das CmdLet Update-ProjectorShell mit der Option -Remote aus

   Die Remoteverbindung wird hergestellt.

   Beispiel: Update-ProjectorShell -Workspace D:\ActiveDirectoryProject.sews -Remote

7. Wenn keine Fehler aufgetreten sind, führen Sie Schritt 3 und 4 mit der Option -SaveToDatabase aus.

   Wenn das Synchronisationsprojekt mit einer Projektvorlage erstellt wurde, werden die Schemas beim Speichern komprimiert.

Tabelle 89: CmdLets des Synchronization Editor Module for Windows PowerShell

CmdLet	Beschreibung
New-ProjectorShell	Erstellt ein neues Synchronisationsprojekt auf Basis der Daten des definierten Workspaces.
Update-ProjectorShell	Wendet Patches auf ein bestehendes Synchronisationsprojekt an.

Tabelle 90: Optionen

Option	Beschreibung
-?	Zeigt die Hilfe an.
-Workspace	Vollständiger oder relativer Pfad zur Konfigurationsdatei.
-SaveToDatabase	Speichert das erstellte Synchronisationsprojekt in die Datenbank. Wenn diese Option nicht angegeben ist, wird das Erstellen des Synchronisationsprojekts simuliert.
-WorkspaceParameter	Setzt die Werte der in der Konfigurationsdatei definierten Parameter. Standardwerte werden überschrieben. Format: @{Parametername="Wert"} Mehrere Parameter werden durch Semikolon getrennt: -WorkspaceParameter @{ParamName1="Wert1";ParamName2="Wert2"}
-Remote	Stellt die Verbindung zum Zielsystem über einen RemoteverbindungsserverJobserverServer, auf dem der One Identity Manager Service installiert ist., auf dem das RemoteConnectPlugin und der Zielsystemkonnektor installiert sind. Wenn der direkte Zugriff auf das Zielsystem nicht möglich ist, kann eine Remoteverbindung eingerichtet werden. Die Kommunikation zwischen Synchronization Editor und Zielsystem übernimmt dabei ein Remoteverbindungsserver. her. Nutzen Sie eine Remoteverbindung, wenn der direkte Zugriff auf das Zielsystem von der Arbeitsstation, auf welcher der Synchronization Editor installiert ist, nicht möglich ist.