Verwenden Sie diesen Befehl, um Informationen über einen Benutzer anzuzeigen.
Verwendungszweck
Verwenden Sie den Befehl
getUser, um eine Liste anzuzeigen, die die folgenden Merkmale enthält:
- uniqueName
- cn
- sn
- uid
- mail
- principalName
Dies sind die einzigen Merkmale, die von diesem Befehl zurückgegeben werden, d. h. Sie können nicht ändern, welche Merkmale der Befehl zurückgibt.
Anmerkung: Nach der Anmeldung wird das erste Anmeldemerkmal als
Wert für
principalName zurückgegeben.
Falls die Option Globale Sicherheitseinstellungen
verwenden für den Benutzerrealm oder die Option
Globale zusammengefasste Repositorys als Realmtyp für die angegebene Domäne ausgewählt ist, wird dieser Befehl für das föderierte Repository der Verwaltungsdomäne ausgeführt.
Die für die Domäne vorgenommenen Konfigurationsänderungen werden jedoch auf die sicherheitsdomänenspezifische Konfiguration angewendet.
Syntax
getUser { -uniqueName eindeutiger_name [-clearCache cachebereinigungsmodus] [-securityDomainName domänenname] }
Parameter
- -uniqueName eindeutiger_name
- Gibt einen eindeutigen Namen als Wert für den Benutzer an, den Sie anzeigen möchten. Dieser Parameter ist dem Merkmal "uniqueName" in Virtual Member Manager zugeordnet.
- -clearCache cachebereinigungsmodus
- Gibt an, ob der Repository-Adapter-Cache bereinigt werden soll, bevor die angegebenen Benutzerinformationen abgerufen werden.
- Folgende Werte sind gültig:
- clearEntity: Löscht den Cache für den angegebenen Benutzer, falls der Benutzer im Cache vorhanden ist.
- clearAll: Löscht die zwischengespeicherten Informationen für alle Entitäten im Adapter des Repositorys, in dem der angegebene Benutzer vorhanden ist.
Die Werte erfordern keine Beachtung der Groß-/Kleinschreibung. Es gibt keinen Standardwert für diesen Parameter. Wenn Sie keinen Wert
oder einen anderen Wert als clearEntity oder clearAll angeben, erscheint eine Fehlernachricht.
Fehlervermeidung: Wenn Sie diesen Parameter häufig zur Cachebereinigung verwenden, kann dies Leistungseinbußen zur Folge haben.
Ist der Cache bereinigt, müssen bei der nachfolgenden Operation die Einzeldaten aus dem Repository abgerufen werden, und der Cache muss anhand dieser neu abgerufenen Daten aktualisiert werden. Bei Verwendung des Modus clearAll sind die Leistungseinbußen noch deutlicher, da in diesem Modus
der gesamte Cache inaktiviert wird und die nachfolgende Operation zeitaufwändig ist.
- -securityDomainName domänenname
- Gibt den Namen an, der die Sicherheitsdomäne eindeutig kennzeichnet.
Wenn Sie diesen Parameter nicht angeben, verwendet der Befehl das globale föderierte Repository.
Beispiel
Geben Sie den folgenden Befehl aus, um die Merkmale des Benutzers "Dan Meyer" abzurufen, dessen eindeutiger Name "uid=dmeyers,cn=users,dc=yourco,dc=com" ist:
$AdminTask getUser {-uniqueName uid=dmeyers,cn=users,dc=yourco,dc=com}