Befehl "getMembersOfGroup"

Mit diesem Befehl können Sie eine Liste der Mitglieder einer Gruppe anzeigen.

Verwendungszweck

Mit dem Befehl getMembersOfGroup können Sie eine Liste der Mitglieder einer Gruppe anzeigen.
Wenn die Aktion erfolgreich war, gibt der Befehl getMembersOfGroup den Typ und den zugehörigen eindeutigen Namen der einzelnen Mitglieder an. Beispiel
  • PersonAccount, uid=dmeyer,cn=users,dc=yourco,dc=com
  • Group, cn=groupA,cn=groups,dc=yourco,dc=com
Anmerkung: 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

getMembersOfGroup { -uniqueName eindeutiger_name [-clearCache cachebereinigungsmodus] [-securityDomainName domänenname] } 

Parameter

-uniqueName eindeutiger_name
Gibt einen eindeutigen Namen als Wert für die Gruppe an, deren Mitglieder 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 Gruppeninformationen abgerufen werden.
Folgende Werte sind gültig:
  • clearEntity: Löscht den Cache für die angegebene Gruppe, falls die Gruppe im Cache vorhanden ist.
  • clearAll: Löscht die zwischengespeicherten Informationen für alle Entitäten im Adapter des Repositorys, in dem die angegebene Gruppe 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

Führen Sie den folgenden Befehl aus, um alle Mitglieder der Gruppe "Operators" anzuzeigen:
$AdminTask getMembersOfGroup {-uniqueName cn=operators,cn=users,dc=yourco,dc=com}


Rechtliche Hinweise | Feedback