DirectorySearcher.SearchRoot 속성
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
Active Directory 도메인 서비스 계층 구조에서 검색이 시작되는 노드를 나타내는 값을 가져오거나 설정합니다.
public:
property System::DirectoryServices::DirectoryEntry ^ SearchRoot { System::DirectoryServices::DirectoryEntry ^ get(); void set(System::DirectoryServices::DirectoryEntry ^ value); };
public System.DirectoryServices.DirectoryEntry SearchRoot { get; set; }
public System.DirectoryServices.DirectoryEntry? SearchRoot { get; set; }
[System.DirectoryServices.DSDescription("DSSearchRoot")]
public System.DirectoryServices.DirectoryEntry SearchRoot { get; set; }
member this.SearchRoot : System.DirectoryServices.DirectoryEntry with get, set
[<System.DirectoryServices.DSDescription("DSSearchRoot")>]
member this.SearchRoot : System.DirectoryServices.DirectoryEntry with get, set
Public Property SearchRoot As DirectoryEntry
속성 값
Active Directory 도메인 서비스 계층 구조에서 검색이 시작되는 DirectoryEntry 개체입니다. 기본값은 null 참조(Visual Basic의 경우 Nothing
)입니다.
- 특성
설명
가 null 참조(Nothing
Visual Basic의 경우)인 경우 SearchRoot 검색 루트는 서버에서 현재 사용 중인 도메인의 루트로 설정됩니다.
글로벌 카탈로그에서 검색하는 방법에는 여러 가지가 있습니다.
전역 카탈로그를 열거하고 첫 번째 자식 을 선택합니다.
서버 이름을 지정합니다. DsGetDcName 함수를 사용하여 글로벌 카탈로그를 찾습니다. DsGetDcName 함수에 대한 자세한 내용은 DsGetDcName을 참조하세요.
글로벌 카탈로그의 RootDSE를 가져와서 "rootNamingContext"를 요청합니다.
LDAP를 사용하는 것처럼 검색 경로를 지정하여 글로벌 카탈로그를 사용합니다. 예를 들어 "GC://OU=..., DC=..., DC=..."입니다.
다음 C# 코드는 전역 카탈로그를 열거하고 첫 번째 자식 을 선택하는 방법을 보여 있습니다.
DirectoryEntry entry = new DirectoryEntry("GC://forestname"); IEnumerator ie = entry.Children.GetEnumerator(); ie.MoveNext(); entry = (DirectoryEntry)ie.Current; DirectorySearcher search = new DirectorySearcher(entry);
적용 대상
.NET