System.DirectoryServices
9.0.0-rc.2.24473.5
Prefix Reserved
dotnet add package System.DirectoryServices --version 9.0.0-rc.2.24473.5
NuGet\Install-Package System.DirectoryServices -Version 9.0.0-rc.2.24473.5
<PackageReference Include="System.DirectoryServices" Version="9.0.0-rc.2.24473.5" />
paket add System.DirectoryServices --version 9.0.0-rc.2.24473.5
#r "nuget: System.DirectoryServices, 9.0.0-rc.2.24473.5"
// Install System.DirectoryServices as a Cake Addin #addin nuget:?package=System.DirectoryServices&version=9.0.0-rc.2.24473.5&prerelease // Install System.DirectoryServices as a Cake Tool #tool nuget:?package=System.DirectoryServices&version=9.0.0-rc.2.24473.5&prerelease
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
- API documentation
- Active Directory Domain Services
- Active Directory Service Interfaces
- Lightweight Directory Access Protocol (LDAP)
Related Packages
Feedback & Contributing
System.DirectoryServices is released as open source under the MIT license. Bug reports and contributions are welcome at the GitHub repository.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. 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 was computed. 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. net9.0 is compatible. |
.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. |
-
.NETStandard 2.0
- System.IO.FileSystem.AccessControl (>= 5.0.0)
- System.Security.AccessControl (>= 6.0.0)
- System.Security.Principal.Windows (>= 5.0.0)
-
net8.0
- No dependencies.
-
net9.0
- No dependencies.
NuGet packages (226)
Showing the top 5 NuGet packages that depend on System.DirectoryServices:
Package | Downloads |
---|---|
System.DirectoryServices.AccountManagement
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
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. |
|
System.Management.Automation
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. |
|
PnP.Framework
PnP Framework contains the PnP Provisioning engine and a ton of extension methods that will make you more productive while developing for Microsoft 365. |
GitHub repositories (29)
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
|
|
filoe/cscore
An advanced audio library, written in C#. Provides tons of features. From playing/recording audio to decoding/encoding audio streams/files to processing audio data in realtime (e.g. applying custom effects during playback, create visualizations,...). The possibilities are nearly unlimited.
|