GetComputer
Returns a computer object with all of its related Centrify-specific data, including all of the Computer object’s properties and methods.
Syntax
IComputer GetComputer(IADs computer)
Parameter
Specify the following parameter when using this method:
Parameter | Description |
computer |
The IADs interface to the computer object you want to retrieve. You can use the standard ADSI GetObject function to retrieve this interface. |
Return value
The computer object as:
Centrify.DirectControl.API.IComputer
Discussion
This method returns the computer object using the IADs interface to locate the object. The IADs interface is the directory object that represents the computer in Active Directory. The IADs object is useful for retrieving Active Directory-specific information, such as the site, for a computer object.
The method returns the computer object as Centrify.DirectControl.API.IComputer. You can then use the IComputer object to retrieve Centrify-specific information, such as the version of the Centrify agent installed on the computer.
Exceptions
GetComputer throws an ArgumentException if the computer path is null or empty.
Example
The following code sample illustrates using this method in a script:
... 'Specify the zone you want to work with set objZone = cims.GetZone("ajax.org/UNIX/Zones/east_div”) 'Identify the computer you want to work with set objIADsComputer = GetObject(“LDAP://CN=magnolia, CN=Computers,DC=ajax,DC=org”) 'Get the directory object for the computer set objComputer = cims.GetComputer(objIADsComputer) ...