GetComputerRole
Returns the computer role with a specified name.
Syntax
IComputerRole GetComputerRole (string name)
Parameter
Specify the following parameter when using this method:
Parameter | Description |
name |
The name of the computer role. |
Return value
The computer role with the specified name, or null if no match is found.
Exceptions
GetComputerRole throws an ApplicationException if it can’t find authorization data for the zone or if it failed to get the computer role (see the message returned by the exception for the reason).
Example
The following code sample illustrates using the GetComputerRole method in a script:
... IHierarchicalZone objZone = cims.GetZoneByPath("cn=" + strZone + "," + strContainerDN) as IHierarchicalZone; if (objZone == null) { Console.WriteLine("Zone " + strZone + " does not exist."); } else { IComputerRole compRole = objZone.GetComputerRole(strName); if (compRole != null) { Console.WriteLine("Computer role " + strName + " already exist."); } else { compRole = objZone.AddComputerRole(strName); compRole.Group = strGroup; compRole.Validate(); compRole.Commit(); Console.WriteLine("Computer role " + strName + " is created successfully."); } } ...