Befehl "searchGroups"

Mit diesem Befehl können Sie nach Gruppen suchen.

Verwendungszweck

Verwenden Sie den Befehl searchGroups, um nach Gruppen in Virtual Member Manager zu suchen, die mit bestimmten Kriterien übereinstimmen. Sie können z. B. mit dem Befehl searchGroups nach allen Gruppen suchen, deren allgemeiner Name ("cn") mit "IBM" beginnt.

Wenn die Aktion erfolgreich war, gibt der Befehl searchGroups eine Liste der eindeutigen Namen aller Gruppen zurück, die mit den Suchkriterien übereinstimmen.

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

searchGroups { -cn allgemeiner_name –description beschreibung [-timeLimit zeitlimit] 
              [-countLimit countlimit] [-clearCache cachebereinigungsmodus] [-securityDomainName domänenname] }

Parameter

-cn allgemeiner_name
Gibt den allgemeinen für die Gruppe verwendeten Namen an. Dieser Parameter ist dem Merkmal "cn" in Virtual Member Manager zugeordnet.
-description beschreibung
Gibt Informationen zu der Gruppe an. Dieser Parameter ist der Beschreibungsentität in einem Virtual Member Manager-Objekt zugeordnet.
–timeLimit Zeitlimit
Gibt für die Suche eine Höchstdauer in Millisekunden an. Standardmäßig ist kein Zeitlimit festgelegt.
–countLimit Begrenzung
Gibt die maximale Anzahl an Suchergebnissen an, die die Suche zurückgeben soll. Standardmäßig werden alle während der Suche gefundenen Gruppen zurückgeben.
-clearCache cachebereinigungsmodus
Gibt an, ob der Repository-Adapter-Cache bereinigt werden soll, bevor die Suche nach Gruppen durchgeführt wird.
Der gültige Wert ist clearAll, mit dem alle zwischengespeicherten Informationen im Repository-Adapter gelöscht werden. Der Wert erfordert keine Beachtung der Groß-/Kleinschreibung. Es gibt keinen Standardwert für diesen Parameter. Wenn Sie keinen Wert oder einen anderen Wert als 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, d. h., die nachfolgende Operation ist zeitaufwändig.
-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, wenn Sie nach allen Gruppen suchen möchten, für die eine Beschreibung festgelegt wurde:
$AdminTask searchGroups {-description *}
Geben Sie den folgenden Befehl aus, wenn Sie nach allen Gruppen suchen möchten, bei denen "IBM" im allgemeinen Namen der Gruppe vorkommt:
$AdminTask searchGroups {-cn *IBM*}


Rechtliche Hinweise | Feedback