System.DirectoryServices.AccountManagement Naamruimte
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Biedt uniforme toegang en manipulatie van beveiligingsprincipals voor gebruikers, computers en groepen in meerdere principal stores: Active Directory Domain Services (AD DS), Active Directory Lightweight Directory Services (AD LDS) en Machine SAM (MSAM). System.DirectoryServices.AccountManagement beheert mapobjecten onafhankelijk van de System.DirectoryServices naamruimte.
Klassen
| Name | Description |
|---|---|
| AdvancedFilters |
Deze klasse biedt schrijfbare toegang tot bepaalde kenmerken, zodat gebruikers alleen-lezeneigenschappen kunnen wijzigen van het principal-object dummy dat wordt doorgegeven aan een PrincipalSearcher object wanneer ze Query by Example gebruiken. |
| AuthenticablePrincipal |
Hiermee worden het account en de contactgegevens ingekapseld voor principals die kunnen worden geverifieerd. |
| ComputerPrincipal |
Hiermee worden principals ingekapseld die computeraccounts zijn. |
| DirectoryObjectClassAttribute |
Vertegenwoordigt het schemaobject dat wordt gebruikt voor het maken van een object van dit type in de map. Dit kenmerk is vereist voor principal-extensies en kan alleen worden ingesteld voor klassen. |
| DirectoryPropertyAttribute |
Bevat de gegevens die het archief nodig heeft om een principal-eigenschap toe te wijzen aan een mapkenmerk. Dit kenmerk is vereist voor principal-extensies en kan alleen worden ingesteld op een eigenschap. Deze moet worden opgegeven voor elke eigenschap die een mapkenmerk in de uitgebreide klasse vertegenwoordigt. |
| DirectoryRdnPrefixAttribute |
Het RDN-voorvoegsel dat wordt gebruikt om de RDN te maken voor het nieuwe object dat in het archief wordt ingevoegd. Het standaard RDN-voorvoegsel van CN wordt gebruikt door de Account Management-API als dit kenmerk niet is ingesteld. Dit kenmerk is optioneel en kan alleen worden ingesteld voor principal-extensieklassen. |
| GroupPrincipal |
Groepsaccounts worden ingekapseld. Groepsaccounts kunnen willekeurige verzamelingen principal-objecten of accounts zijn die zijn gemaakt voor beheerdoeleinden. |
| MultipleMatchesException |
Deze uitzondering wordt gegenereerd door methoden die verwachten dat het overeenkomt met één principal-object wanneer er meerdere overeenkomsten zijn met de zoekquery. |
| NoMatchingPrincipalException |
Deze uitzondering wordt gegenereerd wanneer er geen overeenkomend principal-object kan worden gevonden met de opgegeven parameters. |
| PasswordException |
Deze uitzondering wordt gegenereerd wanneer een wachtwoord niet voldoet aan de complexiteitsvereisten. |
| Principal |
Hiermee worden de accountgegevens en -bewerkingen ingekapseld voor alle beveiligingsprinciplen. Dit is de abstracte basisklasse waaruit alle beveiligingsprinciplen worden afgeleid. |
| PrincipalCollection |
Een onveranderbare verzameling objecten die zijn afgeleid van de Principal klasse. Deze klasse is ontworpen voor gebruik voor eigenschappen met meerdere waarden die objecten bevatten Principal . Als u de inhoud van deze verzameling bewerkt, wordt de inhoud van de bijbehorende winkeleigenschap gewijzigd, die permanent wordt gemaakt wanneer Save() het bijbehorende principal-object wordt aangeroepen. |
| PrincipalContext |
Kapselt de server of het domein in waarop alle bewerkingen worden uitgevoerd, de container die wordt gebruikt als basis van deze bewerkingen en de referenties die worden gebruikt om de bewerkingen uit te voeren. |
| PrincipalException |
De basisklasse van uitzonderingen die door System.DirectoryServices.AccountManagement objecten worden gegenereerd. |
| PrincipalExistsException |
Gegenereerd door Add methode wanneer er een poging wordt gedaan om een principal in te voegen die al in de verzameling bestaat, of Save() wanneer er een poging wordt gedaan om een nieuwe principal op te slaan die al in het archief aanwezig is. |
| PrincipalOperationException |
Gegenereerd wanneer ADSI een fout retourneert tijdens een bewerking om de store bij te werken. |
| PrincipalSearcher |
Hiermee worden de methoden en zoekpatronen ingekapseld die worden gebruikt om een query uit te voeren op basis van het onderliggende principal-archief. |
| PrincipalSearchResult<T> |
Retourneert een verzameling Principal objecten die worden geretourneerd door een zoekopdracht. |
| PrincipalServerDownException |
Deze uitzondering wordt gegenereerd wanneer de API geen verbinding kan maken met de server. |
| PrincipalValueCollection<T> |
Eigenschappen met meerdere waarden, zoals PermittedWorkstations, hebben een waarde van het type PrincipalValueCollection<T>. Deze klasse biedt methoden voor het inventariseren en manipuleren van deze waarden. |
| UserPrincipal |
Hiermee worden principals ingekapseld die gebruikersaccounts zijn. |
Enums
| Name | Description |
|---|---|
| ContextOptions |
Hiermee geeft u de opties die worden gebruikt voor binding met de server. De toepassing kan meerdere opties instellen die zijn gekoppeld aan een bitwise OR-bewerking. |
| ContextType |
Hiermee geeft u het type winkel waartoe de principal behoort. |
| GroupScope |
Hiermee geeft u het bereik van de groepsprincipaal op. |
| IdentityType |
Hiermee geeft u de indeling van de identiteit. |
| MatchType |
De MatchType opsomming geeft het type vergelijking aan dat in een zoekopdracht wordt gebruikt. |
Opmerkingen
Toepassingen voor beheerde directoryservices kunnen profiteren van de System.DirectoryServices.AccountManagement API om het beheer van gebruikers-, computer- en groepsprinciplen te vereenvoudigen. Oplossingen die eerder complexe kennis van de winkel of lange code nodig hebben, zoals het vinden van alle groepen waartoe een gebruiker behoort, worden uitgevoerd in een paar regels code met de System.DirectoryServices.AccountManagement API.
De volgende functies zijn beschikbaar in de System.DirectoryServices.AccountManagement API:
Basismapbewerkingen, zoals het maken en bijwerken van beveiligingsprinciplen, worden vereenvoudigd. De toepassing vereist minder kennis van de onderliggende winkels om deze bewerkingen uit te voeren.
Toepassingen kunnen het objectmodel uitbreiden met nieuwe typen mapobjecten.
Accountbeheertaken, zoals het in- en uitschakelen van een gebruikersaccount, worden vereenvoudigd.
Ondersteuning voor meerdere winkels staat groepsobjecten toe in de databases Active Directory Domain Services (AD DS), Active Directory Lightweight Directory Services (AD LDS) en MSAM-databases (Machine SAM) om leden uit verschillende typen winkels te bevatten.
Query's uitvoeren op voorbeeldzoekopdracht, beschikbaar in de PrincipalSearcher klasse, stelt toepassingen in staat om eigenschappen in te stellen op een principal-object en te zoeken in het geselecteerde archief naar andere objecten die overeenkomende eigenschapswaarden bevatten.
Verbeterde zoekfunctie op computer-, gebruikers- en groepsprincipaalobjecten stelt toepassingen in staat om in het geselecteerde archief te zoeken naar overeenkomende principal-objecten.
Recursieve zoekopdrachten, beschikbaar op het principal-object van de groep, stellen toepassingen in staat om recursief een groep te doorzoeken en alleen principal-objecten te retourneren die leaf-knooppunten zijn.
Referentievalidatie voor de machine-SAM-, AD DS- en AD LS-archieven wordt vereenvoudigd.
Verbindingssnelheden worden verhoogd met behulp van de functie Fast Concurrent Bind (FSB), indien beschikbaar. De cache van verbindingen vermindert het aantal gebruikte poorten.