add_object_value

Use the add_object_value command to add a value to a multi-valued field (attribute) of a specified Active Directory object in Active Directory. This command only works on the object in Active Directory, not on the currently selected Active Directory object in memory (if there is one).

If the added value isn’t valid, Active Directory will report an error and add_object_value won’t save the value.

This command is useful for fields that may be very large—members of a group, for example.

Zone type

Not applicable

Syntax

add_object_value dn field value

Abbreviation

aov

Options

This command takes no options.

Arguments

This command takes the following arguments:

Argument Type Description

dn

string

Required. Specifies the distinguished name (DN) of the Active Directory object in which to add a value.

field

string

Required. Specifies the name of a multi-valued field in the currently selected Active Directory object to which to add the value. This can be any field that is valid for the type of the currently selected Active Directory object.

value

 

Required. Specifies the value to add to the field. The type of value depends on the field specified by the field argument.

Return value

This command returns nothing if it runs successfully.

Examples

add_object_value cn=groups,dc=acme,dc=com users adam.avery

This example adds the value adam.avery to the users field of the groups object specified by the DN.

Related commands

The following commands enable you to work with Active Directory objects: