Active Roles 7.4.1 - Synchronization Service Administration Guide

Example of a PowerShell script run after password synchronization

#---- 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)

Description: After the password synchronization is complete, this 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.

Synchronization history

• About synchronization history
• Viewing sync workflow history
• Viewing mapping history
• Searching synchronization history
• Cleaning up synchronization history

About synchronization history

Synchronization Service Administration Console provides the Synchronization History feature that allows you to view the details of completed sync workflow runs, password sync 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 Synchronization Service Administration Console.

In this chapter:

• Viewing sync workflow history
• Viewing mapping history
• Searching synchronization history
• Cleaning up synchronization history

Viewing sync workflow history

You can use the Sync History tab in the Synchronization Service Administration Console to view a list of completed sync workflow runs. This list provides such information as the names of completed sync workflows, the dates when each sync workflow run started and completed, and which Synchronization Service instance was used to run each sync workflow.

You can click a sync workflow run entry in the list to view detailed information about the sync workflow steps that were run, objects that participated in that run, and errors encountered during the run, if any.

To view the details of a completed sync workflow run

1. In the Synchronization Service Administration Console, open the Sync History tab.
2. Click Sync Workflow History.
3. If you want to filter the list of completed sync workflows, use the following elements:
   • Show items completed. Use this element to specify the time period when the sync workflows you want to view completed.
   • Maximum number of items to show. Specify the maximum number of completed sync workflows you want to view.
   You can sort the list of completed sync workflows by clicking the column titles in the list. Also you can filter the list of completed sync workflows by typing keywords in the text boxes provided below the column titles.
4. To view detailed information about a list entry, select that list entry, and then click the Details button.

   The details provided for each list entry look similar to the following:

   Figure 10: Synchronization Servce details

   

   To view detailed information about the objects that belong to a certain object category, click the number displayed next to the object category name in the Source or Target column.

   To view detailed information about encountered errors, click the link displaying the number of errors.