Active Roles stores Policy Type objects in the Policy Types container. You can access that container in the Active Roles Console by expanding the Configuration > Server Configuration branch of the Console tree.
To create a new Policy Type object
-
In the Console tree, under Configuration/Server Configuration/Policy Types, right-click the Policy Type container in which you want to create a new object, and select New > Policy Type.
For example, if you want to create a new object in the root container, right-click Policy Types.
-
In the New Object - Policy Type Wizard, type a name, a display name and, optionally, a description for the new object.
The display name and description are displayed on the page for selecting a policy, in the wizards that are used to configure Policy Objects.
-
Click Next.
-
Click Browse and select the Script Module containing the script that will be run by the policies of this policy type.
The Script Module must exist under the Configuration/Script Modules container and hold a policy script. For information about policy scripts, see the Active Roles SDK documentation.
-
In the Policy Type category area, do one of the following:
-
Click Provisioning if policies of this type are intended for Policy Objects of the provisioning category.
-
Click Deprovisioning if policies of this type are intended for Policy Objects of the deprovisioning category.
The policy types that have the Provisioning option selected appear on the page for selecting a policy in the wizard that is used to create a provisioning Policy Object or to add policies to an existing provisioning Policy Object. The policy types that have the Deprovisioning option selected appear in the wizard for creating a deprovisioning Policy Object or adding policies to such a Policy Object.
-
-
From the Function to declare parameters list, select the name of the script function that defines the parameters specific to this type of administration policy.
The list contains the names of all the functions found in the script you selected in Step 4. Every policy of this type will have the parameters that are specified by the function you select from the Function to declare parameters list. Normally, this is a function named onInit (see the Active Roles SDK documentation).
-
Click Policy Type Icon to verify the image that denotes this type of policy. To choose a different image, click Change and open an icon file containing the image you want.
This image appears next to the display name of the policy type on the wizard page for selecting a policy to configure, to help identify and visually distinguish this policy type from the other policy types.
The image is stored in the Policy Type object. In the dialog that appears when you click Policy Type Icon, you can view the image that is currently used. To revert to the default image, click Use Default Icon. If the button is unavailable, then the default image is currently used.
-
Click Next and follow the steps in the wizard to complete the creation of the new Policy Type object.