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();
}
...
Doc Feedback