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()

ソース:

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 メソッドを参照してください。

このメソッドによって返されるグループには、プリンシパルとは異なるスコープとストアのグループが含まれる場合があります。 たとえば、プリンシパルが "CN=SpecialGroups,DC=Fabrikam,DC=com" の DN を持つ AD DS オブジェクトである場合、返されるセットには"CN=NormalGroups,DC=Fabrikam,DC=com" に属するグループを含めることができます。

現在のプリンシパルが AD DS プリンシパルの場合、返されるグループには、AD DS オブジェクトの "primaryGroupId" 属性で示されているように、プリンシパルのプライマリ グループが含まれます。

こちらもご覧ください

• GetGroups()

GetGroups(PrincipalContext)

ソース:

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 メソッドを参照してください。

このメソッドによって返されるグループには、プリンシパルとは異なるスコープとストアのグループが含まれる場合があります。 たとえば、プリンシパルが "CN=SpecialGroups,DC=Fabrikam,DC=com" の DN を持つ AD DS オブジェクトである場合、返されるセットには"CN=NormalGroups,DC=Fabrikam,DC=com" に属するグループを含めることができます。

現在のプリンシパルが AD DS プリンシパルの場合、返されるグループには、AD DS オブジェクトのプライマリ グループ ID 属性によって示されるプリンシパルプライマリ グループが含まれます。

こちらもご覧ください

• GetGroups()