GroupPrincipal.GetMembers 메서드

정의

네임스페이스:

System.DirectoryServices.AccountManagement

어셈블리:

System.DirectoryServices.AccountManagement.dll

패키지:

System.DirectoryServices.AccountManagement v8.0.0

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

오버로드

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

GetMembers()

Source:

Group.cs

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

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 집합에는 검색되는 컨텍스트의 일부가 아닌 scope 속하는 경우에도 "CN=NormalUsers,DC=Fabrikam,DC=com" 아래에 있는 그룹 멤버가 포함됩니다. 반환된 보안 주체 컬렉션에는 그룹과 다른 저장소에 있는 멤버도 포함될 수 있습니다.

GetMembers(Boolean)

Source:

Group.cs

그룹에 포함된 보안 주체 개체의 컬렉션을 반환합니다. 재귀 플래그를 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 연결합니다.

"DC=fabrikam,DC=com" 생성자에 지정된 PrincipalContext 컨테이너 아래에서 이름이 "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 집합에는 검색되는 컨텍스트의 일부가 아닌 scope 속하는 경우에도 "CN=NormalUsers,DC=Fabrikam,DC=com" 아래에 있는 그룹 멤버가 포함됩니다. 반환된 보안 주체 컬렉션에는 그룹과 다른 저장소에 있는 멤버도 포함될 수 있습니다.