Utilice este mandato para buscar grupos.
Finalidad
Utilice el mandato
searchGroups
para buscar grupos en virtual member manager que coincidan con unos criterios
determinados.
Por ejemplo, puede utilizar el mandato
searchGroups
para buscar todos los grupos con un cn que empiece por IBM.
Si es satisfactorio, el
mandato searchGroups devuelve una lista de los nombres exclusivos de
todos los grupos que coinciden con los criterios de búsqueda.
Nota: Si se ha seleccionado la opción Usar valores de seguridad global
para la esfera de usuario o se ha seleccionado la opción Depósitos federados
globales como tipo de esfera para el dominio especificado, este mandato se
ejecuta en el depósito federado del dominio admin. Sin embargo, los cambios de
configuración realizados en el dominio se aplican a la configuración específica del
dominio de seguridad.
Sintaxis
searchGroups { -cn nombre_común –description descripción [-timeLimit límite_t]
[-countLimit límite_recuento] [-clearCache modalidad_borrar_caché] [-securityDomainName nombre_dominio] }
Parámetros
- -cn nombre_común
- Especifica el nombre común que se utiliza para el grupo. Este parámetro se correlaciona con la
propiedad cn en virtual member manager.
- -description descripción
- Especifica información acerca del grupo. Este parámetro se correlaciona
con la entidad de descripción en un objeto de virtual member manager.
- –timeLimit límite_t
- Especifica la cantidad de tiempo máxima en milisegundos que se puede ejecutar la
búsqueda. El valor predeterminado es sin limite de tiempo.
- –countLimit límite_numérico
- Especifica el número máximo de resultados que desea que se devuelvan de la búsqueda. De
forma predeterminada, se devuelven todos los grupos encontrados en la búsqueda.
- -clearCache modalidad_borrar_caché
- Especifica si se debe borrar la memoria caché del adaptador de depósito antes de realizar la operación de búsqueda para grupos.
- El valor válido es clearAll, que borra toda la información guardada en la memoria caché del adaptador de depósito. El valor no distingue entre mayúsculas y minúsculas. No hay ningún valor predeterminado para este parámetro.
Si no especifica un valor o si especifica un valor distinto a clearAll,
se muestra un mensaje de error.
Cómo evitar el problema: El uso frecuente de este parámetro para borrar la memoria caché puede disminuir el rendimiento.
Cuando se borra la memoria caché, la operación siguiente tendrá que obtener los detalles del depósito y actualizar la memoria caché con estos datos recién recuperados, de modo que la operación siguiente tardará más tiempo en completarse.
- -securityDomainName nombre_dominio
- Especifica el nombre que identifica exclusivamente el dominio de seguridad.
Si no especifica este parámetro, el mandato utiliza el repositorio federado global.
Ejemplo
Para buscar todos los grupos que tienen especificada una
descripción, emita el mandato siguiente:
$AdminTask searchGroups {-description *}
Para
buscar todos los grupos en cuyo nombre común de grupo aparece IBM, emita el mandato
siguiente:
$AdminTask searchGroups {-cn *IBM*}