Commit

Commits any changes or updates to the GroupUnixProfile object and saves the changes to Active Directory.

Syntax

void Commit()

Discussion

This method commits to Active Directory any new or changed values in the group UNIX profile. If an object is marked for deletion, calling this method completes the operation and deletes the object from Active Directory. The method also increments the next available group identifier (GID) by one, if applicable and permitted. The method does not validate the data before saving it in Active Directory.

Exceptions

Commit may throw one of the following exceptions:

  • ApplicationExceptionif it failed to get the directory entry of the group profile.

  • COMException if an LDAP error occurs. LDAP errors can occur if the connection to the LDAP server fails, the connection times out, invalidcredentials are presented, or there are other problems communicating with Active Directory.

  • ObjectAlreadyExistsException if the method receives a COMException with an LDAP object already exists error code.

Example

The following code sample illustrates using Commit in a script:

...  
'Identify the zone you want to work with  
set objZone = cims.GetZoneByPath("LDAP://cn=onsite,cn=Zones,
cn=UNIX,dc=arcade,dc=com")  
'Identify the Active Directory group  
Set objGroup = cims.GetGroupByPath("CN=escalation,CN=support, DC=arcade,DC=com”)

'Remove the membership requirement for the group  
Set objGroup.IsMembershipRequired = false  
‘Save the changes in Active Directory  
objGroup.commit  
...