Mit diesem Befehl können Sie eine neue Gruppe erstellen.
Verwendungszweck
Mit dem Befehl
createGroup können Sie eine neue Gruppe im Standard-Repository erstellen.
Wenn die Aktion erfolgreich war, gibt der Befehl createGroup den eindeutigen Namen der Gruppe zurück.
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
createGroup { -cn cn [-description beschreibung] [-parent übergeordnetes_element]
[-memberUniqueName eindeutiger_mitgliedsname] [-securityDomainName domänenname] }
Parameter
- -cn allgemeiner_name
- Gibt den allgemeinen Namen für die Gruppe an, die Sie erstellen möchten.
Dieser Parameter ist dem Merkmal "cn" in Virtual Member Manager zugeordnet.
- -description beschreibung
- Gibt für die Gruppe, die Sie erstellen möchten, zusätzliche Informationen an. Dieser Parameter ist der Beschreibungsentität in einem Virtual Member Manager-Objekt zugeordnet.
- -parent übergeordnetes_element
- Gibt das Repository an, in welchem Sie die Gruppe erstellen möchten.
Dieser Parameter ist dem Merkmal "parent" in Virtual Member Manager zugeordnet.
- -memberUniqueName eindeutiger_mitgliedsname
- Gibt einen eindeutigen Namen als Wert für den Benutzer oder die Gruppe an, den/die Sie der neuen Gruppe hinzufügen möchten. Dieser Parameter ist dem Merkmal "uniqueName" in Virtual Member Manager zugeordnet.
- -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 eine Gruppe mit dem Namen "groupA" zu erstellen:
$AdminTask createGroup {-cn groupA}
Geben Sie den folgenden Befehl aus, um eine Gruppe mit dem Namen "groupA" zu erstellen und sie als eine Gruppe von Administratoren zu beschreiben:
$AdminTask createGroup {-cn groupA –description "eine Gruppe von Administratoren" }