Once you have created a configuration file and have customizedRuns processing logic which would normally be implemented in the object code, such as mutual exclusion of properties. The Customizer contains special methods and has side effects on the table columns. Several customizers can be defined for one table. it accordingly, you can generate new synchronization projectsA collection of all data required for synchronizingThe processSequence of process steps for mappingList of object matching rules and property mapping rules which map the schema properties of two connected systems to one another. an operational workflow. The process steps are connected to one another by predecessor/successor relationships. This functionality allows flexibility when linking up actions and sequences on object events. of comparing data between One Identity Manager and a target system. Objects and their properties are compared by fixed rules. Synchronization results in the identical data situation in the target system and One Identity Manager database. and provisioning a target system. Connection data, schema classes and properties, mappings, and synchronization workflows all belongs to this. or update existing synchronization projects with the Synchronization Editor Module for Windows PowerShellSynchronization EditorOne IdentityAn identity usually represents a real person. In addition, identities that do not represent real people, such as machine identities or service identities, can be mapped in One Identity Manager. (see also virtual identity; see also main identity/subidentity) Manager tool for configuring target system synchronizationPost processing of objects that were marked as outstanding by synchronization.. components with which synchronization projects can be created by PowerShell CmdLet.. You can also opt to use the Synchronization Editor Command Line InterfaceSynchronization Editor components with which synchronization projects can be created on the command line. to do this. For more information, see Synchronization Editor Command Line Interface.

To create synchronization projects with the Synchronization Editor ModuleA module is a closed unit with a defined functionality. A module includes descriptive information, the binaries (exe, DLL), the documentation, and information about the database (see also One Identity Manager schema). for Windows PowerShell

1. Start PowerShell.

2. Switch to the One Identity Manager installation directory.

3. Load the Synchronization Editor Module for Windows PowerShell.

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

4. Run the New-ProjectorShell CmdLet and set the value for the parameter.

   New-ProjectorShell -Workspace <configuration file> {option} {parameter}

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

   NOTE: Mandatory parameter are queried one at a time if you run the CmdLet without additional input.

5. Enter values for the parameters requiring user input.

   • To enter an empty value, press ENTER.

6. (Optional) Run the New-ProjectorShell CmdLet with the -Remote option.

   This establishes a remote connection.

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

7. If no error occur, run steps 3 and 4 with the -SaveToDatabase option.

   If the synchronization project was created with a project templateTemplateRule for mapping object properties. Templates can be applied to an object and also have a cross-object effect. used by the project wizard to create a preconfigured synchronization project., the schemas are shrunk when saved.

To update synchronization projects with the Synchronization Editor Module for Windows PowerShell

1. Start PowerShell.

2. Switch to the One Identity Manager installation directory.

3. Load the Synchronization Editor Module for Windows PowerShell.

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

4. Run the Update-ProjectorShell CmdLet and set the value for the parameter.

   Update-ProjectorShell -Workspace <configuration_file> {option} {parameters}

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

   NOTE: Mandatory parameter are queried one at a time if you run the CmdLet without additional input.

   • If the target system is accessed when the patch is applied and the connection parameters in the default variable set contain encrypted values, you will be prompted to enter the decrypted values. The names of the required parameters are displayed.

     TIP: Use these parameter names to add a parameter in the configuration file for each encrypted connection parameter. This allows values for the encrypted connection parameters to be passed to the CmdLet when it is called.

     The parameter names must conform to the following naming convention: Decryption_DefaultVariableSet_<variable name>.

     Example of a parameter definition: <Parameter Name="Decryption_DefaultVariableSet_Password" Display="Password of target system user" IsQueryParameter="False"</Parameter>

     Example of a command line call: Update-ProjectorShell -Workspace D:\ActiveDirectoryProject.sews -WorkspaceParameter @{SyncProject="CCC-99D111DD1CF11111BCF11111E1111BE9";Patches="AllFixes";Decryption_DefaultVariableSet_Password="A123-z987"}

5. Enter values for the parameters requiring user input.

   • To enter an empty value, press ENTER.

6. (Optional) Run the Update-ProjectorShell CmdLet with the -Remote option.

   This establishes a remote connection.

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

7. If no error occur, run steps 3 and 4 with the -SaveToDatabase option.

   If the synchronization project was created with a project template, the schemas are shrunk when saved.

Table 89: Synchronization Editor Module for Windows PowerShell CmdLets

CmdLet	Description
New-ProjectorShell	Creates a new synchronization project using the data from the defined workspace.
Update-ProjectorShell	Applies patches to an existing synchronization project.

Table 90: Options

Option	Description
-?	Displays help.
-Workspace	Full or relative path of the configuration file.
-SaveToDatabase	Saves the new synchronization project in the database. If this option is not given, creating the synchronization project is simulated.
-WorkspaceParameter	Sets the value of the parameter defined in the configuration file. Overwrites default values. Format: @{Parameter name="value"} Multiple parameters are separated with semicolons: -WorkspaceParameter @{ParamName1="Value1";ParamName2="Value2"}
-Remote	Establishes the connection to the target system over a remote service connection. Use a remote connection if it is not possible to directly access the target system from the workstation where the Synchronization Editor is installed.