getMembershipOfUser command
Use this command to view a list of the groups that a user belongs to.
Purpose
Use the getMembershipOfUser command to view a list of the groups that a user belongs to.If successful, the getMembershipOfUser command returns a list of the unique names for the groups that the user is a member of.
Note: If the Use global security settings option
is selected for the user realm or the Global federated
repositories option is selected as the realm type for
the specified domain, this command is executed on the federated repository
of the admin domain. However, configuration changes that are performed
on the domain are applied to the security domain-specific configuration.
commands
Syntax
getMembershipOfUser { -uniqueName uniqueName [-clearCache clearCacheMode] [-securityDomainName domainName] }
Parameters
- -uniqueName uniqueName
- Specifies the unique name value for the user whose group memberships you want to view. This parameter maps to the uniqueName property in virtual member manager.
- -clearCache clearCacheMode
- Specifies whether the repository adapter cache should be cleared before retrieving the specified user information.
- Valid values are:
- clearEntity: Clears the cache for the specified user, if the user exists in the cache.
- clearAll: Clears the cached information for all of the entities in the adapter of the repository where the specified user exists.
- Avoid trouble: Frequent use of this parameter to clear the cache may result in performance degradation. When the cache is cleared, the subsequent operation has to get the details from the repository and update the cache with this newly retrieved data. The impact on performance is more pronounced if you use the clearAll mode, as this invalidates the entire cache, and the subsequent operation takes longer to complete.
- -securityDomainName domainName
- Specifies the name that uniquely identifies the security domain. If you do not specify this parameter, the command uses the global federated repository.
Sample
To view the groups that the user Dan Meyers is a member of, issue this command:$AdminTask getMembershipOfUser {-uniqueName uid=dmeyers,cn=users,dc=yourco,dc=com}