CreateRole

Creates a role in the zone.

Syntax

IRole CreateRole (string name) 

Parameter

Specify the following parameter when using this method:

Parameter	Description
name	The name of the role.

Return value

A role with the specified name.

Discussion

The role is not stored in Active Directory until you call the Commitmethod.

Example

The following code sample illustrates using the CreateRole method in a script:

...
// Get the zone object
IHierarchicalZone objZone =
    cims.GetZoneByPath("cn=" + strZone + "," + strContainerDN) as IHierarchicalZone;
// create the role
if (objZone == null)
{
    Console.WriteLine("Zone " + strZone + " does not exist.");
}
else
{
    IRole role = objZone.CreateRole(strRole);
    role.Description = "optional description";
    role.Commit();
}
...