System.DirectoryServices 8.0.0

The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org. Prefix Reserved
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package System.DirectoryServices --version 8.0.0
NuGet\Install-Package System.DirectoryServices -Version 8.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="System.DirectoryServices" Version="8.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add System.DirectoryServices --version 8.0.0
#r "nuget: System.DirectoryServices, 8.0.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install System.DirectoryServices as a Cake Addin
#addin nuget:?package=System.DirectoryServices&version=8.0.0

// Install System.DirectoryServices as a Cake Tool
#tool nuget:?package=System.DirectoryServices&version=8.0.0

About

Provides easy access to Active Directory Domain Services from managed code. Microsoft Active Directory Domain Services are the foundation for distributed networks built on Windows 2000 Server, Windows Server 2003 and Microsoft Windows Server 2008 operating systems that use domain controllers. The namespace contains two component classes, DirectoryEntry and DirectorySearcher, which use the Active Directory Services Interfaces (ADSI) technology. ADSI is the set of interfaces that Microsoft provides as a flexible tool for working with a variety of network providers. ADSI gives the administrator the ability to locate and manage resources on a network with relative ease, regardless of the size of the network.

Key Features

Active Directory Domain Services use a tree structure. Each node in the tree contains a set of properties. Use this library to traverse, search, and modify the tree, and read and write to the properties of a node.

  • The DirectoryEntry class encapsulates a node or object in the Active Directory Domain Services hierarchy. Use this class for binding to objects, reading properties, and updating attributes. Together with helper classes, DirectoryEntry provides support for life-cycle management and navigation methods, including creating, deleting, renaming, moving a child node, and enumerating children.
  • Use the DirectorySearcher class to perform queries against the Active Directory Domain Services hierarchy. LDAP is the only system-supplied Active Directory Service Interfaces (ADSI) provider that supports searching. A search of the Active Directory Domain Services hierarchy through DirectorySearcher returns instances of SearchResult, which are contained in an instance of the SearchResultCollection class.
  • Network administrators write scripts and applications that access Active Directory Domain Services to automate common administrative tasks, such as adding users and groups, managing printers, and setting permissions for network resources.

How to Use

Install the System.DirectoryServices library from nuget

dotnet add package System.DirectoryServices --version 7.0.1

The sample needs a real path to an Active Directory server to work properly:

using System.DirectoryServices;

namespace TestDirectoryServices
{
    internal class Program
    {
        static void Main(string[] args)
        {
            DirectoryEntry rootDse = new DirectoryEntry("LDAP://RootDSE");
            string configNamingContext = rootDse.Properties["configurationNamingContext"].Value.ToString();

            DirectoryEntry certTemplates = new DirectoryEntry("LDAP://CN=Certificate Templates,CN=Public Key Services,CN=Services," + configNamingContext);
            DirectorySearcher templatesSearch = new DirectorySearcher(certTemplates, "(objectClass=pKICertificateTemplate)", null, SearchScope.OneLevel);

            SearchResultCollection templates = templatesSearch.FindAll();

            foreach (SearchResult template in templates)
            {
                Console.WriteLine($"Name: {template.Properties["name"][0]} ({template.Properties["displayName"][0]})");
                Console.WriteLine($"Flags: {template.Properties["msPKI-Enrollment-Flag"][0]}");
            }
        }
    }
}

Main Types

The main types provided by this library are:

  • System.DirectoryServices.DirectoryEntry
  • System.DirectoryServices.DirectorySearcher

Additional Documentation

Feedback & Contributing

System.DirectoryServices is released as open source under the MIT license. Bug reports and contributions are welcome at the GitHub repository.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 is compatible.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (199)

Showing the top 5 NuGet packages that depend on System.DirectoryServices:

Package Downloads
System.DirectoryServices.AccountManagement The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Provides uniform access and manipulation of user, computer, and group security principals across the multiple principal stores: Active Directory Domain Services (AD DS), Active Directory Lightweight Directory Services (AD LDS), and Machine SAM (MSAM).

Microsoft.Windows.Compatibility The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

This Windows Compatibility Pack provides access to APIs that were previously available only for .NET Framework. It can be used from both .NET as well as .NET Standard.

Oracle.ManagedDataAccess.Core The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Oracle Data Provider for .NET (ODP.NET) Core is an ADO.NET driver that provides fast data access from Microsoft .NET Core clients to Oracle databases. ODP.NET Core consists of a single 100% managed code dynamic-link library.

System.Management.Automation The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Runtime for hosting PowerShell

Microsoft.Exchange.WebServices.NETStandard

The Exchange Web Services (EWS) Managed API provides a managed interface for developing .NET client applications that use EWS. By using the EWS Managed API, you can access almost all the information stored in an Office 365, Exchange Online, or Exchange Server mailbox.

GitHub repositories (24)

Showing the top 5 popular GitHub repositories that depend on System.DirectoryServices:

Repository Stars
PowerShell/PowerShell
PowerShell for every system!
mRemoteNG/mRemoteNG
mRemoteNG is the next generation of mRemote, open source, tabbed, multi-protocol, remote connections manager.
opserver/Opserver
Stack Exchange's Monitoring System
exceptionless/Exceptionless
Exceptionless application
googleprojectzero/sandbox-attacksurface-analysis-tools
Set of tools to analyze Windows sandboxes for exposed attack surface.
Version Downloads Last updated
9.0.0-preview.1.24080.9 1,169 2/13/2024
8.0.0 799,117 11/14/2023
8.0.0-rc.2.23479.6 15,878 10/10/2023
8.0.0-rc.1.23419.4 35,734 9/12/2023
8.0.0-preview.7.23375.6 21,807 8/8/2023
8.0.0-preview.6.23329.7 5,666 7/11/2023
8.0.0-preview.5.23280.8 1,816 6/13/2023
8.0.0-preview.4.23259.5 15,230 5/16/2023
8.0.0-preview.3.23174.8 28,719 4/11/2023
8.0.0-preview.2.23128.3 15,646 3/14/2023
8.0.0-preview.1.23110.8 10,711 2/21/2023
7.0.1 3,783,790 2/14/2023
7.0.0 3,555,288 11/7/2022
7.0.0-rc.2.22472.3 16,312 10/11/2022
7.0.0-rc.1.22426.10 63,195 9/14/2022
7.0.0-preview.7.22375.6 14,413 8/9/2022
7.0.0-preview.6.22324.4 4,701 7/12/2022
7.0.0-preview.5.22301.12 1,835 6/14/2022
7.0.0-preview.4.22229.4 11,001 5/10/2022
7.0.0-preview.3.22175.4 2,911 4/13/2022
7.0.0-preview.2.22152.2 12,943 3/14/2022
7.0.0-preview.1.22076.8 6,088 2/17/2022
6.0.2-mauipre.1.22102.15 3,003 2/15/2022
6.0.2-mauipre.1.22054.8 25,459 1/19/2022
6.0.1 4,966,386 2/14/2023
6.0.0 12,667,894 11/8/2021
6.0.0-rc.2.21480.5 17,575 10/12/2021
6.0.0-rc.1.21451.13 13,880 9/14/2021
6.0.0-preview.7.21377.19 6,941 8/10/2021
6.0.0-preview.6.21352.12 9,124 7/14/2021
6.0.0-preview.5.21301.5 13,450 6/15/2021
6.0.0-preview.4.21253.7 23,098 5/24/2021
6.0.0-preview.3.21201.4 10,812 4/8/2021
6.0.0-preview.2.21154.6 22,622 3/11/2021
6.0.0-preview.1.21102.12 24,487 2/12/2021
5.0.0 36,123,330 11/9/2020
5.0.0-rc.2.20475.5 12,386 10/13/2020
5.0.0-rc.1.20451.14 13,324 9/14/2020
5.0.0-preview.8.20407.11 10,027 8/25/2020
5.0.0-preview.7.20364.11 21,851 7/21/2020
5.0.0-preview.6.20305.6 9,189 6/25/2020
5.0.0-preview.5.20278.1 6,758 6/10/2020
5.0.0-preview.4.20251.6 18,601 5/18/2020
5.0.0-preview.3.20214.6 26,219 4/23/2020
5.0.0-preview.2.20160.6 17,841 4/2/2020
5.0.0-preview.1.20120.5 3,782 3/16/2020
4.7.0 19,006,969 12/3/2019
4.7.0-preview3.19551.4 4,225 11/13/2019
4.7.0-preview2.19523.17 13,282 11/1/2019
4.7.0-preview1.19504.10 11,499 10/15/2019
4.6.0 2,858,621 9/23/2019
4.6.0-rc1.19456.4 56,515 9/16/2019
4.6.0-preview9.19421.4 3,899 9/4/2019
4.6.0-preview9.19416.11 433 9/4/2019
4.6.0-preview8.19405.3 6,852 8/13/2019
4.6.0-preview7.19362.9 11,942 7/23/2019
4.6.0-preview6.19303.8 47,298 6/12/2019
4.6.0-preview6.19264.9 423 9/4/2019
4.6.0-preview5.19224.8 26,424 5/6/2019
4.6.0-preview4.19212.13 3,586 4/18/2019
4.6.0-preview3.19128.7 9,067 3/6/2019
4.6.0-preview.19073.11 38,421 1/29/2019
4.6.0-preview.18571.3 17,006 12/3/2018
4.5.0 13,456,319 5/29/2018
4.5.0-rc1 89,670 5/6/2018
4.5.0-preview2-26406-04 31,655 4/10/2018
4.5.0-preview1-26216-02 80,634 2/26/2018
4.5.0-preview1-25914-04 355,515 11/15/2017