Chat now with support
Chat with Support

Active Roles 8.2.1 - Administration Guide

Introduction Getting started with Active Roles Configuring rule-based administrative views Configuring role-based administration Configuring rule-based autoprovisioning and deprovisioning
Configuring Provisioning Policy Objects
User Logon Name Generation E-mail Alias Generation Exchange Mailbox AutoProvisioning Group Membership AutoProvisioning Home Folder AutoProvisioning Property Generation and Validation Script Execution O365 and Azure Tenant Selection AutoProvisioning in SaaS products
Configuring Deprovisioning Policy Objects
User Account Deprovisioning Group Membership Removal User Account Relocation Exchange Mailbox Deprovisioning Home Folder Deprovisioning User Account Permanent Deletion Office 365 Licenses Retention Group Object Deprovisioning Group Object Relocation Group Object Permanent Deletion Script Execution Notification Distribution Report Distribution
Configuring entry types Configuring a Container Deletion Prevention policy Configuring picture management rules Managing Policy Objects Checking for policy compliance Deprovisioning users or groups Restoring deprovisioned users or groups Configuring policy extensions
Using rule-based and role-based tools for granular administration Workflows
About workflow processes Workflow processing overview Workflow activities overview Configuring a workflow
Creating a workflow definition for a workflow Configuring workflow start conditions Configuring workflow parameters Adding activities to a workflow Configuring an Approval activity Configuring a Notification activity Configuring a Script activity Configuring an If-Else activity Configuring a Stop/Break activity Configuring an Add Report Section activity Configuring a Search activity Configuring CRUD activities Configuring a Save Object Properties activity Configuring a Modify Requested Changes activity Enabling or disabling an activity Enabling or disabling a workflow Using the initialization script
Approval workflow Email-based approval Automation workflow Activity extensions
Temporal Group Memberships Group Family Dynamic groups Active Roles Reporting Management History Entitlement profile Recycle Bin AD LDS data management One Identity Starling Join and configuration through Active Roles Managing One Identity Starling Connect Configuring linked mailboxes with Exchange Resource Forest Management Configuring remote mailboxes for on-premises users Migrating Active Roles configuration with the Configuration Transfer Wizard Managing Skype for Business Server with Active Roles
About Skype for Business Server User Management Active Directory topologies supported by Skype for Business Server User Management User Management policy for Skype for Business Server User Management Master Account Management policy for Skype for Business Server User Management Access Templates for Skype for Business Server Configuring the Skype for Business Server User Management feature Managing Skype for Business Server users
Exchanging provisioning information with Active Roles SPML Provider Monitoring Active Roles with Management Pack for SCOM Configuring Active Roles for AWS Managed Microsoft AD Azure AD, Microsoft 365, and Exchange Online Management
Azure tenant types and environment types supported by Active Roles Using Active Roles to manage Azure AD objects Unified provisioning policy for Azure M365 Tenant Selection, Microsoft 365 License Selection, Microsoft 365 Roles Selection, and OneDrive provisioning Changes to Active Roles policies for cloud-only Azure objects
Managing the configuration of Active Roles
Connecting to the Administration Service Managed domains Using unmanaged domains Evaluating product usage Creating and using virtual attributes Examining client sessions Monitoring performance Customizing the Console Using Configuration Center Changing the Active Roles Admin account Enabling or disabling diagnostic logs Active Roles Log Viewer
SQL Server replication Using regular expressions Administrative Template Configuring federated authentication Communication ports and URLs used by Active Roles Integrating Active Roles with other products and services Active Roles Language Pack Active Roles Diagnostic Tools Active Roles Add-on Manager

“Undo deprovision” activity report section

The body of the report section identifies the object the activity restored from the deprovisioned state (activity target object), and provides the following information:

  • The type of the object (such as user, group or computer)
  • Name: <name of the object>
  • Operation ID: <number>
  • Requested: <date and time that the task was created>
  • Status: <indicates if the operation is complete or pending>

You can click the Operation ID number to examine in detail the operation of restoring the deprovisioned object. This displays a change history report containing information about all workflow activities and policy actions that Active Roles performed during that operation.

“Delete” activity report section

The body of the report section identifies the object deleted by the activity (activity target object), and provides the following information:

  • The type of the object (such as user or group)

  • Name: <name of the object>
  • Operation ID: <number>
  • Requested: <date and time that the task was created>
  • Status: <indicates if the operation is complete or pending>

You can click the Operation ID number to examine in detail the operation of deleting the object. This displays a change history report containing information about all workflow activities and policy actions that Active Roles performed during that operation.

Policy report items

This topic lists the Change History report items specific to the polices that are applied by using Policy Objects in Active Roles. When running a given policy, Active Roles adds a report section to describe the actions performed by that policy. The report section identifies the policy category and the Policy Object containing the policy, and informs about success or failure of the policy action.

The following tables list the possible report items, one table per section. The items in each section describe the results of the actions that were taken in accordance with the respective policy. Report items also inform about success or failure of the policy action. In the event of a failure, the report item includes an error description.

Not all the listed items must necessarily be present in a report. An actual report only includes the report items corresponding to the policies that Active Roles performed when processing the operation request.

Policy report sections

User Logon Name Generation policy
Table 26: User Logon Name Generation policy

Report Item (Success)

Report Item (Failure)

The user logon name (pre-Windows 2000) is set to value.

Not applicable

E-mail Alias Generation policy
Table 27: E-mail Alias Generation policy

Report Item (Success)

Report Item (Failure)

The e-mail alias is set to alias.

Not applicable

Property Alias (mailNickName) is removed from the operation request as no Exchange tasks were requested.

Not applicable

Exchange Mailbox AutoProvisioning policy
Table 28: Exchange Mailbox AutoProvisioning policy

Report Item (Success)

Report Item (Failure)

The mailbox database is set to database name.

Not applicable

The option to create the mailbox is selected by default.

Not applicable

The option to create the mailbox is not selected by default.

Not applicable

Changing the option to create the mailbox is allowed.

Not applicable

Changing the option to create the mailbox is not allowed.

Not applicable

Group Membership AutoProvisioning policy
Table 29: Group Membership AutoProvisioning policy

Report Item (Success)

Report Item (Failure)

The object is added to the following groups.

  • List: Group names

Unable to add the object to the following groups.

  • List: Group names and error description

The object is not added to the following groups as it is already a member of those groups.

  • List: Group names

Not applicable

The object is removed from the following groups.

  • List: Group names

Unable to remove the object from the following groups.

  • List: Group names and error description

The object is not removed from the following groups as it is not a member of those groups.

  • List: Group names

Not applicable

Home Folder AutoProvisioning policy
Table 30: Home Folder AutoProvisioning policy

Report Item (Success)

Report Item (Failure)

The home folder is mapped to letter letter and connected to path UNC path in Active Directory.

Not applicable

Home folder name is to be created on the file server.

Not applicable

Home folder name is created on the file server.

Unable to create home folder {0} on the file server.

Details: Error description

User permissions on the home folder are set by copying permissions from the parent folder.

Unable to set user permissions on home folder name on the file server.

Details: Error description

The home folder user is set as the owner of the home folder.

Unable to set user permissions on home folder name on the file server.

Details: Error description

User permission option Grant Change Access is applied to the home folder.

Unable to set user permissions on home folder name on the file server.

Details: Error description

User permission option Grant Full Access is applied to the home folder.

Unable to set user permissions on home folder name on the file server.

Details: Error description

Home folder name is to be renamed to name on the file server.

Not applicable

Home folder name is renamed to name on the file server.

Unable to rename home folder name to name on the file server.

Details: Error description

Home share name is to be created on the file server.

Not applicable

Home share name is created on the file server.

Unable to create home share name on the file server.

Details: Error description

The user limit is set to allow no more than name users to connect to the home share at a time.

Not applicable

The user limit is set to allow the maximum number of users to connect to the home share at a time.

Not applicable

Property Generation and Validation policy
Table 31: Property Generation and Validation policy

Report Item (Success)

Report Item (Failure)

Property name is set to value.

Not applicable

Property name is removed (cleared).

Not applicable

Running policy script <name>
Table 32: Policy script <name>

Report Item (Success)

Report Item (Failure)

Policy script <name> completed successfully.

  • Error message returned by the policy

    Details: Error description

The default error message reads as follows:

  • The Script Execution policy encountered an error when running the script name.

    Details: Error description

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating