Utilice este mandato para ver información sobre un grupo.
Finalidad
Utilice el mandato
getGroup
para ver una correlación que contiene las siguientes propiedades de un grupo:
- cn
- description
- uniqueName
Son las únicas propiedades que devuelve este mandato; es
decir, no se pueden modificar las propiedades que el mandato devuelve.
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
getGroup { -uniqueName nombre_exclusivo [-clearCache modalidad_borrar_caché] [-securityDomainName nombre_dominio] }
Parámetros
- -uniqueName nombre_exclusivo
- Especifica el valor de nombre exclusivo del grupo que desea ver. Este
parámetro correlaciona la propiedad uniqueName en virtual member manager.
- -clearCache modalidad_borrar_caché
- Especifica si se debe borrar la memoria caché del adaptador de repositorio antes de recuperar la información de grupo especificada.
- Los valores válidos son:
- clearEntity: borra la memoria caché para el grupo especificado, si el grupo existe en la memoria caché.
- clearAll: borra la información almacenada en la memoria caché para todas las entidades del adaptador del depósito
donde existe el grupo especificado.
Los valores no son sensibles a las 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 clearEntity o 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 repositorio y actualizar la memoria caché con estos datos recién recuperados. El impacto en el rendimiento es más notorio si se utiliza la modalidad clearAll, ya que invalida toda la memoria caché y la operación siguiente tarda 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 recuperar la información de cn y descripción
sobre el grupo que se denomina operators, emita este mandato:
$AdminTask getGroup {-uniqueName cn=operators,cn=groups,dc=yourco,dc=com}