API Reference
Class
DirectoryOrganizationalUnitHelper
Provides standard organizational unit lifecycle operations and content listing.
Inheritance
- Object
- DirectoryOrganizationalUnitHelper
Constructors
public DirectoryOrganizationalUnitHelper(Func<String, String, String, DirectoryMutationResult> createOrganizationalUnit = null, Func<String, String, Boolean, DirectoryMutationResult> deleteOrganizationalUnit = null, Func<String, String, String, String, DirectoryMutationResult> moveOrganizationalUnit = null, Func<String, String, Boolean, Int32, String, Nullable<Int32>, Nullable<Int32>, IReadOnlyList<String>, IReadOnlyList<DirectoryOrganizationalUnitListItem>> listOrganizationalUnits = null, Func<String, String, Boolean, Int32, String, IReadOnlyList<String>, IReadOnlyList<DirectoryOrganizationalUnitContentItem>> getOrganizationalUnitContents = null) #Initializes a new instance of the DirectoryOrganizationalUnitHelper class.
Parameters
- createOrganizationalUnit System.Func{System.String,System.String,System.String,ADPlayground.DirectoryMutationResult} = null
- Optional OU creation override.
- deleteOrganizationalUnit System.Func{System.String,System.String,System.Boolean,ADPlayground.DirectoryMutationResult} = null
- Optional OU deletion override.
- moveOrganizationalUnit System.Func{System.String,System.String,System.String,System.String,ADPlayground.DirectoryMutationResult} = null
- Optional OU move override.
- listOrganizationalUnits System.Func{System.String,System.String,System.Boolean,System.Int32,System.String,System.Nullable{System.Int32},System.Nullable{System.Int32},System.Collections.Generic.IReadOnlyList{System.String},System.Collections.Generic.IReadOnlyList{ADPlayground.DirectoryOrganizationalUnitListItem}} = null
- Optional OU listing override.
- getOrganizationalUnitContents System.Func{System.String,System.String,System.Boolean,System.Int32,System.String,System.Collections.Generic.IReadOnlyList{System.String},System.Collections.Generic.IReadOnlyList{ADPlayground.DirectoryOrganizationalUnitContentItem}} = null
- Optional OU contents override.
Methods
public DirectoryMutationResult CreateOrganizationalUnit(String name, String parentDistinguishedName, String description = null) #Returns:
DirectoryMutationResultCreates an organizational unit under a parent distinguished name.
Parameters
- name System.String
- Organizational unit name.
- parentDistinguishedName System.String
- Parent DN where the OU should be created.
- description System.String = null
- Optional OU description.
Returns
Mutation result details.
public DirectoryMutationResult DeleteOrganizationalUnit(String identity, String domainName = null, Boolean recursive = false) #Returns:
DirectoryMutationResultDeletes an organizational unit by identity.
Parameters
- identity System.String
- OU identity (DN, ou, or name).
- domainName System.String = null
- Optional domain DNS name.
- recursive System.Boolean = false
- When set, deletes all children recursively.
Returns
Mutation result details.
public IReadOnlyList<DirectoryOrganizationalUnitContentItem> GetOrganizationalUnitContents(String identity, String domainName = null, Boolean recursive = false, Int32 maxResults = 1000, String ldapFilter = null, IEnumerable<String> attributes = null) #Returns:
IReadOnlyList<DirectoryOrganizationalUnitContentItem>Lists contents of an organizational unit.
Parameters
- identity System.String
- OU identity (DN, ou, or name).
- domainName System.String = null
- Optional domain DNS name.
- recursive System.Boolean = false
- When set, includes all descendants.
- maxResults System.Int32 = 1000
- Maximum number of objects returned.
- ldapFilter System.String = null
- Optional custom LDAP filter; defaults to all objects.
- attributes System.Collections.Generic.IEnumerable{System.String} = null
- Optional additional attributes to include in result attribute bag.
Returns
OU content entries.
public IReadOnlyList<DirectoryOrganizationalUnitListItem> ListOrganizationalUnits(String domainName = null, String searchBaseDistinguishedName = null, Boolean recursive = true, Int32 maxResults = 1000, String nameLike = null, Nullable<Int32> minDepth = null, Nullable<Int32> maxDepth = null, IEnumerable<String> attributes = null) #Returns:
IReadOnlyList<DirectoryOrganizationalUnitListItem>Lists organizational units with hierarchy metadata.
Parameters
- domainName System.String = null
- Optional domain DNS name.
- searchBaseDistinguishedName System.String = null
- Optional search base DN; defaults to domain DN.
- recursive System.Boolean = true
- When set, includes child OUs recursively.
- maxResults System.Int32 = 1000
- Maximum number of OUs returned.
- nameLike System.String = null
- Optional wildcard filter for OU name/canonical name/DN.
- minDepth System.Nullable{System.Int32} = null
- Optional minimum OU depth (root OU depth is 1).
- maxDepth System.Nullable{System.Int32} = null
- Optional maximum OU depth (root OU depth is 1).
- attributes System.Collections.Generic.IEnumerable{System.String} = null
- Optional additional LDAP attributes to include in result attribute bag.
Returns
OU list entries.
public DirectoryMutationResult MoveOrganizationalUnit(String identity, String targetParentDistinguishedName, String newName = null, String domainName = null) #Returns:
DirectoryMutationResultMoves an organizational unit to a target parent.
Parameters
- identity System.String
- OU identity (DN, ou, or name).
- targetParentDistinguishedName System.String
- Target parent DN.
- newName System.String = null
- Optional new OU name after move.
- domainName System.String = null
- Optional domain DNS name.
Returns
Mutation result details.