Sie sind hier: Startseite
 Liste aller Codebeispiele

Informationen zu einem Benutzer ausgeben

Ein Beispiel zum Einsatz der Klasse System.DirectoryServices.DirectoryEntry aus der .NET-Klassenbibliothek.

Autor: Dr. Holger Schwichtenberg

Beschreibung

Ein Benutzer-Objekt im Active Directory (AD-Klasse "user") besitzt zahlreiche Verzeichnisattribute. Ein Pflichtattribut, das alle Benutzer-Objekte besitzen, ist "SAMAccountName", das den NT4-kompatiblen Anmeldenamen enthält.
Die folgende Tabelle zeigt weitere Verzeichnisattribute eines Benutzer-Objekts im Active Directory.
Name Pflicht Mehrwertig Datentyp (Stringlänge)
"cn" Ja Nein DirectoryString (1-64)
"nTSecurityDescriptor" Ja Nein ObjectSecurityDescriptor (0-132096)
"objectCategory" Ja Nein DN
"objectClass" Ja Ja OID
"ObjectSid" Ja Nein OctetString (0-28)
"SAMAccountName" Ja Nein DirectoryString (0-256)
"accountExpires" Nein Nein INTEGER8
"accountNameHistory" Nein Ja DirectoryString
"badPwdCount" Nein Nein INTEGER
"comment" Nein Nein DirectoryString
"company" Nein Nein DirectoryString (1-64)
"createTimeStamp" Nein Nein GeneralizedTime
"department" Nein Nein DirectoryString (1-64)
"description" Nein Ja DirectoryString (0-1024)
"desktopProfile" Nein Nein DirectoryString
"displayName" Nein Nein DirectoryString (0-256)
"displayNamePrintable" Nein Nein PrintableString (1-256)
"DistinguishedName" Nein Nein DN
"division" Nein Nein DirectoryString (0-256)
"employeeID" Nein Nein DirectoryString (0-16)
"EmployeeType" Nein Nein DirectoryString (1-256)
"expirationTime" Nein Nein UTCTime
"FacsimileTelephoneNumber" Nein Nein DirectoryString (1-64)
"givenName" Nein Nein DirectoryString (1-64)
"homeDirectory" Nein Nein DirectoryString
"HomeDrive" Nein Nein DirectoryString
"homeMDB" Nein Nein DN
"Initials" Nein Nein DirectoryString (1-6)
"internationalISDNNumber" Nein Ja NumericString (1-16)
"l" Nein Nein DirectoryString (1-128)
"lastLogoff" Nein Nein INTEGER8
"LastLogon" Nein Nein INTEGER8
"logonCount" Nein Nein INTEGER
"LogonHours" Nein Nein OctetString
"logonWorkstation" Nein Nein OctetString
"manager" Nein Nein DN
"middleName" Nein Nein DirectoryString (0-64)
"Mobile" Nein Nein DirectoryString (1-64)
"name" Nein Nein DirectoryString (1-255)
"objectGUID" Nein Nein OctetString (16-16)
"ObjectVersion" Nein Nein INTEGER
"otherFacsimileTelephoneNumber" Nein Ja DirectoryString (1-64)
"OtherHomePhone" Nein Ja DirectoryString (1-64)
"physicalDeliveryOfficeName" Nein Nein DirectoryString (1-128)
"PostalAddress" Nein Ja DirectoryString (1-4096)
"postalCode" Nein Nein DirectoryString (1-40)
"PostOfficeBox" Nein Ja DirectoryString (1-40)
"profilePath" Nein Nein DirectoryString
"SAMAccountType" Nein Nein INTEGER
"scriptPath" Nein Nein DirectoryString
"street" Nein Nein DirectoryString (1-1024)
"streetAddress" Nein Nein DirectoryString (1-1024)
"TelephoneNumber" Nein Nein DirectoryString (1-64)
"title" Nein Nein DirectoryString (1-64)
"userWorkstations" Nein Nein DirectoryString (0-1024)
"whenChanged" Nein Nein GeneralizedTime
"whenCreated" Nein Nein GeneralizedTime
"wWWHomePage" Nein Nein DirectoryString (1-2048)

Beispiel
Die folgende Routine listet Informationen zu einem durch einen übergebenen LDAP-Pfad spezifizierten Benutzer-Objekt auf. Nach der Bindung des DirectoryEntry-Objekts an das Verzeichnisobjekt wird zunächst geprüft, ob das verwendete Objekt zur AD-Klasse "user" gehört. Nach der Ausgabe der Basisdaten werden vier benutzerspezifische Attribute (Anmeldename, Beschreibung, Telefonnummer, Stadt) ausgegeben.

Programmcodebeispiele Visual Basic .NET (VB.NET)

' ============================
' .NET-Code-Beispiel in Visual Basic .NET
' Informationen zu einem Benutzer ausgeben
' (C) Holger@Schwichtenberg.de
' ============================
Sub ADSBenutzerLesen(ByVal pfad As String)

Dim o As DirectoryEntry

out("# Informationen über den Benutzer: " & pfad)

' --- Zugriff auf Eintrag
o = New DirectoryEntry(pfad)
If o.SchemaClassName <> "user" Then Exit Sub

' --- Basisdaten des Eintrags
out("Name: " & o.Name)
out("Pfad: " & o.Path)
out("Klasse:" & o.SchemaClassName)
out("GUID: " & o.Guid.ToString)
out("Native GUID:" & o.NativeGuid)

' --- Ausgabe der Verzeichnisattribute
out("NT4-Anmeldename: " & _
o.Properties("SAMAccountName")(0))
out("Beschreibung: " & getAtt(o, "Description"))
out("Telefonnummer: " & getAtt(o, "telephoneNumber"))

out("Stadt: " & getAtt(o, "l"))

End Sub

Programmcodebeispiele CSharp (C#)

using System;
using System.DirectoryServices;
using ActiveDs;

namespace FCLBuch._SystemDirectoryServices {

public class Samples_ADSI {
public void ADSBenutzerLesen(string pfad) {

// Informationen zu einem Benutzer ausgeben
FclOutput.PrintOut("# Informationen über den Benutzer: " + pfad);

// Zugriff auf Eintrag
DirectoryEntry o = new DirectoryEntry(pfad);
if (o.SchemaClassName != "user")
return;

// Basis-Daten des Eintrags
FclOutput.PrintOut("Name: " + o.Name);
FclOutput.PrintOut("Pfad: " + o.Path);
FclOutput.PrintOut("Klasse:" + o.SchemaClassName);
FclOutput.PrintOut("GUID: " + o.Guid.ToString());
FclOutput.PrintOut("Native GUID:" + o.NativeGuid);

// Ausgabe der Verzeichnisattribute
FclOutput.PrintOut("NT4-Anmeldename: " + o.Properties["samAccountName"][0]);
FclOutput.PrintOut("Beschreibung: " + ADSI_HelperMethods.GetAtt(o, "Description"));
FclOutput.PrintOut("Telefonnummer: " + ADSI_HelperMethods.GetAtt(o, "telephoneNumber"));

FclOutput.PrintOut("Stadt: " + ADSI_HelperMethods.GetAtt(o, "l"));
}
}
}

Hinweise

Ausgaben werden in den Beispielen durch Hilfsroutinen wie out() und PrintOut() erzeugt. Diese sind hier nicht angegeben, da deren Implementierung von der jeweiligen Umgebung abhängt. Für Konsolenanwendungen können hier z.B. Console.WriteLine() einsetzen.


 

Querverweise

 Definition '.NET Framework Class Library'  Verfügbarkeit der Klasse 'System.DirectoryServices.DirectoryEntry'  Übersicht über den FCL-Namensraum 'System.DirectoryServices'  .NET & Visual Studio Community Portal

Buchtipp

Buchcover Windows PowerShell 5.1 und PowerShell Core 6.1 - Das Praxishandbuch (3. Auflage 2018/8. Auflage Gesamtreihe) Kindle Windows PowerShell 5.1 und PowerShell Core 6.1 - Das Praxishandbuch (3. Auflage 2018/8. Auflage Gesamtreihe) Kindle
Autoren: Dr. Holger Schwichtenberg
erschienen 2018, 1000 Seiten, 42,99 €
ISBN: 978-3-446-45923-6
Bestellung: Amazon.de oder im Buchhandel über ISBN 978-3-446-45923-6

Beratung & Support:

Schulungen zu diesem Thema:

 Anfrage für eine individuelle Schulung zum Thema Visual Basic;C#  Gesamter Schulungsthemenkatalog

Bücher zu diesem Thema:

 Datenbankprogrammierung mit .NET 4.0. Mit Visual Studio 2010 und SQL Server 2008 R2
 .NET 3.5
 Microsoft ASP.NET 4.0 mit C# 2010
 Webanwendungen mit ASP.NET 3.5 und AJAX Crashkurs
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.1: Datenbankprogrammierung mit .NET/.NET Core und C# (gedruckte Ausgabe)
 C# 7.3 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin (PDF)
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.1.1 und 2.0-Preview2: Datenbankprogrammierung mit .NET/.NET Core und C# (gedruckte Ausgabe)
 Moderne Datenzugriffslösungen mit Entity Framework Core 2.0/2.1 (Buchversion 5.x, Ebook PDF)
 Windows 8 Apps entwickeln mit C# und XAML - Crashkurs
 Microsoft Visual C# 2010
 Moderne Datenzugriffslösungen mit Entity Framework Core 3.0 (Buchversion 6.x, Kindle)
 Microsoft SQL Server 2008 R2 - Das Entwicklerbuch
 ASP.NET 4.0 mit Visual C# 2010
 ASP.NET 4.0
 Windows PowerShell - Konzepte, Praxiseinsatz, Erweiterungen
 Microsoft .NET 2.0 Crashkurs - Final Edition
 Essential PowerShell
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.1 und 2.0-Preview2 (Buchversion 1.4)
 Datenbankprogrammierung mit .NET 4.5. Mit Visual Studio 2012 und SQL Server 2012
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.1 (PDF)
 Office 2010 Programmierung mit VSTO und .NET 4.0: Word, Excel und Outlook erweitern und anpassen
 Modern Data Access with Entity Framework Core: Database Programming Using .NET, .NET Core, UWP, and Xamarin with C#
 Microsoft ASP.NET 2.0 mit Visual Basic 2005 - Das Entwicklerbuch
 .NET 3.5 Crashkurs
 Windows Scripting Lernen, 6. Auflage
 Microsoft .NET 4.5 Update - Crashkurs (EBOOK - PDF)
 Visual Basic 2010: Grundlagen, ADO.NET, Windows Presentation Foundation
 C# 8.0 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin (DRUCK)
 Windows Scripting (5. Auflage)
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.1.2 und 2.0-Preview2: Datenbankprogrammierung mit .NET/.NET Core und C# (PDF)
 C# 7.3 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin
 Microsoft ASP.NET 2.0 mit C# 2005 - Das Entwicklerbuch
 Effizienter Datenzugriff mit Entity Framework Core: Datenbankprogrammierung mit C# für .NET Framework, .NET Core und Xamarin
 Microsoft ASP.NET 3.5 mit Visual C# 2008 - Das Entwicklerbuch
 Einblicke in C# 6.0 (shortcuts 181) Kindle Edition
 .NET 4.0 Crashkurs
 Docker und die Containerwelt - Einstieg und Expertentipps rund um Docker-Container (shortcut)
 Microsoft .NET 4.5 Update - Crashkurs
 Moderne Datenzugriffslösungen mit Entity Framework Core 3.0 (Buchversion 6.x, Gedruckt)
 Moderne Webanwendungen für .NET-Entwickler: Server-Anwendungen, Web APIs, SPAs & HTML-Cross-Platform-Anwendungen mit ASP.NET, ASP.NET Core, JavaScript/TypeScript und Angular
 C# 7.2 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin (PDF)
 Windows Scripting Lernen, 2. Auflage
 Moderne Datenzugriffslösungen mit Entity Framework 6 (gedruckte Ausgabe)
 C# 7.3 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin (DRUCK)
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.x und 2.0: Datenbankprogrammierung mit .NET/.NET Core und C# (gedruckte Ausgabe)
 Visual Basic 2010
 Microsoft ASP.NET 4.5 mit C# 2012 - Entwicklerbuch
 Microsoft ASP.NET 3.5 mit Visual Basic 2008 - Das Entwicklerbuch
 Moderne Datenzugriffslösungen mit Entity Framework Core 3.0 (Buchversion 7.x, PDF)
 C# 8.0 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin (PDF)
 Moderne Datenzugriffslösungen mit Entity Framework Core 2.0 (Buchversion 4.x): Datenbankprogrammierung mit .NET/.NET Core und C# (gedruckte Ausgabe)
 Moderne Datenzugriffslösungen mit Entity Framework Core 2.0 (Buchversion 4.x): Datenbankprogrammierung mit .NET/.NET Core und C# (EBOOK - PDF)
 Moderne Datenzugriffslösungen mit Entity Framework 6 (EBOOK - PDF, MOBI, EPUB)
 C# 8.0 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.x und 2.0: Datenbankprogrammierung mit .NET/.NET Core und C# (EBOOK - PDF)
 Windows Scripting Lernen 5. Auflage
 Alle unsere aktuellen Fachbücher