GroupPrincipal.GetMembers 메서드

  • 참조

정의

네임스페이스:
System.DirectoryServices.AccountManagement
어셈블리:
System.DirectoryServices.AccountManagement.dll

그룹에 포함된 보안 주체 개체의 컬렉션을 반환합니다.

오버로드

GetMembers()

그룹에 포함된 보안 주체 개체의 컬렉션을 반환합니다.
GetMembers(Boolean)

그룹에 포함된 보안 주체 개체의 컬렉션을 반환합니다. 재귀 플래그를 true로 설정하면 이 메서드는 현재 그룹을 재귀적으로 검색하고 중첩 그룹 멤버를 모두 반환합니다.

GetMembers()

그룹에 포함된 보안 주체 개체의 컬렉션을 반환합니다.

public:
 System::DirectoryServices::AccountManagement::PrincipalSearchResult<System::DirectoryServices::AccountManagement::Principal ^> ^ GetMembers();
public System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal> GetMembers ();
member this.GetMembers : unit -> System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal>
Public Function GetMembers () As PrincipalSearchResult(Of Principal)

반환

PrincipalSearchResult<Principal>

그룹의 멤버인 보안 주체 개체를 포함하거나 그룹에 멤버가 없는 경우 빈 컬렉션을 포함하는 PrincipalSearchResult<T> 개체입니다.

설명

이 메서드는 현재 그룹을 재귀적으로 검색 하지 않습니다. 따라서 그룹 개체는 주 개체 컬렉션에서 반환 될 수 있습니다.

컨텍스트를 고려 하지 않고 멤버가 반환 됩니다. 예를 들어 "CN = SpecialUsers, DC = Fabrikam, DC = com"을 기반으로 하는 AD DS 컨텍스트는 검색 되는 컨텍스트의 일부가 아닌 범위에 속하는 경우에도 PrincipalFindResult 집합에 "CN = NormalUsers, DC = Fabrikam, DC = com" 아래에 있는 그룹 멤버가 포함 됩니다. 반환 된 보안 주체 컬렉션에는 그룹과 다른 저장소에 있는 멤버가 포함 될 수도 있습니다.

적용 대상

GetMembers(Boolean)

그룹에 포함된 보안 주체 개체의 컬렉션을 반환합니다. 재귀 플래그를 true로 설정하면 이 메서드는 현재 그룹을 재귀적으로 검색하고 중첩 그룹 멤버를 모두 반환합니다.

public:
 System::DirectoryServices::AccountManagement::PrincipalSearchResult<System::DirectoryServices::AccountManagement::Principal ^> ^ GetMembers(bool recursive);
public System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal> GetMembers (bool recursive);
member this.GetMembers : bool -> System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal>
Public Function GetMembers (recursive As Boolean) As PrincipalSearchResult(Of Principal)

매개 변수

recursive
Boolean

그룹을 재귀적으로 검색하는지 여부를 지정하는 부울 값입니다.

반환

PrincipalSearchResult<Principal>

그룹의 멤버인 보안 주체 개체를 포함하거나 그룹에 멤버가 없는 경우 빈 컬렉션을 포함하는 PrincipalSearchResult<T> 개체입니다.

예제

다음 코드는 사용자 이름을 "administrator"로 설정 하 고 암호를 생성자의 "SecretPwd123"로 설정 하 여 LDAP 도메인 "fabrikam.com"에 연결 합니다 PrincipalContext .

PrincipalContext"DC = fabrikam, dc = com" 생성자에 지정 된 컨테이너 아래에 이름이 "Domain Admins" 인 그룹을 찾기 위해 검색이 수행 됩니다. 그룹이 있는 경우 재귀 멤버를 포함 하는이 그룹의 멤버인 모든 보안 주체가 열거 됩니다.

PrincipalContext ctx = new PrincipalContext(ContextType.Domain,                                                                      
                                            "fabrikam.com",   
                                            "DC=fabrikam,DC=com",   
                                            "administrator",   
                                            "SecretPwd123");  

GroupPrincipal grp = GroupPrincipal.FindByIdentity(ctx,   
                                                   IdentityType.Name,   
                                                   "Domain Admins");  

if (grp != null)  
{  
    foreach (Principal p in grp.GetMembers(true))  
    {  
         Console.WriteLine(p.Name);  
    }  
    grp.Dispose();  
}  

ctx.Dispose();

설명

재귀 플래그가로 설정 된 경우 반환 된 보안 주체 컬렉션에 그룹 개체가 포함 되지 않습니다. true 리프 노드만 반환 됩니다. 예를 들어 컴퓨터 개체 및 그룹 개체를 포함 하는 그룹 (사용자 보안 주체만 포함)을 재귀적으로 검색 하는 경우 반환 된 컬렉션에는 컴퓨터 개체와 중첩 된 그룹의 사용자 보안 주체 개체가 포함 됩니다. 그룹 개체는 비어 있는 경우에도 리프가 아니기 때문에 재귀 검색에서 반환 되지 않습니다. 재귀 플래그가로 설정 되 면 false 반환 된 컬렉션에 그룹 개체가 포함 될 수 있습니다.

컨텍스트를 고려 하지 않고 멤버가 반환 됩니다. 예를 들어 "CN = SpecialUsers, DC = Fabrikam, DC = com"을 기반으로 하는 AD DS 컨텍스트는 검색 되는 컨텍스트의 일부가 아닌 범위에 속하는 경우에도 PrincipalFindResult 집합에 "CN = NormalUsers, DC = Fabrikam, DC = com" 아래에 있는 그룹 멤버가 포함 됩니다. 반환 된 보안 주체 컬렉션에는 그룹과 다른 저장소에 있는 멤버가 포함 될 수도 있습니다.

적용 대상