How to use AD Users | Set Attributes Value rule to update multi-valued attributes

Overview

This article contains step-by-step instructions on how to use the AD Users | Set attribute value rule to update multi-valued attributes.

Instructions

Replace values

1. In the Cayosoft Administrator Console, navigate to Rules > Active Directory > AD Users | Set Attributes Value.

2. Specify the rule scope.

3. In the Attributes specify a multivalued attribute to replace the values. For example, accountNameHistory.

4. Set Value to {@("value1", "value2")}

5. Save changes.

Append values

1. In the Cayosoft Administrator Console, navigate to Rules > Active Directory > AD Users | Set Attributes Value.

2. Specify the rule scope.

3. Open the More Options section and add the accountNameHistory attribute to Returned properties.

4. In the Attributes, specify a multivalued attribute to append the values. For example, accountNameHistory.

5. Add this script to Value:

   Copy

   { $FoundObject.accountNameHistory | %{ $ret=@("VALUE_TO_APPEND1","VALUE_TO_APPEND2") }{ $ret+=$_.ToString() }{ $ret } }

6. Save changes.

Remove value

1. In the Cayosoft Administrator Console, navigate to Rules > Active Directory > AD Users | Set Attributes Value.

2. Specify the rule scope.

3. Open the More Options section and add the accountNameHistory attribute to Returned properties.

4. In the Attributes, specify a multivalued attribute to remove the value. For example, accountNameHistory.

5. Add this script to Value:
   

   Copy

   { $FoundObject.accountNameHistory | %{ $ret=@() }{if($_ -eq "VALUE_TO_REMOVE"){return} $ret+=$_.ToString() }{ $ret } }

6. Save changes.