Express (Distributed operating systems), v8.0 > Secure applications and their environment > Authenticate users > Select a registry or repository > Manage realms in a federated repository > Virtual member manager > Reference > Supported commands > User and group management commands


searchGroups command

Use this command to search for groups.


Purpose

Use the searchGroups command to find groups in virtual member manager that match particular criteria. For example, you can use the searchGroups command to find all groups with a cn that starts with IBM.

If successful, the searchGroups command returns a list of unique names of all groups that match the search criteria.

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 performed on the domain are applied to the security domain-specific configuration.


Syntax

searchGroups { -cn commonname –description description  [-timeLimit tlimit]
              [-countLimit countlimit] [-securityDomainName domainName] }


Parameters

-cn commonname

Common name used for the group. This parameter maps to the cn property in virtual member manager.

-description description

Specifies information about the group. This parameter maps to the description entity in a virtual member manager object.

–timeLimit tlimit

Maximum amount of time in milliseconds that the search can run. The default is no time limit.

–countLimit countlimit

Maximum number of results that you want returned from the search. By default, all groups found in the search are returned.

-securityDomainName domainName

Name that uniquely identifies the security domain. If not specified, uses the global federated repository.


Sample

To search for all groups that have a description specified, issue this command:
$AdminTask searchGroups {-description *}
To search for all groups that have IBM appearing in the common name of the group, issue this command:
$AdminTask searchGroups {-cn *IBM*}

Parent topic: User and group management commands
Command format



+

Search Tips   |   Advanced Search