GPPermissionCollection.RemoveTrustee Method (IdentityReference)

 

Removes all policy-related permissions for the trustee that is specified by the IdentityReference from the GPPermissionCollection instance.

Namespace:   Microsoft.GroupPolicy
Assembly:  Microsoft.GroupPolicy.Management (in Microsoft.GroupPolicy.Management.dll)

Syntax

public void RemoveTrustee(
    IdentityReference identity
)

public:
void RemoveTrustee(
    IdentityReference^ identity
)

member RemoveTrustee : 
        identity:IdentityReference -> unit

Public Sub RemoveTrustee (
    identity As IdentityReference
)

Parameters

• identity
  Type: System.Security.Principal.IdentityReference

  A IdentityReference that represents the trustee to remove.

Exceptions

Exception	Condition
ArgumentNullException	identity is null.

Remarks

A trustee is a user, computer, or security group that can be granted permissions on a GPO, SOM, or WMI filter.

On successful removal of a permission, the method updates all enumerators returned by the GetEnumerator method, even if a removal occurs during the enumeration of elements.

For more information about policy-related permissions, see GPPermissionType. For more information about security groups, see How Security Groups are Used in Access Control in the Active Directory Programmer's Guide.

See Also

RemoveTrustee Overload
GPPermissionCollection Class
Microsoft.GroupPolicy Namespace

Return to top