Programming Guides › Programming Guide for Perl › CLI Policy Management Methods › Session Methods › CreateAdmin Method—Creates System-Level Administrator

CreateAdmin Method—Creates System-Level Administrator

The CreateAdmin method creates and configures a system-level administrator.

Syntax

The CreateAdmin method has the following format:

Netegrity::PolicyMgtSession‑>CreateAdmin(adminName[, adminDesc][, adminPwd][, userDir][, authScheme])

Parameters

The CreateAdmin method accepts the following parameters:

adminName (string)

Specifies the administrator's name.

adminDesc (string)

(Optional) Specifies the administrator's description.

adminPwd (string)

(Optional) Specifies the administrator's password.

userDir (PolicyMgtUserDir object)

(Optional) Specifies the user directory if the administrator is stored in an external directory.

authScheme (PolicyMgtAuthScheme object)

(Optional) Specifies the authentication scheme to use if the administrator is stored in an external directory.

Note: This parameter is required if an external user directory is specified.

Return Value

The CreateAdmin method returns one of the following values:

• PolicyMgtAdmin (object)
• undef if the call is unsuccessful or the administrator name already exists

Remarks

The Policy Management API does not allow you to create an administrator for a particular domain. However, you can add an existing administrator to a particular domain by calling the method AddAdmin. To create an administrator with domain privileges, use the Administrative UI.