Utilice este mandato para ver información sobre un usuario.
Finalidad
Utilice el mandato
getUser para ver
una lista que contenga las propiedades:
- uniqueName
- cn
- sn
- uid
- mail
- principalName
Son las únicas propiedades que devuelve este mandato; es
decir, no se pueden modificar las propiedades que el mandato devuelve.
Nota: Una vez
iniciada la sesión, la primera propiedad de inicio de sesión se devuelve como el valor de
principalName.
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
getUser { -uniqueName nombre_exclusivo [-clearCache modalidad_borrar_caché] [-securityDomainName nombre_dominio] }
Parámetros
- -uniqueName nombre_exclusivo
- Especifica el valor de nombre exclusivo del usuario 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 usuario especificada.
- Los valores válidos son:
- clearEntity: borra la memoria caché para el usuario especificado, si el usuario 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 usuario 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 las propiedades del usuario Dan Meyer, cuyo
uniqueName es uid=dmeyers,cn=users,dc=yourco,dc=com, emita este mandato:
$AdminTask getUser {-uniqueName uid=dmeyers,cn=users,dc=yourco,dc=com}