Synchronization Editor Command Line Interface
Wenn Sie eine Konfigurationsdatei erstellt und ihren Anforderungen entsprechend angepasst haben, können Sie mit dem neue Synchronisationsprojekte generieren oder bestehende Synchronisationsprojekte aktualisieren. Wahlweise können Sie dafür auch das nutzen. Weitere Informationen finden Sie unter Synchronization Editor Module for Windows PowerShell.
Um Synchronisationsprojekte mit dem Synchronization Editor Command Line Interface zu erstellen
-
Starten Sie einen Kommandozeileneditor.
-
Wechseln Sie in das One Identity Manager Installationsverzeichnis.
-
Führen Sie das Synchronization Editor Command Line Interface mit der Option -V aus und setzen Sie die Werte für die Parameter.
SynchronizationEditor.CLI.exe --CreateShell {<Optionen>} <Konfigurationsdatei> {<Parameter>}
HINWEIS: Wenn der Wert eines Parameters Leerzeichen oder Sonderzeichen enthält, muss er in Anführungszeichen eingeschlossen werden.
Beispiel: SynchronizationEditor.CLI.exe --CreateShell -V /Workspace=D:\ActiveDirectoryProject.sews /SetParam SyncProject="Synchronization Project for Active Directory Domain XYZ"
-
Geben Sie die Werte der Parameter ein, die eine Benutzereingabe erfordern.
-
Um einen Leerwert zu erfassen, drücken Sie ENTER.
-
Um den Standardwert zu übernehmen, der in der Konfigurationsdatei definiert ist, drücken Sie Esc.
-
(Optional) Führen Sie das Synchronization Editor Command Line Interface mit der Option -R aus.
Die Remoteverbindung wird hergestellt.
Beispiel: SynchronizationEditor.CLI.exe --CreateShell -R /Workspace=D:\ActiveDirectoryProject.sews
-
Wenn keine Fehler aufgetreten sind, führen Sie Schritt 3 und 4 mit der Option -S aus.
Wenn das Synchronisationsprojekt mit einer erstellt wurde, werden die Schemas beim Speichern komprimiert.
Um Synchronisationsprojekte mit dem Synchronization Editor Command Line Interface zu aktualisieren
-
Starten Sie einen Kommandozeileneditor.
-
Wechseln Sie in das One Identity Manager Installationsverzeichnis.
-
Führen Sie das Synchronization Editor Command Line Interface mit der Option -V aus und setzen Sie die Werte für die Parameter.
SynchronizationEditor.CLI.exe --PatchShell {<Optionen>} <Konfigurationsdatei> {<Parameter>}
HINWEIS: Wenn der Wert eines Parameters Leerzeichen oder Sonderzeichen enthält, muss er in Anführungszeichen eingeschlossen werden.
Beispiel: SynchronizationEditor.CLI.exe --PatchShell -V /Workspace=D:\ActiveDirectoryProject.sews /SetParam SyncProject="CCC-99D111DD1CF11111BCF11111E1111BE9" /SetParam Patches=AllFixes,Milestone_OneIM_8.0.2017.1104,VPR#12345,VPR#23456,VPR#34567
-
Geben Sie die Werte der Parameter ein, die eine Benutzereingabe erfordern.
-
Um einen Leerwert zu erfassen, drücken Sie ENTER.
-
Um den Standardwert zu übernehmen, der in der Konfigurationsdatei definiert ist, drücken Sie Esc.
-
(Optional) Führen Sie das Synchronization Editor Command Line Interface mit der Option -R aus.
Die Remoteverbindung wird hergestellt.
Beispiel: SynchronizationEditor.CLI.exe --PatchShell -R /Workspace=D:\ActiveDirectoryProject.sews
-
Wenn keine Fehler aufgetreten sind, führen Sie Schritt 3 und 4 mit der Option -S aus.
Wenn das Synchronisationsprojekt mit einer Projektvorlage erstellt wurde, werden die Schemas beim Speichern komprimiert.
TIPP: Um die Hilfe für das Synchronization Editor Command Line Interface anzuzeigen, führen Sie die SynchronizationEditor.CLI.exe ohne zusätzliche Angaben aus.
Tabelle 89: Befehle des Synchronization Editor Command Line Interface
|
--CreateShell |
Erstellt ein neues Synchronisationsprojekt auf Basis der Daten des definierten Workspaces.
Kurzform: --CS |
|
--PatchShell |
Wendet Patches auf ein bestehendes Synchronisationsprojekt an.
Kurzform: --PS |
Tabelle 90: Optionen des Synchronization Editor Command Line Interface
|
-?|H |
Zeigt die Hilfe an. |
|
-Q |
Keine Nachfrage vor der Ausführung irreversibler Aktionen. |
|
-V |
Das Synchronization Editor Command Line Interface wird im Verbose-Modus ausgeführt. Nutzen Sie diese Option für die Fehleranalyse. |
|
-S |
Speichert das erstellte Synchronisationsprojekt in die Datenbank. Wenn diese Option nicht angegeben ist, wird das Erstellen des Synchronisationsprojekts simuliert. |
|
-N |
Definiert, ob das Synchronization Editor Command Line Interface im nicht-interaktiven Modus arbeiten soll. Parameterabfragen können dabei fehlschlagen.
Fehlende verschlüsselte Werte werden auch im nicht-interaktiven Modus erfragt. |
|
-R |
Stellt die Verbindung zum Zielsystem über einen 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. |
Tabelle 91: Parameterdeklaration
|
/Workspace |
Vollständiger oder relativer Pfad zur Konfigurationsdatei. |
|
/SetParam |
Setzt die Werte der in der Konfigurationsdatei definierten Parameter. Standardwerte werden überschrieben.
Format: Parametername=Wert
Beachten Sie die Groß- und Kleinschreibung der Parameternamen.
Wenn der Wert Leerzeichen oder Sonderzeichen enthält, muss er in Anführungszeichen eingeschlossen werden. Mehrere Parameter werden einzeln deklariert: /SetParam ParamName1=Wert1 /SetParam ParamName2=Wert2 |
Synchronization Editor Module for Windows PowerShell
Wenn Sie eine Konfigurationsdatei erstellt und ihren Anforderungen entsprechend angepasst haben, können Sie mit dem neue Synchronisationsprojekte generieren oder bestehende Synchronisationsprojekte aktualisieren. Wahlweise können Sie dafür auch das nutzen. Weitere Informationen finden Sie unter Synchronization Editor Command Line Interface.
Um Synchronisationsprojekte mit dem Synchronization Editor Module for Windows PowerShell zu erstellen
-
Starten Sie Windows PowerShell.
-
Wechseln Sie in das One Identity Manager Installationsverzeichnis.
-
Laden Sie das Synchronization Editor Module for Windows PowerShell.
Import-Module .\VI.Projector.Editor.PowerShell.dll
-
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.
-
Geben Sie die Werte der Parameter ein, die eine Benutzereingabe erfordern.
- Um einen Leerwert zu erfassen, drücken Sie ENTER.
-
(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
-
Wenn keine Fehler aufgetreten sind, führen Sie Schritt 3 und 4 mit der Option -SaveToDatabase aus.
Wenn das Synchronisationsprojekt mit einer erstellt wurde, werden die Schemas beim Speichern komprimiert.
Um Synchronisationsprojekte mit dem Synchronization Editor Module for Windows PowerShell zu aktualisieren
-
Starten Sie Windows PowerShell.
-
Wechseln Sie in das One Identity Manager Installationsverzeichnis.
-
Laden Sie das Synchronization Editor Module for Windows PowerShell.
Import-Module .\VI.Projector.Editor.PowerShell.dll
-
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.
-
Geben Sie die Werte der Parameter ein, die eine Benutzereingabe erfordern.
- Um einen Leerwert zu erfassen, drücken Sie ENTER.
-
(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
-
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 92: CmdLets des Synchronization Editor Module for Windows PowerShell
|
New-ProjectorShell |
Erstellt ein neues Synchronisationsprojekt auf Basis der Daten des definierten Workspaces. |
|
Update-ProjectorShell |
Wendet Patches auf ein bestehendes Synchronisationsprojekt an. |
Tabelle 93: Optionen
|
-? |
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 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. |
Synchronisationspuffer warten
Abhängig vom Wartungsmodus, der an der eingestellt ist, wird die des Synchronisationspuffers im Anschluss an jede Synchronisation ausgeführt. Dabei versucht der One Identity Manager nicht-auflösbare Referenzen zu bereinigen. Zusätzlich kann der Inhalt des Synchronisationspuffers im angezeigt und die Wartung manuell gestartet werden. Dabei entscheiden Sie, ob die Wartung direkt auf der Arbeitsstation ausgeführt werden soll, auf welcher der Synchronization Editor gestartet wurde, oder ob die Wartung vom ausgeführt werden soll.
An der One Identity Manager Verbindung ist im Expertenmodus zusätzlich die Ansicht verfügbar.
Um den Inhalt des Synchronisationspuffers anzuzeigen
-
Wählen Sie die Kategorie Konfiguration | One Identity Manager Verbindung.
-
Öffnen Sie die Ansicht Synchronisationspuffer.
Im Bereich Überblick wird der Inhalt des Synchronisationspuffers angezeigt.
Um die Wartung manuell zu starten
-
In der Ansicht Synchronisationspuffer klicken Sie Wartung ausführen.
-
Um die Wartung vom One Identity Manager Service ausführen zu lassen, klicken Sie Ja.
- ODER -
Um die Wartung von der aktuellen Arbeitsstation ausführen zu lassen, klicken Sie Nein.
Verwandte Themen
Synchronisationspuffer deaktivieren
In , die über eine Standard-Projektvorlage erstellt wurden, ist der standardmäßig aktiviert. Der Synchronisationspuffer kann für Schemaeigenschaften im One Identity Manager , die Mitglieder von M:N Schematypen oder Schlüsselauflösungen abbilden, deaktiviert werden.
Der Synchronisationspuffer kann sehr groß werden, wenn durch Teilsynchronisationen Tausende nicht-auflösbare Referenzen eingelesen werden. Das kann die Synchronisationsperformance beeinträchtigen. In solchen Fällen kann es hilfreich sein, den Synchronisationspuffer zu deaktivieren.
Deaktivieren Sie den Synchronisationspuffer, wenn:
-
die Anzahl der Objekte im Synchronisationspuffer sehr groß ist und Probleme bereitet,
-
für die Mitglieder von M:N Schematypen der Merge-Modus für die aktiviert ist und
-
diese Mitgliedschaften niemals durch eine vollständige Synchronisation in das Zielsystem übertragen werden.
WICHTIG: Wenn der Synchronisationspuffer deaktiviert ist, werden bei der Synchronisation in das Zielsystem oder bei der Provisionierung die Referenzen, die im One Identity Manager fehlen, im Zielsystem gelöscht. Prüfen Sie daher sorgfältig, ob der Synchronisationspuffer deaktiviert werden kann.
Um den Synchronisationspuffer zu deaktivieren
-
Öffnen Sie im das Synchronisationsprojekt.
-
Wählen Sie die Kategorie Mappings.
-
Wählen Sie in der Navigationsansicht ein Mapping.
-
Doppelklicken Sie in der Schemaansicht des One Identity Manager Schemas auf die , die eine Objektreferenz abbildet.
- Deaktivieren Sie die Option Nicht-auflösbare Schlüssel speichern.
- Klicken Sie OK.
- Speichern Sie die Änderungen.
Verwandte Themen
