AddAccessGroup

Adds a group to the computer.

Syntax

IMzRoleAssignment AddAccessGroup(DirectoryEntry groupDE)
IMzRoleAssignment AddAccessGroup(SearchResult groupSR)
IMzRoleAssignment AddAccessGroup(string groupDn)
IMzRoleAssignment AddAccessGroup(IAdsGroup groupIAds)

Parameters

Specify one of the following parameters when using this method.

Parameter Description

groupDE

The directory entry for the group you want to add.

groupSr

The directory entry for a group specified as a search result.

groupDn

The group specified as a distinguished name.

groupIads

The IADs interface to the group.

Return value

The computer role assignment that includes the specified group (IMzRoleAssignment.TrusteeType==Group).

Discussion

The role assignment is not stored in Active Directory until you call the Commitmethod.

The AddAccessGroup(DirectoryEntry groupDE) and AddAccessGroup(SearchResult groupSr) methods are available only for .NET-based programs. Call AddRoleAssignmentfor VBScript.

Exceptions

AddAccessGroup may throw one of the following exceptions:

  • ApplicationException if the specified parameter is not a group or the method cannot find the group.
  • ArgumentNullException if you pass a null parameter.