Commande getUser

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 : 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}


Conditions d'utilisation | Commentaires