GetUser

Returns an Active Directory user object with all of its related Centrify-specific data.

Syntax

IUser GetUser(IADs user)

Parameter

Specify the following parameter when using this method:

Parameter Description

user

The IADs interface to the user object you want to retrieve.

Return value

The user object as:

Centrify.DirectControl.API.IUser

Discussion

This method uses the IADs interface to locate the user object. The IADs interface is the directory object that represents the user in Active Directory. The IADs object is useful for retrieving Active Directory-specific information, such as the site, for a user.

The method returns the user object as Centrify.DirectControl.API.IUser. You can then use the IUser object to retrieve Centrify-specific information.

Exceptions

GetUser throws an ArgumentException if the parameter 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 Active Directory user you want to work with
Set objUser = cims.GetUser("ajax.org/Users/Jae Smith”)
...