Modifying groups

The following code sample modifies the Description property of a group.

ADSI

Import-Module Adaxes

# Connect to the Adaxes service
$ns = New-Object "Softerra.Adaxes.Adsi.AdmNamespace"
$service = $ns.GetServiceDirectly("localhost")

# Bind to the group
$groupDN = "CN=SalesGroup,CN=Groups,DC=domain,DC=com"
$group = $service.OpenObject("Adaxes://$groupDN", $null, $null, 0)

# Update the group
$group.Put("description", "My Description")
$group.SetInfo()

PowerShell

Import-Module Adaxes  

$identity = "SalesGroup" # sAMAccountName 
# $identity = "CN=SalesGroup,CN=Groups,DC=domain,DC=com"  # DN 
# $identity = "{EB5FEB21-E648-42AD-B86C-89D3C6807953}" # GUID 
# $identity = "S-1-5-21-573937-2149998-410785" # SID

Set-AdmGroup -Identity $identity -Description "My Description" -Server "domain.com" `
    -AdaxesService localhost

The following code sample modifies the Group Type property of a group.

ADSI

Import-Module Adaxes

# Connect to the Adaxes service
$ns = New-Object "Softerra.Adaxes.Adsi.AdmNamespace"
$service = $ns.GetServiceDirectly("localhost")

# Bind to the group
$groupDN = "CN=SalesGroup,CN=Groups,DC=domain,DC=com"
$group = $service.OpenObject("Adaxes://$groupDN", $null, $null, 0)

# Update the group
[Softerra.Adaxes.Interop.Adsi.ADS_GROUP_TYPE_ENUM]$groupType =
    "ADS_GROUP_TYPE_GLOBAL_GROUP, ADS_GROUP_TYPE_SECURITY_ENABLED"

$group.Put("groupType", [int]$groupType)
$group.SetInfo()

PowerShell

Import-Module Adaxes

$identity = "SalesGroup" # sAMAccountName
# $identity = "CN=SalesGroup,CN=Groups,DC=domain,DC=com"  # DN
# $identity = "{EB5FEB21-E648-42AD-B86C-89D3C6807953}" # GUID
# $identity = "S-1-5-21-573937-2149998-410785" # SID

Set-AdmGroup -Identity $identity -GroupCategory Security `
    -GroupScope Universal, -Server "domain.com" -AdaxesService localhost

The following code sample modifies the Description property of a group and includes a reason for modifying it.

Import-Module Adaxes

# Connect to the Adaxes service
$ns = New-Object("Softerra.Adaxes.Adsi.AdmNamespace")
$service = $ns.GetServiceDirectly("localhost")

# Bind to the group
$groupDN = "CN=SalesGroup,CN=Groups,DC=domain,DC=com"
$group = $service.OpenObject("Adaxes://$groupDN", $null, $null, 0)

# Specify reason
$reason = [Softerra.Adaxes.Adsi.OperationReasonInfo]::new(
    "#1234",         # Reason
    "Ticket number"  # Field label
)
$group.SetReason($reason)

# Update the group
$group.Put("description", "My Description")
$group.SetInfo()

Modifying groups

See also