IAdmSetPropertiesAction

The IAdmSetPropertiesAction interface represents the Update the object action.

Inheritance: IAdmAction

Methods

Properties

  • Property

  • Description

  • PropertyList

  • Gets a property list with property modifications performed by this action.

Details

GetModificationDescriptionXml()

Gets the description of a specific property modification.

string GetModificationDescriptionXml(IADsPropertyEntry entry, int mask = 0)

Parameters

  • entry – the property entry to get the modification description for.
  • mask – a bitmask that specifies which bits of the property value will be changed. This parameter should be specified only if you need to obtain the modification description for a flag-based integer property. For example, Account options. To obtain the required mask value, call IAdmPropertyList::GetPropertyItemMask.

Examples

The following code sample gets the modification description for the Account options property.

Powershell
# The $action variable contains the IAdmSetPropertiesAction interface.

$propertyList = $action.PropertyList
$entry = $propertyList.GetPropertyItem("userAccountControl", "ADSTYPE_INTEGER")
$mask = $propertyList.GetPropertyItemMask("userAccountControl")
$description = $action.GetModificationDescriptionXml($entry, $mask)
C#
// The action variable contains the IAdmSetPropertiesAction interface.

IADsPropertyList propertyList = action.PropertyList;
IADsPropertyEntry entry = (IADsPropertyEntry)propertyList.GetPropertyItem(
    "userAccountControl", ADSTYPEENUM.ADSTYPE_INTEGER);

IAdmPropertyList propertyList2 = (IAdmPropertyList)action.PropertyList;
int mask = propertyList2.GetPropertyItemMask("userAccountControl");
string description = action.GetModificationDescriptionXml(entry, mask);

PropertyList

Gets a property list with property modifications performed by this action. You can use value references in property values (e.g. %username%, %department%). Value references will be replaced with the corresponding property values of the directory object targeted by the action.

Requirements

Minimum required version: 2025.1

See also