System.DirectoryServices.AccountManagement Namnområde
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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.