Principal.GetGroups 메서드

정의

네임스페이스:

System.DirectoryServices.AccountManagement

어셈블리:

System.DirectoryServices.AccountManagement.dll

패키지:

System.DirectoryServices.AccountManagement v8.0.0

현재 보안 주체가 멤버인 그룹을 지정하는 그룹 개체의 컬렉션을 반환합니다.

오버로드

GetGroups()	현재 보안 주체가 멤버인 그룹을 지정하는 그룹 개체의 컬렉션을 반환합니다.
GetGroups(PrincipalContext)	보안 주체가 멤버이고 지정된 컨텍스트 매개 변수에서 지정하는 저장소에 있는 그룹 개체의 컬렉션을 반환합니다.

설명

이 오버로드된 메서드는 보안 주체가 직접 멤버인 그룹만 반환합니다. 재귀 검색이 수행되지 않습니다. 재귀 검색 결과는 사용자 주체 개체에 사용할 수 있습니다. 자세한 내용은 GetAuthorizationGroups 메서드를 참조하세요.

주 저장소가 AD DS인 경우 그룹 목록에는 AD DS 개체의 기본 그룹 ID 특성으로 식별되는 사용자의 기본 그룹이 포함됩니다.

GetGroups()

Source:

Principal.cs

현재 보안 주체가 멤버인 그룹을 지정하는 그룹 개체의 컬렉션을 반환합니다.

public:
 System::DirectoryServices::AccountManagement::PrincipalSearchResult<System::DirectoryServices::AccountManagement::Principal ^> ^ GetGroups();

public System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal> GetGroups ();

member this.GetGroups : unit -> System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal>

Public Function GetGroups () As PrincipalSearchResult(Of Principal)

반환

PrincipalSearchResult<Principal>

현재 보안 주체가 멤버인 그룹을 지정하는 GroupPrincipal 개체의 컬렉션입니다.

설명

이 메서드는 보안 주체가 직접 멤버인 그룹만 반환합니다. 재귀 검색이 수행되지 않습니다. 재귀 검색 결과는 사용자 주체 개체에 사용할 수 있습니다. 자세한 내용은 GetAuthorizationGroups 메서드를 참조하세요.

이 메서드에서 반환되는 그룹에는 보안 주체가 아닌 다른 scope 및 저장소의 그룹이 포함될 수 있습니다. 예를 들어 보안 주체가 DN이 "CN=SpecialGroups,DC=Fabrikam,DC=com"인 AD DS 개체인 경우 반환된 집합에는 "CN=NormalGroups,DC=Fabrikam,DC=com"에 속한 그룹이 포함될 수 있습니다.

현재 보안 주체가 AD DS 보안 주체인 경우 반환된 그룹에는 AD DS 개체의 "primaryGroupId" 특성에 표시된 대로 보안 주 그룹이 포함됩니다.

추가 정보

• GetGroups()

GetGroups(PrincipalContext)

Source:

Principal.cs

보안 주체가 멤버이고 지정된 컨텍스트 매개 변수에서 지정하는 저장소에 있는 그룹 개체의 컬렉션을 반환합니다.

public:
 System::DirectoryServices::AccountManagement::PrincipalSearchResult<System::DirectoryServices::AccountManagement::Principal ^> ^ GetGroups(System::DirectoryServices::AccountManagement::PrincipalContext ^ contextToQuery);

public System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal> GetGroups (System.DirectoryServices.AccountManagement.PrincipalContext contextToQuery);

member this.GetGroups : System.DirectoryServices.AccountManagement.PrincipalContext -> System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal>

Public Function GetGroups (contextToQuery As PrincipalContext) As PrincipalSearchResult(Of Principal)

매개 변수

contextToQuery

PrincipalContext

쿼리를 수행할 컨텍스트를 지정하는 PrincipalContext 개체입니다.

컨텍스트가 다른 도메인에 있는 경우 지정된 컨텍스트에서 보안 주체의 표현을 쿼리합니다.

반환

PrincipalSearchResult<Principal>

현재 보안 주체가 멤버인 그룹을 지정하는 GroupPrincipal 개체의 컬렉션입니다.

설명

이 메서드는 보안 주체가 직접 멤버인 그룹만 반환합니다. 재귀 검색이 수행되지 않습니다. 재귀 검색 결과는 사용자 주체 개체에 사용할 수 있습니다. 자세한 내용은 GetAuthorizationGroups 메서드를 참조하세요.

이 메서드에서 반환되는 그룹에는 보안 주체가 아닌 다른 scope 및 저장소의 그룹이 포함될 수 있습니다. 예를 들어 보안 주체가 DN이 "CN=SpecialGroups,DC=Fabrikam,DC=com"인 AD DS 개체인 경우 반환된 집합에는 "CN=NormalGroups,DC=Fabrikam,DC=com"에 속한 그룹이 포함될 수 있습니다.

현재 보안 주체가 AD DS 보안 주체인 경우 반환된 그룹에는 AD DS 개체의 기본 그룹 ID 특성으로 표시된 보안 주 그룹이 포함됩니다.

추가 정보

• GetGroups()