System.DirectoryServices.AccountManagement Namnområde

Ger enhetlig åtkomst och manipulering av användar-, dator- och gruppsäkerhetsobjekt i flera huvudarkiv: Doménové služby Active Directory (AD DS), služba Active Directory Lightweight Directory Services (AD LDS) och Machine SAM (MSAM). System.DirectoryServices.AccountManagement hanterar katalogobjekt oberoende av System.DirectoryServices namnområdet.

Klasser

Name Description
AdvancedFilters

Den här klassen ger skrivbar åtkomst till vissa attribut så att användarna kan ändra skrivskyddade egenskaper för huvudobjektet "dummy" som skickas till ett PrincipalSearcher objekt när du använder Fråga efter exempel.

AuthenticablePrincipal

Kapslar in konto- och kontaktdata som är gemensamma för huvudkonton som kan autentiseras.

ComputerPrincipal

Kapslar in huvudkonton som är datorkonton.

DirectoryObjectClassAttribute

Representerar det schemaobjekt som används för att skapa ett objekt av den här typen i katalogen. Det här attributet krävs för huvudtillägg och kan bara anges för klasser.

DirectoryPropertyAttribute

Innehåller de data som krävs av arkivet för att mappa en huvudnamnsegenskap till ett katalogattribut. Det här attributet krävs för huvudtillägg och kan bara anges för en egenskap. Den måste anges för varje egenskap som representerar ett katalogattribut i den utökade klassen.

DirectoryRdnPrefixAttribute

RDN-prefixet som används för att konstruera RDN för det nya objektet som infogas i arkivet. Rdn-standardprefixet "CN" används av API:et för kontohantering om det här attributet inte har angetts. Det här attributet är valfritt och kan bara anges för huvudnamnstilläggsklasser.

GroupPrincipal

Kapslar in gruppkonton. Gruppkonton kan vara godtyckliga samlingar av huvudobjekt eller konton som skapats för administrativa ändamål.

MultipleMatchesException

Det här undantaget genereras av metoder som förväntar sig att matcha ett enskilt huvudobjekt när det finns flera matchningar till sökfrågan.

NoMatchingPrincipalException

Det här undantaget utlöses när inget matchande huvudobjekt kunde hittas med de angivna parametrarna.

PasswordException

Det här undantaget utlöses när ett lösenord inte uppfyller komplexitetskraven.

Principal

Kapslar in kontodata och åtgärder som är gemensamma för alla säkerhetsobjekt. Det här är den abstrakta basklass som alla säkerhetsobjekt härleds från.

PrincipalCollection

En föränderlig samling objekt som härletts Principal från klassen. Den här klassen är utformad för att användas för egenskaper med flera värden som innehåller Principal objekt. Om du ändrar innehållet i den här samlingen ändras innehållet i motsvarande butiksegenskap, som görs permanent när Save() anropas på motsvarande huvudobjekt.

PrincipalContext

Kapslar in den server eller domän som alla åtgärder utförs mot, den container som används som bas för dessa åtgärder och de autentiseringsuppgifter som används för att utföra åtgärderna.

PrincipalException

Basklassen med undantag som genereras av System.DirectoryServices.AccountManagement objekt.

PrincipalExistsException

Utlöses av Add metoden när ett försök görs att infoga ett huvudnamn som redan finns i samlingen, eller Save() när ett försök görs att spara ett nytt huvudnamn som redan finns i arkivet.

PrincipalOperationException

Utlöses när ADSI returnerar ett fel under en åtgärd för att uppdatera arkivet.

PrincipalSearcher

Kapslar in de metoder och sökmönster som används för att köra en fråga mot det underliggande huvudarkivet.

PrincipalSearchResult<T>

Returnerar en samling Principal objekt som returneras av en sökning.

PrincipalServerDownException

Det här undantaget utlöses när API:et inte kan ansluta till servern.

PrincipalValueCollection<T>

Flervärdesegenskaper, till exempel PermittedWorkstations, har ett värde av typen PrincipalValueCollection<T>. Den här klassen innehåller metoder för att räkna upp och ändra dessa värden.

UserPrincipal

Kapslar in huvudkonton som är användarkonton.

Uppräkningar

Name Description
ContextOptions

Anger de alternativ som används för bindning till servern. Programmet kan ange flera alternativ som är länkade med en bitvis OR-åtgärd.

ContextType

Anger vilken typ av arkiv som huvudkontot tillhör.

GroupScope

Anger omfånget för gruppens huvudnamn.

IdentityType

Anger identitetens format.

MatchType

Uppräkningen MatchType anger vilken typ av jämförelse som används i en sökning.

Kommentarer

Program för hanterade katalogtjänster kan dra nytta av API:et System.DirectoryServices.AccountManagement för att förenkla hanteringen av användar-, dator- och grupphuvudnamn. Lösningar som tidigare krävde invecklad kunskap om arkivet eller lång kod, till exempel att hitta alla grupper som en användare tillhör, utförs i några rader med kod med API:et System.DirectoryServices.AccountManagement .

Följande funktioner är tillgängliga i API:et System.DirectoryServices.AccountManagement :

  • Grundläggande katalogåtgärder som att skapa och uppdatera säkerhetsobjekt förenklas. Programmet kräver mindre kunskap om de underliggande arkiven för att utföra dessa åtgärder.

  • Program kan utöka objektmodellen till att omfatta nya typer av katalogobjekt.

  • Kontohanteringsuppgifter, till exempel aktivering och inaktivering av ett användarkonto, förenklas.

  • Stöd för flera butiker tillåter att gruppobjekt i Doménové služby Active Directory-databaser (AD DS), služba Active Directory Lightweight Directory Services (AD LDS) och MSAM-databaser (Machine SAM) innehåller medlemmar från olika typer av butiker.

  • Genom att fråga efter exempelsökning, som är tillgängligt i PrincipalSearcher klassen, kan program ange egenskaper för ett huvudobjekt och söka i det valda arkivet efter andra objekt som innehåller matchande egenskapsvärden.

  • Förbättrad sökning på dator-, användar- och gruppobjekt gör det möjligt för program att söka i det valda arkivet efter matchande huvudobjekt.

  • Rekursiv sökning, som är tillgänglig på objektet för gruppens huvudnamn, gör det möjligt för program att söka i en grupp rekursivt och endast returnera huvudobjekt som är lövnoder.

  • Validering av autentiseringsuppgifter mot sam-, AD DS- och AD LS-arkiven förenklas.

  • Anslutningshastigheten ökar med hjälp av funktionen Snabb samtidig bindning (FSB) när den är tillgänglig. Cachelagring av anslutningar minskar antalet portar som används.

Se även