Mandato getGroup

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:

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}


Condiciones de uso | Comentarios