Cette commande permet de visualiser les informations relatives à un utilisateur.
Objectif
A l'aide de la commande
getUser,
vous pouvez visualiser la liste qui contient les propriétés :
- uniqueName
- cn
- sn
- uid
- mail
- principalName
Il s'agit des seules propriétés que peut retourner cette commande ; vous ne
pouvez en aucun cas modifier les propriétés retournées par la commande.
Remarque : Après la
connexion, la première propriété de connexion est renvoyée comme valeur du paramètre
principalName.
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
getUser { -uniqueName nomUnique [-clearCache clearCacheMode] [-securityDomainName nomDomaine] }
Paramètres
- -uniqueName nomUnique
- Indique la valeur de nom unique pour l'utilisateur à afficher. Ce paramètre établit une correspondance avec la propriété
uniqueName de virtual member manager.
- -clearCache clearCacheMode
- Indique si le cache de l'adaptateur de référentiel doit être
effacé avant l'extraction des informations de l'utilisateur précisé.
- Les valeurs admises sont :
- clearEntity : efface le cache de
l'utilisateur indiqué si ce dernier existe dans le cache.
- clearAll : efface les informations mises en cache pour toutes les entités dans l'adaptateur du référentiel dans lequel se trouve l'utilisateur spécifié.
Les valeurs ne doivent pas respecter la distinction
majuscules-minuscules. 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 clearEntity ou
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. L'impact sur les performances est plus important si vous
utilisez le mode clearAll, car cela invalide
la totalité du cache et l'exécution de l'opération suivante prend
plus de temps.
- -securityDomainName nomDomaine
- Indique le nom qui identifie le domaine de sécurité de façon unique.
Si vous n'indiquez pas ce paramètre, la commande utilise le
référentiel fédéré global.
Exemple
Pour extraire les propriétés d'un utilisateur Dan Meyer, dont le nom
unique est uid=dmeyers,cn=users,dc=yourco,dc=com, exécutez la commande suivante :
$AdminTask getUser {-uniqueName uid=dmeyers,cn=users,dc=yourco,dc=com}