This step assumes that:
-
The same Group Policy object is linked to each OU holding the domain controllers on which the Capture Agent is installed. For more information on how to create and link a Group policy object, see the documentation for your version of Windows.
-
The SyncServiceCaptureAgent.adm administrative template file is linked to that Group Policy object.
For instructions on how to add an administrative template file to a Group Policy object, see Adding an administrative template to Group Policy object.
To provide the thumbprint to Capture Agent
On any computer joined to the domain where Capture Agent is installed, open Group Policy Object Editor, and connect to the Group Policy object to which you added the Administrative Template in Adding an administrative template to Group Policy object.
-
In the Group Policy Object Editor console, expand the Group Policy object, and then expand the Computer Configuration node.
-
Expand the Administrative Templates > Active Roles node to select Sync Service Capture Agent Settings.
-
In the details pane, double-click Certificate to encrypt Capture Agent traffic.
-
Select the Enabled option, and then paste the certificate’s thumbprint (the one you copied in Copying the certificate's thumbprint) in the Thumbprint text box. When finished, click OK.
-
For the changes to take effect, refresh the Group Policy settings by running the following command at a command prompt:
gpupdate /force
Perform the next steps on each computer running the that participates in the password sync operations.
To provide the thumbprint to
-
On the computer running the , start Group Policy Object Editor, and then connect to the Local Computer Policy Group Policy object.
-
In the Group Policy Object Editor console, expand the Local Computer Policy node, expand the Computer Configuration node, and select Administrative Templates.
-
On the Action menu, point to All Tasks, and click Add/Remove Templates.
-
In the Add/Remove Templates dialog, click Add, and then use the Policy Templates dialog to open the SyncService.adm file that holds the Administrative Template.
-
By default, the SyncService.adm file is stored in <Active Roles installation folder>\SyncServiceCaptureAgent\Administrative Templates.
-
Under Computer Configuration > Administrative Templates > Active Roles, select Sync Service Settings.
-
In the details pane, double-click Certificate to encrypt Capture Agent traffic.
-
Select the Enabled option, and then paste the certificate’s thumbprint (the one you copied in Copying the certificate's thumbprint) in the Thumbprint text box. When finished, click OK.
-
For the changes to take effect, refresh the Group Policy settings by running the following command at a command prompt:
gpupdate /force
Optionally, you can configure the to run your custom PowerShell script before, after, or instead of the password synchronization operation. To do so, create a connection handler. For instructions, see Using connection handlers.
Example of a PowerShell script run after password synchronization
After the password synchronization is complete, the following script sends a notification email message informing the administrator that the specified object password has been modified in the target connected system. The message provides the names of the source Active Directory object and its counterpart in the target connected system.
#---- Specify the SMTP Server name in your organization ----
$SmtpServer = "smtpServerName"
$smtp = new-object system.net.mail.smtpClient($SmtpServer)
$mail = new-object System.Net.Mail.MailMessage
# ---- Set the sender mail ----
$mail.From = "yourmail@mydomain.com"
# ---- Set the destination mail ----
$mail.To.Add("Administrator@mydomain.com")
# --- Specify the message subject ----
$mail.Subject = "Password was changed"
# ---- Set the message text ----
$body = "The passwords were synchronized for the following object pair: "
$body = $body + $srcObj.Name + "->" + $dstObj.Name
$mail.Body = $body
# ---- Send mail ----
$smtp.Send($mail)
provides the Synchronization History option that allows you to view the details of completed synchronization workflow runs, password synchronization rule runs, and map and unmap operations.
The synchronization history also helps you troubleshoot synchronization issues by providing information on the errors that were encountered during sync workflow runs, password sync rule runs, or map and unmap operations.
You can also selectively clean up entries from the synchronization history.
To access the synchronization history, use the Sync History tab in the .