Once you have created a configuration file and have customized it accordingly, you can generate new synchronization projectsA collection of all data required for synchronizingThe process 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, mappingsList of object matching rules and property mapping rules which map the schema properties of two connected systems to one another., and synchronization workflows all belongs to this. or update existing synchronization projects with the Synchronization Editor Module for Windows PowerShellSynchronization EditorOne Identity 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 Windows 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 Module for Windows PowerShell

1. Start Windows 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 execute the CmdLet without additional input.

5. Enter values for the parameters requiring user input.

   • To enter an empty value, press ENTER.

6. If no error occur, execute steps 3 and 4 with the -SaveToDatabase option.

   If the synchronization project was created with a project templateTemplate 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 Windows 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 execute 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. If no error occur, execute 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 91: 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 92: 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"}