GroupPrincipal.GetMembers メソッド

定義

名前空間:

System.DirectoryServices.AccountManagement

アセンブリ:

System.DirectoryServices.AccountManagement.dll

パッケージ:

System.DirectoryServices.AccountManagement v8.0.0

グループに格納されているプリンシパル オブジェクトのコレクションを返します。

オーバーロード

GetMembers()	グループに格納されているプリンシパル オブジェクトのコレクションを返します。
GetMembers(Boolean)	グループに格納されているプリンシパル オブジェクトのコレクションを返します。 再帰フラグが true に設定されている場合、このメソッドは現在のグループを再帰的に検索し、入れ子になったすべてのグループ メンバーを返します。

GetMembers()

ソース:

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 セットには、検索されるコンテキストの一部ではないスコープに属していても、"CN=NormalUsers,DC=Fabrikam,DC=com" の下にあるグループ メンバーも含まれます。 返されるプリンシパル コレクションには、グループとは異なるストアにあるメンバーを含めることもできます。

GetMembers(Boolean)

ソース:

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> オブジェクト。グループにメンバーがない場合は空のコレクション。

例

次のコードでは、LDAP ドメイン "fabrikam.com" に接続し、ユーザー名を "administrator" に設定し、パスワードをコンストラクターの "SecretPwd123" に PrincipalContext 設定します。

検索が実行され、コンストラクター "DC=fabrikam,DC=com" で指定されたコンテナーの下に "Domain Admins" という名前の PrincipalContext グループが検索されます。グループが見つかった場合、再帰メンバーを含む、このグループのメンバーであるすべてのプリンシパルが列挙されます

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" の下にあるグループ メンバーも含まれます。 返されるプリンシパル コレクションには、グループとは異なるストアにあるメンバーを含めることもできます。