Using VBScript
In most cases, you can use VBScript to write scripts that call the Centrify Windows API.
The following steps illustrate how to create and run a VBScript script that uses the Centrify Windows API. This sample script opens a zone and lists all the users in it.
- Verify that the computer you are using has Access Manager console or the Centrify Windows API Runtime environment from the Centrify SDK installed.
- Verify that the computer you are using is a member of the Active Directory domain you want to work with.
-
Log in as a domain user with permission to read the zone data for the zone you will be listing.
If you can list the users in the zone using the Access Manager console with the credentials provided, you have the correct permissions. For information about configuring a user’s rights to read zone data, see the Planning and Deployment Guide.
- Use a text editor to create a file called zone-list.vbs.
-
Add the following text to zone-list.vbs, replacing the domain_name and the path to the zone with a domain name and zone location appropriate for your environment.
set cims = CreateObject("Centrify.DirectControl.Cims3")
set zone = cims.GetZone("domain_name/zone_path/zone_name")
set users = zone.GetUserUnixProfiles()
for each user in users
if (user.IsNameDefined) then
name = user.Name
else
name = "<Empty>"
end if
if (user.IsUidDefined) then
uid = user.Uid
else
uid = "<Empty>"
end if
wscript.echo name & " | " & uid
nextFor example if you are using the domain test.acme.com and want to list users in the “default” zone in its default container location:
set zone = cims.getzone("test.acme.com/program data/centrify/zones/default")
for each user in users
wscript.echo user.name, user.Uid
next - Click Start > Run, then type cmd to open a command window.
-
Change directory to the location of the VBScript file and type:
cscript zone-list.vbs
You should see output similar to the following:
C:\>cscript zone-list.vbs
Microsoft (R) Windows Script Host Version 5.6
Copyright (C) Microsoft Corporation 1996-2001. All rights reserved.
jane 10000
jim.smit 10002
jimsmith 10003
joe 10004
paul 10006
rachel 10016