DirectorySearcher

The DirectorySearcher class is used to perform directory search queries.

The class can only be used in PowerShell scripts executed on the server side. You can use it in scripts executed by business rules, custom commands, scheduled tasks, and Reports.

Inheritance: The DirectorySearcher class implements the IAdmDirectorySearcher interface.

Namespace: Softerra.Adaxes.Adsi.Search

Constructors

Methods

Properties

  • Property

  • Description

  • Pipelined

  • Gets a value indicating whether to apply access control to search results.

  • SearchParameters

  • Gets or sets the parameters for the directory search.

  • BaseObjectPath

  • Gets or sets the path of the directory object from which the search begins.

Details

DirectorySearcher()

Initializes a new instance of the DirectorySearcher class.

DirectorySearcher()

ExecuteSearch()

Performs a directory search and returns an instance of the IAdmSearchResultIterator interface that can be used to iterate through search results.

public IAdmSearchResultIterator ExecuteSearch()

Exceptions

Examples

The following code sample searches for users whose Department is Sales and exports their names and descriptions to a CSV file. The script can be executed as a part of a business rule, custom command, or scheduled task.

$csvFilePath = "\\SERVER\Share\Report.csv"

# Create an instance of the DirectorySearcher class
$searcher = New-Object "Softerra.Adaxes.Adsi.Search.DirectorySearcher" $null, $false

# Specify search parameters

# Limit the search to the OU on which a business rule, scheduled task or custom command is executed
$searcher.SearchParameters.BaseObjectPath = $Context.TargetObject.AdsPath
$searcher.SearchParameters.Criteria = New-AdmCriteria "user" {department -eq "Sales"}
$searcher.SearchParameters.SearchScope = "ADS_SCOPE_SUBTREE"
$searcher.SetPropertiesToLoad(@("name", "description"))

try
{
    # Execute search
    $searchResultIterator = $searcher.ExecuteSearch()
    
    # Fetch results
    $searchResults = $searchResultIterator.FetchAll()
    
    $csv = @()
    foreach ($searchResult in $searchResults)
    {
        $htable = @{
            Name = $searchResult.Properties["name"].Value;
            Description = $searchResult.Properties["description"].Value;
        }
        $userInfo = New-Object PSObject -Property $htable
        $csv += $userInfo
    }
    
    # Export to CSV
    $csv | Export-Csv $csvFilePath -NoTypeInformation
}
finally
{
    # Release resources used by the search
    $searchResultIterator.Dispose()
}

AddCriteria()

Merges the search criteria with another criteria, using the AND operator.

public void AddCriteria(Criteria criteria)

Parameters

The criteria parameter specifies the criteria to add.

Examples

The following code sample refines the search criteria.

# Create an instance of the DirectorySearcher class
$searcher = New-Object "Softerra.Adaxes.Adsi.Search.DirectorySearcher" $null, $false

# Specify the base criteria
$searcher.SearchParameters.Criteria = New-AdmCriteria -Type "contact" # Contacts

# Narrow down the criteria
$criteriaToAdd = New-AdmCriteria "contact" {mail -empty $false} # Contacts with email address
$searcher.AddCriteria($criteriaToAdd)

Pipelined

Gets a value indicating whether to apply access control to search results. If true, results will be returned according to the security roles assigned to the user on behalf of which the operation is executed. If false, all results will be returned.

  • Type:
  • bool
  • Access:
  • Read-only

SearchParameters

Gets or sets the parameters for the directory search.


BaseObjectPath

Gets or sets the path of the directory object from which the search begins. The path must be a valid ADS path string.

  • Type:
  • string
  • Access:
  • Read/Write

Requirements

Minimum required version: 2023

See also