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:

• delete_object deletes the Active Directory object from Active Directory.
• delete_sub_tree deletes the Active Directory object and all of its children.
• get_object_field reads a field value from the Active Directory object.
• remove_object_value removes a value from a multi-valued attribute of the Active Directory object.
• save_object saves the Active Directory object.
• set_object_field sets a field value in the Active Directory object.