Principal.GetGroups 方法

定義

命名空間:

System.DirectoryServices.AccountManagement

組件:

System.DirectoryServices.AccountManagement.dll

套件:

System.DirectoryServices.AccountManagement v8.0.0

傳回群組物件的集合，指定目前的主體是哪些群組的成員。

多載

GetGroups()	傳回群組物件的集合，指定目前的主體是哪些群組的成員。
GetGroups(PrincipalContext)	傳回群組物件的集合，這些群組物件代表的群組不但是主體所屬的群組，而且存在於指定之內容參數所提供的存放區內。

備註

這個多載方法只會傳回主體直接為成員的群組;不會執行遞歸搜尋。 遞歸搜尋結果適用於用戶主體物件。 如需詳細資訊，請參閱 GetAuthorizationGroups 方法。

如果主體存放區是AD DS，群組清單會包含AD DS物件中主要群組標識元屬性所識別的使用者主要群組。

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 方法。

這個方法所傳回的群組可能包含來自不同範圍和存放區與主體的群組。 例如，如果主體是具有 DN 為 “CN=SpecialGroups，DC=Fabrikam，DC=com，DC=com 的 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 方法。

這個方法所傳回的群組可能包含來自不同範圍和存放區與主體的群組。 例如，如果主體是具有 DN 為 “CN=SpecialGroups，DC=Fabrikam，DC=com，DC=com 的 AD DS 物件，則傳回的集合可以包含屬於 ”CN=NormalGroups，DC=Fabrikam，DC=com 的群組。

如果目前的主體是 AD DS 主體，傳回的群組會包含主體主要群組，如 AD DS 物件上的主要群組標識符屬性所表示。

另請參閱

• GetGroups()