Cette commande permet de rechercher des groupes.
Objectif
A l'aide de la commande
searchGroups,
vous pouvez trouver des groupes dans virtual member manager qui répondent à
des critères particuliers.
Par exemple, la commande
searchGroups
permet de trouver tous les groupes avec un nom cn qui commence par IBM.
Si
l'opération aboutit, la commande
searchGroups
renvoie une liste des noms uniques de tous les groupes qui répondent aux
critères de recherche.
Remarque : Si l'option Utilisation des paramètres de sécurité
globaux est sélectionnée pour le domaine utilisateur ou que l'option
Référentiels fédérés globaux est sélectionnée comme type de domaine pour le domaine
spécifié, cette commande est exécutée sur le référentiel fédéré du domaine admin. Toutefois, les
modifications de configuration effectuées sur le domaine s'appliquent à la
configuration de sécurité spécifique au domaine.
Syntaxe
searchGroups { -cn nom_usuel –description description [-timeLimit limiteT]
[-countLimit limite_max] [-clearCache clearCacheMode] [-securityDomainName nomDomaine] }
Paramètres
- -cn nom_usuel
- Indique
le nom usuel du groupe. Ce paramètre établit une correspondance
avec la propriété cn de virtual member manager.
- -description description
- Indique les informations relatives au groupe. Ce paramètre établit une correspondance avec l'entité de description dans un
objet virtual member manager.
- –timeLimit limiteT
- Indique le temps maximal d'exécution de la recherche. Par défaut, aucune
limite n'est définie.
- –countLimit limite_max
- Indique le nombre maximal de résultats que vous souhaitez voir retournés par la
recherche. Par défaut, tous les groupes trouvés lors de la recherche sont
retournés.
- -clearCache clearCacheMode
- Indique si le cache de l'adaptateur de référentiel doit être
effacé avant l'exécution de l'opération de recherche des groupes.
- La valeur valide est clearAll. Cette
valeur efface toutes les informations mises en mémoire cache dans
l'adaptateur de référentiel. La distinction minuscules/majuscules n'est pas appliquée à la valeur. Il n'y a pas de valeur par défaut pour ce paramètre.
Si vous n'indiquez pas de valeur, ou si vous indiquez une valeur
autre que clearAll, un message d'erreur
s'affiche.
Eviter les incidents : Une utilisation fréquente
de ce paramètre pour effacer la mémoire cache risque d'entraîner une
dégradation des performances.
Lorsque la mémoire cache est effacée,
l'opération suivante doit obtenir les détails du référentiel et
mettre à jour la mémoire cache avec ces données nouvellement
extraites. Son exécution prend donc plus de temps.
- -securityDomainName nomDomaine
- Indique le nom qui identifie le domaine de sécurité de façon unique.
Si vous ne spécifiez pas ce paramètre, la commande utilise le référentiel fédéré global.
Exemple
Pour rechercher tous les groupes avec une description spécifique, exécutez la
commande suivante :
$AdminTask searchGroups {-description *}
Pour rechercher tous les groupes qui contiennent le mot IBM dans le nom
usuel de groupe, exécutez la commande suivante :
$AdminTask searchGroups {-cn *IBM*}