The CreateUser procedure creates a new user within a specified organization according to the policy name passed in as <policyName>. Possible values for this tag are "hosting," "reseller," "customer," and "default." The default policy creates only the requested organization. The exact behaviors of these policies are defined in the GetPolicy procedure in the Managed Active Directory namespace.
The CreateUser procedure has the following input parameters.
The CreateUser procedure returns the <user> tag containing the user object created and the membership and security policies supplied. Each object created has its LDAP path in a "path" attribute.
When creating a user, it is necessary to also ensure that the new user's sAMAccountName is unique within the domain. If it is not, the CreateUser procedure will fail. Also, interactions with Exchange make it undesirable for the '@' character to appear in a sAMAccountName. Therefore, when creating or renaming a user or group, the sAMAccountName will be similar to the input name (or Universal principal name), except that illegal sAMAccountName characters are removed, and '@' characters are replaced with '_'. If the sAMAccountName collides with an existing sAMAccountName, then a random string of digits will be appended to the sAMAccountName to ensure uniqueness.
The algorithm for generating a sAMAccountName from the seed name (Universal Principal Name for a user, or CN if the object is a group), is as follows:
The CreateUser procedure has the following security requirements:
The CreateUser procedure retrieves policy information using the GetPolicy procedure of the Managed Active Directory Namespace.
The following steps occur when creating a user with the CreateUser procedure of the Managed Windows-based Hosting Namespace:
Example XML Request
The following is an example of an XML request for the CreateUser procedure of the Managed Windows-based Hosting Namespace:
Example XML Response
The following is an example of an XML response from the CreateUser procedure of the Managed Windows-based Hosting Namespace:
Managed Windows-based Hosting Namespace API for: