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)
...