How to use AD Users | Set attribute value rule to update multi-valued attributes

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

Applies to: Cayosoft Administrator 8.4.0 or later

ID: KB20220421-1

---

Instructions

Replace values

1. In Admin Console navigate to Home > RULES > Active Directory > AD Users | Set Attribute Value.
2. Specify the rule scope.
3. In 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 Admin Console navigate to Home > RULES > Active Directory > AD Users | Set Attribute Value.
2. Specify the rule scope.
3. Open the More Options section and add the accountNameHistory attribute to Returned properties.
4. In Attributes specify a multivalued attribute to append the values. For example, accountNameHistory.
5. Add this script to Value: 
   

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

6. Save changes.

 

Remove value

1. In Admin Console navigate to Home > RULES > Active Directory > AD Users | Set Attribute Value.
2. Specify the rule scope.
3. Open the More Options section and add the accountNameHistory attribute to Returned properties.
4. In Attributes specify a multivalued attribute to remove the value. For example, accountNameHistory.
5. Add this script to Value: 
   

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

6. Save changes.