System.DirectoryServices 네임스페이스

업데이트: 2007년 11월

이 네임스페이스에 있는 클래스는 모든 Active Directory 도메인 서비스 서비스 공급자와 함께 사용할 수 있습니다. 현재 사용 가능한 공급자로는 IIS(인터넷 정보 서비스), LDAP(Lightweight Directory Access Protocol), Novell NDS(NetWare Directory Service) 및 WinNT가 있습니다.

ADSI는 프로그래밍 방식의 Microsoft Active Directory 도메인 서비스의 인터페이스로, 사용자 응용 프로그램에서 단일 인터페이스를 통해 네트워크상의 다양한 디렉터리와 상호 작용할 수 있게 해줍니다. ADSI를 사용하면 데이터베이스 백업, 프린터 액세스, 사용자 계정 관리 등의 일반적인 작업을 수행하는 응용 프로그램을 만들 수 있습니다.

이 클래스를 사용하려면 Active Directory 도메인 서비스에 대한 기본 지식이 필요합니다. Active Directory 도메인 서비스에 대한 자세한 내용은 Active Directory 개체 소개(영문 페이지일 수 있음) 및 Active Directory 기술 배경(영문 페이지일 수 있음) 항목과 MSDN Library(http://msdn2.microsoft.com/ko-kr/library/default.aspx)의 다음 항목을 참조하십시오.

• Active Directory 도메인 서비스 사용(영문 페이지일 수 있음)

• Active Directory 서비스 인터페이스(영문 페이지일 수 있음)

• Lightweight Directory Access Protocol(영문 페이지일 수 있음)

• Active Directory 서비스 인터페이스 공급자 구현(영문 페이지일 수 있음)

• ADSI 개체에 바인딩(영문 페이지일 수 있음)

• IADsOpenDSObject::OpenDSObject(영문 페이지일 수 있음)

Active Directory 도메인 서비스는 트리 구조를 사용합니다. 트리에서는 각 노드마다 속성 집합을 포함합니다. 트리를 통과, 검색 및 수정하거나 노드 속성을 읽고 쓰려면 이 네임스페이스를 사용합니다.

DirectoryEntry 클래스는 Active Directory 도메인 서비스 계층 구조의 노드나 개체를 캡슐화합니다. 개체에 바인딩하거나 속성을 읽거나 특성을 업데이트하려면 이 클래스를 사용합니다. DirectoryEntry를 도우미 클래스와 함께 사용하면 자식 노드 만들기, 삭제, 이름 바꾸기 및 이동이나 자식 열거를 비롯하여 수명 관리와 탐색 방법에 대한 지원이 제공됩니다.

Active Directory 도메인 서비스 계층 구조에 대한 쿼리를 수행하려면 DirectorySearcher 클래스를 사용합니다. LDAP는 시스템에서 제공하는 ADSI(Active Directory Service Interfaces) 공급자 중 유일하게 검색을 지원하는 공급자입니다.

DirectorySearcher를 통해 Active Directory 도메인 서비스 계층 구조를 검색하면 SearchResultCollection 클래스의 인스턴스에 들어 있는 SearchResult의 인스턴스가 반환됩니다.

클래스

---

	클래스	설명
	ActiveDirectoryAccessRule	ActiveDirectoryAccessRule 클래스는 Active Directory 도메인 서비스 개체의 DACL(임의 액세스 제어 목록)에서 ACE(액세스 제어 항목)를 나타내는 데 사용됩니다.
	ActiveDirectoryAuditRule	ActiveDirectoryAuditRule은 SACL(System Access Control List)에서 ACE(액세스 제어 항목)를 설정하는 데 사용됩니다. ActiveDirectoryAccessRule에는 IdentityReference 개체로 표시되는 트러스티가 포함되어 있으며 액세스 제어 형식과 액세스 마스크에 대한 정보와 상속 플래그와 같은 다른 속성에 대한 정보도 포함되어 있습니다. 이 규칙은 ActiveDirectorySecurity 개체에 설정됩니다. ActiveDirectorySecurity가 디렉터리 저장소에 커밋되면 ActiveDirectoryAuditRule에 설정된 규칙에 따라 보안 설명자 개체가 수정됩니다.
	ActiveDirectorySecurity	관리되는 ACL 라이브러리의 개체 보안 계층을 사용하여 디렉터리 개체의 액세스 제어 기능을 래핑합니다.
	CreateChildAccessRule	CreateChildAccessRule 클래스는 Active Directory 도메인 서비스 개체에 자식 개체를 만드는 권한을 허용하거나 거부하는 데 사용되는 특정 형식의 액세스 규칙을 나타냅니다.
	DeleteChildAccessRule	DeleteChildAccessRule 클래스는 Active Directory 도메인 서비스 개체에 자식 개체를 삭제할 권한을 허용하거나 거부하는 데 사용되는 특정 형식의 액세스 규칙을 나타냅니다.
	DeleteTreeAccessRule	DeleteTreeAccessRule 클래스는 자식 개체가 갖고 있는 권한에 관계없이 Active Directory 도메인 서비스 개체에 자식 개체를 모두 삭제할 권한을 허용하거나 거부하는 데 사용되는 특정 형식의 액세스 규칙을 나타냅니다.
	DirectoryEntries	DirectoryEntry 개체의 컬렉션을 포함합니다.
	DirectoryEntry	DirectoryEntry 클래스는 Active Directory 도메인 서비스 계층 구조의 노드나 개체를 캡슐화합니다.
	DirectoryEntryConfiguration	DirectoryEntryConfiguration 클래스를 사용하여 디렉터리 개체를 조작하기 위한 공급자별 옵션을 직접 지정하고 가져올 수 있습니다. 일반적으로 옵션은 내부 디렉터리 저장소의 검색 작업에 적용됩니다. 지원되는 옵션은 공급자마다 다릅니다.
	DirectorySearcher	Active Directory 도메인 서비스에 대한 쿼리를 수행합니다.
	DirectoryServicesCOMException	Invoke 메서드가 호출될 때 발생한 오류에 대한 확장 오류 정보를 포함합니다.
	DirectoryServicesPermission	DirectoryServicesPermission 클래스를 사용하면 System.DirectoryServices의 코드 액세스 보안 권한을 제어할 수 있습니다.
	DirectoryServicesPermissionAttribute	System.DirectoryServices 권한을 선언적으로 확인할 수 있습니다.
	DirectoryServicesPermissionEntry	DirectoryServicesPermissionEntry 클래스는 System.DirectoryServices에 대한 코드 액세스 보안 권한 집합의 최소 단위를 정의합니다.
	DirectoryServicesPermissionEntryCollection	강력한 형식의 DirectoryServicesPermissionEntry 컬렉션을 포함합니다.
	DirectorySynchronization	도메인 내의 디렉터리를 동기화하는 방법을 지정합니다.
	DirectoryVirtualListView	DirectoryVirtualListView 클래스는 가상 목록 보기 검색을 수행하는 방법을 지정합니다. 사용자는 가상 목록 보기 검색을 통해 주소록 스타일 가상 목록 보기로 검색 결과를 볼 수 있습니다. 가상 목록 보기는 매우 큰 결과 집합에 사용하도록 설계되었습니다. 검색 데이터는 정렬된 디렉터리 검색의 연속된 하위 집합으로 검색됩니다.
	DirectoryVirtualListViewContext	디렉터리 가상 목록 보기 응답을 만드는 방법을 지정합니다.
	DSDescriptionAttribute	.NET Framework 인프라를 지원하며 코드에서 직접 사용할 수 없습니다.
	ExtendedRightAccessRule	Active Directory 개체에 확장 권한을 허용하거나 거부하는 데 사용되는 특정 형식의 액세스 규칙을 나타냅니다. 확장 권한은 액세스 권한의 표준 집합에 포함되지 않는 특수 작업을 나타냅니다. 확장 권한의 예로 다른 사용자에게 전자 메일을 보낼 권한을 사용자에게 부여하는 Send-As가 있습니다. 가능한 확장 권한의 목록은 MSDN Library(http://msdn.microsoft.com/library/default.asp?url=/library/en-us/adschema/adschema/extended_rights.asp)에서 Extended Rights 항목을 참조하십시오. 확장 권한에 대한 자세한 내용은 MSDN Library에서 Control Access Rights 항목을 참조하십시오.
	ListChildrenAccessRule	ListChildrenAccessRule 클래스는 Active Directory 도메인 서비스 개체에 자식 개체를 나열할 권한을 허용하거나 거부하는 데 사용되는 특정 형식의 액세스 규칙을 나타냅니다.
	PropertyAccessRule	PropertyAccessRule 클래스는 Active Directory 도메인 서비스 속성에 대한 액세스 권한을 허용하거나 거부하는 데 사용되는 특정 형식의 액세스 규칙을 나타냅니다.
	PropertyCollection	PropertyCollection 클래스에는 DirectoryEntry의 속성이 포함됩니다.
	PropertySetAccessRule	PropertySetAccessRule 클래스는 Active Directory 도메인 서비스 속성 집합에 대한 액세스 권한을 허용하거나 거부하는 데 사용되는 특정 형식의 액세스 규칙을 나타냅니다. Active Directory 도메인 서비스에 대해 정의된 속성 집합의 목록은 MSDN Library(http://msdn.microsoft.com/library/default.asp?url=/library/en-us/adschema/adschema/property_sets.asp)에서 Property Sets 항목을 참조하십시오.
	PropertyValueCollection	DirectoryEntry 속성의 값이 포함되어 있습니다.
	ResultPropertyCollection	SearchResult 인스턴스의 속성이 포함되어 있습니다.
	ResultPropertyValueCollection	SearchResult 속성의 값이 포함되어 있습니다.
	SchemaNameCollection	DirectoryEntries 개체의 SchemaFilter 속성에 사용할 수 있는 스키마 이름 목록을 포함합니다.
	SearchResult	SearchResult 클래스는 Active Directory 도메인 서비스 계층 구조에서 DirectorySearcher를 통해 검색하는 동안 반환되는 노드를 캡슐화합니다.
	SearchResultCollection	SearchResultCollection 클래스에는 DirectorySearcher 쿼리 중에 Active Directory 계층 구조에서 반환한 SearchResult 인스턴스가 포함되어 있습니다.
	SortOption	검색 결과를 정렬하는 방법을 지정합니다.

열거형

---

	열거형	설명
	ActiveDirectoryRights	ActiveDirectoryRights 열거형은 Active Directory 도메인 서비스 개체에 할당된 액세스 권한을 지정합니다.
	ActiveDirectorySecurityInheritance	ActiveDirectorySecurityInheritance 열거형은 ACE 정보가 개체와 그 하위 항목에 적용되는지 여부와 적용되는 방법을 지정합니다.
	AuthenticationTypes	AuthenticationTypes 열거형은 System.DirectoryServices에 사용되는 인증 형식을 지정합니다. 이 열거형에는 멤버 값의 비트 조합을 허용하는 FlagsAttribute가 있습니다.
	DereferenceAlias	DereferenceAlias 열거형은 별칭이 확인되는 방법을 지정합니다. 이 열거형은 DirectorySearcher.DerefAlias 속성의 값을 제공합니다.
	DirectoryServicesPermissionAccess	DirectoryServicesPermissionAccess 열거형은 System.DirectoryServices 권한 클래스에서 사용하는 액세스 수준을 정의합니다. 이 열거형에는 멤버 값의 비트 조합을 허용하는 FlagsAttribute가 있습니다.
	DirectorySynchronizationOptions	도메인의 디렉터리가 동기화되는 방법을 결정하는 플래그를 포함합니다. DirectorySynchronization.Option 속성에 이러한 옵션을 설정할 수 있습니다.
	ExtendedDN	ExtendedDN 열거형은 확장된 고유 이름을 반환할 형식을 지정합니다. 이 열거형은 DirectorySearcher.ExtendedDN 속성에 사용됩니다.
	PasswordEncodingMethod	암호를 설정하거나 변경할 때 SSL이 사용되는지 여부를 지정합니다. 이 열거형은 DirectoryEntryConfiguration.PasswordEncoding 속성에 사용됩니다.
	PropertyAccess	PropertyAccess 열거형은 PropertyAccessRule 및 PropertySetAccessRule 클래스와 함께 사용되어 Active Directory 속성이나 속성 집합에 적용되는 액세스 형식을 나타냅니다.
	ReferralChasingOption	ReferralChasingOption 열거형은 조회 추적 여부와 방법을 지정합니다.
	SearchScope	DirectorySearcher 개체를 사용하여 수행되는 디렉터리 검색의 가능한 범위를 지정합니다.
	SecurityMasks	디렉터리 개체의 보안 정보를 검사하는 데 사용할 수 있는 옵션을 지정합니다. 이 열거형은 DirectorySearcher.SecurityMasks 및 DirectoryEntryConfiguration.SecurityMasks 속성에서 사용됩니다.
	SortDirection	SortDirection 열거형은 Active Directory 도메인 서비스 쿼리의 결과를 정렬하는 방법을 지정합니다.