joinDomain

Joins the specified server into the existing domain identified by the domain distinguished name.

Request

<joinDomain>
   <server/>
   <domain/>
   <mode/>
   <unp/>
   <user/>
   <password/>
</joinDomain>

Reply

<joinDomain>
   <result value=" ">
      <description/>
   </result> 
</joinDomain>

Elements

server

(Optional) Specifies the distinguished name of the eDirectory server object. The name must be a fully distinguished name, including the leading dot before the object name and the trailing dot after the tree name (or with no leading or trailing dot but a complete identity of the object within the current tree). The default is the eDirectory object for the physical server.

domain

Specifies the eDirectory name (in typeless, distinguished-name format) of the domain object that represents the domain to be joined.

mode

Specifies the mode of the server to be set in the server configuration:

  • domainMember
  • domainController
unp

(Optional) Specifies the NMAS-encrypted username and password that has rights to perform the operation at the specified context.

user

(Optional) Specifies the clear-text user name of a user that has rights to perform the operation. This element is used only if the unp element is not specified.

password

(Optional/Required if user is specified) Specifies the clear-text password of a user that has rights to perform the operation.

result

Specifies a zError or eDirectory value or 0 (for no error).

description

Specifies a text description of the result.