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