CREATECOMPUTER()`¶

About CreateComputer¶

Creates an Active Directory computer object in the specified directory.

Method Signature¶

METHODS /AWS1/IF_DSR~CREATECOMPUTER
  IMPORTING
    !IV_DIRECTORYID TYPE /AWS1/DSRDIRECTORYID OPTIONAL
    !IV_COMPUTERNAME TYPE /AWS1/DSRCOMPUTERNAME OPTIONAL
    !IV_PASSWORD TYPE /AWS1/DSRCOMPUTERPASSWORD OPTIONAL
    !IV_ORGALUNITDISTINGUISHEDN00 TYPE /AWS1/DSRORGANIZATIONALUNITDN OPTIONAL
    !IT_COMPUTERATTRIBUTES TYPE /AWS1/CL_DSRATTRIBUTE=>TT_ATTRIBUTES OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_dsrcreatecomputerrslt
  RAISING
    /AWS1/CX_DSRAUTHNTCTNFAILEDEX
    /AWS1/CX_DSRCLIENTEXCEPTION
    /AWS1/CX_DSRDIRECTORYUNAVAILEX
    /AWS1/CX_DSRENTITYALRDYEXEX
    /AWS1/CX_DSRENTDOESNOTEXISTEX
    /AWS1/CX_DSRINVALIDPARAMETEREX
    /AWS1/CX_DSRSERVICEEXCEPTION
    /AWS1/CX_DSRUNSUPPORTEDOPEX
    /AWS1/CX_DSRCLIENTEXC
    /AWS1/CX_DSRSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING¶

Required arguments:¶

`iv_directoryid` `TYPE /AWS1/DSRDIRECTORYID` `/AWS1/DSRDIRECTORYID`¶

The identifier of the directory in which to create the computer account.

`iv_computername` `TYPE /AWS1/DSRCOMPUTERNAME` `/AWS1/DSRCOMPUTERNAME`¶

The name of the computer account.

`iv_password` `TYPE /AWS1/DSRCOMPUTERPASSWORD` `/AWS1/DSRCOMPUTERPASSWORD`¶

A one-time password that is used to join the computer to the directory. You should generate a random, strong password to use for this parameter.

Optional arguments:¶

`iv_orgalunitdistinguishedn00` `TYPE /AWS1/DSRORGANIZATIONALUNITDN` `/AWS1/DSRORGANIZATIONALUNITDN`¶

The fully-qualified distinguished name of the organizational unit to place the computer account in.

`it_computerattributes` `TYPE /AWS1/CL_DSRATTRIBUTE=>TT_ATTRIBUTES` `TT_ATTRIBUTES`¶

An array of Attribute objects that contain any LDAP attributes to apply to the computer account.

RETURNING¶

`oo_output` `TYPE REF TO /aws1/cl_dsrcreatecomputerrslt` `/AWS1/CL_DSRCREATECOMPUTERRSLT`¶

Domain /AWS1/RT_ACCOUNT_ID

Primitive Type NUMC

Examples¶

Syntax Example¶

This is an example of the syntax for calling the method. It includes every possible argument and initializes every possible value. The data provided is not necessarily semantically accurate (for example the value "string" may be provided for something that is intended to be an instance ID, or in some cases two arguments may be mutually exclusive). The syntax shows the ABAP syntax for creating the various data structures.

DATA(lo_result) = lo_client->createcomputer(
  it_computerattributes = VALUE /aws1/cl_dsrattribute=>tt_attributes(
    (
      new /aws1/cl_dsrattribute(
        iv_name = |string|
        iv_value = |string|
      )
    )
  )
  iv_computername = |string|
  iv_directoryid = |string|
  iv_orgalunitdistinguishedn00 = |string|
  iv_password = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lo_computer = lo_result->get_computer( ).
  IF lo_computer IS NOT INITIAL.
    lv_sid = lo_computer->get_computerid( ).
    lv_computername = lo_computer->get_computername( ).
    LOOP AT lo_computer->get_computerattributes( ) into lo_row.
      lo_row_1 = lo_row.
      IF lo_row_1 IS NOT INITIAL.
        lv_attributename = lo_row_1->get_name( ).
        lv_attributevalue = lo_row_1->get_value( ).
      ENDIF.
    ENDLOOP.
  ENDIF.
ENDIF.

To create a computer account¶

The following example creates a computer account in the specified directory, and joins the computer to the directory.

DATA(lo_result) = lo_client->createcomputer(
  it_computerattributes = VALUE /aws1/cl_dsrattribute=>tt_attributes(
    (
      new /aws1/cl_dsrattribute(
        iv_name = |ip|
        iv_value = |192.168.101.100|
      )
    )
  )
  iv_computername = |labcomputer|
  iv_directoryid = |d-92654abfed|
  iv_orgalunitdistinguishedn00 = |OU=Computers,OU=example,DC=corp,DC=example,DC=com|
  iv_password = |Str0ngP@ssw0rd|
).

/AWS1/IF_DSR=>CREATECOMPUTER()¶