Scenari relativi a System.DirectoryServices.ActiveDirectory

Lo spazio dei nomi System.DirectoryServices.ActiveDirectory è stato progettato per semplificare lo sviluppo di applicazioni e utilità che eseguono attività comuni correlate ai Servizi di dominio Active Directory. Questo spazio dei nomi è un'API di alto livello in cui è incapsulata una quantità significativa di informazioni sulla struttura dei Servizi di dominio Active Directory, sulle reti basate sui Servizi di dominio Active Directory e su processi comuni dei Servizi di dominio Active Directory, ad esempio la replica e la gestione di trust. System.DirectoryServices.ActiveDirectory include oggetti che rappresentano elementi comuni dei Servizi di dominio di Active Directory, ad esempio gli insiemi di strutture, i controller di dominio, le classi e le proprietà dello schema e le pianificazioni di repliche.

In molti casi, per l'esecuzione delle attività non è necessario un ulteriore accesso ai Servizi di dominio Active Directory in aggiunta a quello fornito dallo spazio dei nomi System.DirectoryServices.ActiveDirectory. Alcune attività avanzate potrebbero tuttavia richiedere l'accesso ad attributi di un oggetto non implementati nello spazio dei nomi System.DirectoryServices.ActiveDirectory. A tale scopo, un'applicazione può utilizzare il metodo GetDirectoryEntry implementato da numerosi oggetti di System.DirectoryServices.ActiveDirectory. Con tale metodo, un'applicazione può recuperare DirectoryEntry per l'oggetto. L'applicazione può quindi analizzare o aggiornare DirectoryEntry utilizzando i metodi offerti dalla classe e da altre classi correlate di System.DirectoryServices. In questo modo, anche le applicazioni che necessitano di funzionalità avanzate dei Servizi di dominio Active Directory possono sfruttare i numerosi metodi specifici degli oggetti di System.DirectoryServices.ActiveDirectory che consentono di individuare un determinato oggetto di directory oppure di enumerare una serie di oggetti di directory di un determinato tipo con conoscenze di sviluppo minime relativamente agli elementi interni dello schema dei Servizi di dominio Active Directory e poche righe di codice di programma. Di seguito sono riportate le classi di System.DirectoryServices.ActiveDirectory che implementano il metodo GetDirectoryEntry:

Un altro oggetto di System.DirectoryServices che potrebbe risultare molto utile è l'oggetto System.DirectoryServices.DirectorySearcher, che consente l'esecuzione di ricerche in una sottostruttura dei Servizi di dominio Active Directory. Dopo aver ottenuto un oggetto DirectoryEntry, l'applicazione può creare un oggetto DirectorySearcher per eseguire ricerche nella sottostruttura dei Servizi di dominio Active Directory il cui elemento principale è costituito da DirectoryEntry. Un'applicazione può anche ottenere un oggetto System.DirectoryServices.DirectorySearcher direttamente da un oggetto DomainController o GlobalCatalog utilizzando il rispettivo metodo GetDirectorySearcher.

Scenario di gestione dello schema

Un'applicazione può utilizzare classi all'interno dello spazio dei nomi System.DirectoryServices.ActiveDirectory per eseguire query e aggiornamenti dello schema senza disporre di informazioni approfondite relative alla struttura dello schema.

La classe ActiveDirectorySchema include metodi in grado di enumerare le classi, ad esempio FindAllClasses e FindAllDefunctClasses. Un'applicazione può identificare le classi dello schema desiderate analizzando le proprietà di ogni oggetto ActiveDirectorySchemaClass individuato dal metodo di enumerazione. L'applicazione può quindi generare un report per la classe oppure aggiornare una o più proprietà dell'oggetto ActiveDirectorySchemaClass selezionato. L'applicazione potrebbe inoltre utilizzare l'insieme MandatoryProperties o OptionalProperties dell'oggetto per accedere agli oggetti ActiveDirectorySchemaProperty contenenti informazioni dettagliate sulle proprietà dello schema per tale classe, ad esempio se è presente o inattiva nel catalogo globale.

Analogamente, per identificare le proprietà dello schema con determinate caratteristiche, potrebbe inizialmente chiamare il metodo FindAllProperties della classe ActiveDirectorySchema per enumerare le proprietà, quindi analizzare le proprietà di ogni oggetto ActiveDirectorySchemaProperty restituito e modificare i dettagli di tale oggetto o generare report, in base alle esigenze.

Scenario di gestione della topologia

Un'applicazione può utilizzare le classi dello spazio dei nomi System.DirectoryServices.ActiveDirectory per analizzare e modificare la topologia di un'installazione dei Servizi di dominio Active Directory.

Un'applicazione può visualizzare o aggiornare le informazioni di oggetti dei Servizi di dominio Active Directory, ad esempio Forest, Domain, ActiveDirectorySite e ActiveDirectorySubnet, nonché esplorare le relazioni tra gli oggetti in uno dei due modi indicati di seguito.

Utilizzo di metodi e proprietà degli oggetti che restituiscono uno o più oggetti di un diverso tipo. Per elencare tutti i domini di tutti i siti, un'applicazione potrebbe ad esempio eseguire un'enumerazione in ActiveDirectorySiteCollection. Potrebbe quindi recuperare l'insieme Domains per ogni ActiveDirectorySite in ActiveDirectorySiteCollection e infine generare un report contenente un elenco dei nomi di tutti i domini contenuti in ogni sito.
Accesso ad agli altri oggetti che rappresentano relazioni tra gli oggetti dei Servizi di dominio Active Directory sopra specificati. Ad esempio, la proprietà Sites dell'oggetto ActiveDirectorySiteLink consente di recuperare un insieme di tutti i siti contenuti in tale oggetto ActiveDirectorySiteLink. Analogamente, la proprietà SiteLinks dell'oggettoActiveDirectorySiteLinkBridge consente di recuperare un insieme di tutti gli oggetti ActiveDirectorySiteLink associati a ActiveDirectorySiteLinkBridge.

Scenario di gestione di insiemi di strutture o di trust di dominio

Un'applicazione può accedere a un insieme di tutti i trust definiti per un oggetto Domain o Forest. In entrambi i casi, l'applicazione può utilizzare il metodo GetAllTrusts dell'oggetto per restituire un oggetto TrustRelationshipInformationCollection. L'applicazione può quindi eseguire un'iterazione in tale insieme per visualizzare o aggiornare gli oggetti TrustRelationshipInformation in esso contenuti. Nello spazio dei nomi System.DirectoryServices.ActiveDirectory sono inoltre definiti gli oggetti aggiuntivi, ad esempio TrustDirection e TrustType, che offrono valori enumerati che rappresentano rispettivamente direzioni di trust e tipi di trust validi.

Scenario di monitoraggio della replica

Un'altra applicazione comune per lo spazio dei nomi System.DirectoryServices.ActiveDirectory è rappresentata dalla replica dei Servizi di dominio Active Directory.

Lo spazio dei nomi System.DirectoryServices.ActiveDirectory implementa alcune classi contenenti informazioni sullo stato di replica, ad esempio: ReplicationConnection, ReplicationCursor, ReplicationFailure, ReplicationOperation e ReplicationOperationInformation.

Per creare un report per lo stato di replica di tutte le partizioni definite in un determinato controller di dominio, un'applicazione potrebbe ad esempio esaminare gli oggetti ReplicationCursor associati a ogni partizione. L'oggetto DomainController desiderato potrebbe essere individuato mediante il metodo FindOne dell'oggetto DomainController. L'applicazione potrebbe quindi fare riferimento alla proprietà dell'insieme Partitions di DomainController ed enumerare tutte le partizioni nel controller di dominio. L'applicazione può ottenere l'insieme di tutti gli oggetti ReplicationCursor per la partizione mediante il metodo GetReplicationCursors ed eseguire un'enumerazione in tale insieme di oggetti ReplicationCursor visualizzando i valori di proprietà come SourceServer, SourceInvocationId eLastSuccessfulSyncTime.

Vedere anche

Concetti

Cenni preliminari sullo spazio dei nomi System.DirectoryServices.ActiveDirectory
Architettura di System.DirectoryServices.ActiveDirectory

Send comments about this topic to Microsoft.

Last updated on 2008-09-06