DirectoryService / Client / create_computer

create_computer#

DirectoryService.Client.create_computer(**kwargs)#

Creates an Active Directory computer object in the specified directory.

See also: AWS API Documentation

Request Syntax

response = client.create_computer(
    DirectoryId='string',
    ComputerName='string',
    Password='string',
    OrganizationalUnitDistinguishedName='string',
    ComputerAttributes=[
        {
            'Name': 'string',
            'Value': 'string'
        },
    ]
)
Parameters:
  • DirectoryId (string) –

    [REQUIRED]

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

  • ComputerName (string) –

    [REQUIRED]

    The name of the computer account.

  • Password (string) –

    [REQUIRED]

    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.

  • OrganizationalUnitDistinguishedName (string) – The fully-qualified distinguished name of the organizational unit to place the computer account in.

  • ComputerAttributes (list) –

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

    • (dict) –

      Represents a named directory attribute.

      • Name (string) –

        The name of the attribute.

      • Value (string) –

        The value of the attribute.

Return type:

dict

Returns:

Response Syntax

{
    'Computer': {
        'ComputerId': 'string',
        'ComputerName': 'string',
        'ComputerAttributes': [
            {
                'Name': 'string',
                'Value': 'string'
            },
        ]
    }
}

Response Structure

  • (dict) –

    Contains the results for the CreateComputer operation.

    • Computer (dict) –

      A Computer object that represents the computer account.

      • ComputerId (string) –

        The identifier of the computer.

      • ComputerName (string) –

        The computer name.

      • ComputerAttributes (list) –

        An array of Attribute objects containing the LDAP attributes that belong to the computer account.

        • (dict) –

          Represents a named directory attribute.

          • Name (string) –

            The name of the attribute.

          • Value (string) –

            The value of the attribute.

Exceptions

  • DirectoryService.Client.exceptions.AuthenticationFailedException

  • DirectoryService.Client.exceptions.DirectoryUnavailableException

  • DirectoryService.Client.exceptions.EntityAlreadyExistsException

  • DirectoryService.Client.exceptions.EntityDoesNotExistException

  • DirectoryService.Client.exceptions.InvalidParameterException

  • DirectoryService.Client.exceptions.UnsupportedOperationException

  • DirectoryService.Client.exceptions.ClientException

  • DirectoryService.Client.exceptions.ServiceException