Befehl "getUser"

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


Rechtliche Hinweise | Feedback