uip-Administratorbenutzer

Syntax und Optionen für „UIP Admin Users“ und „UIP Admin Groups“, die Identity Server-Verzeichnisbenutzer, -Gruppen und -Gruppenmitgliedschaften verwalten.

uip admin users und uip admin groups verwalten lokale Identity Server-Benutzer und -Gruppen innerhalb der Partition Ihrer Organisation – die Identitäten auf Verzeichnisebene hinter der Anmeldung und nicht die Rollenzuweisungen auf Orchestrator-Ebene. Hier befinden sich zwei unabhängige Befehlsgruppen: users (Verzeichnisbenutzer erstellen/lesen/aktualisieren/löschen/einladen) und groups (Gruppen erstellen/lesen/aktualisieren/löschen sowie Mitgliedschaftsverwaltung).

--organization wird für die meisten Verben in beiden Gruppen akzeptiert, ist aber veraltet und ignoriert – die Organisation wird immer von Ihrem aktuellen Anmeldekontext abgeleitet. Wenn sie übergeben wird, wird eine Warnung ausgegeben (--organization is deprecated and ignored; organization is derived from login context), aber das hat keine Auswirkungen.

Zusammenfassung

uip admin users list [--search <term>] [--sort-by <field>] [--sort-order asc|desc] [--limit <n>] [--offset <n>]
uip admin users get <user-id>
uip admin users create <username> --email <email> [--name <name>] [--surname <surname>]
uip admin users update <user-id> [--email <email>] [--name <name>] [--surname <surname>]
uip admin users delete <user-id>
uip admin users invite --email <emails> [--name <name>] [--surname <surname>]

uip admin groups list
uip admin groups get <group-id>
uip admin groups create <name>
uip admin groups update <group-id> --name <name>
uip admin groups delete <group-id>
uip admin groups members list <group-id> [--limit <n>] [--offset <n>]
uip admin groups members add <group-id> --user-ids <ids>
uip admin groups members revoke <group-id> --user-ids <ids>

Verben

„Gruppieren“ (Group)	Verb	Zweck
users	list	Listen Sie Benutzer in der Partition auf (durchsuchbar, sortierbar, paginiert).
users	get	Rufen Sie die vollständigen Details eines Benutzers nach ID ab.
users	create	Neuen lokalen Benutzer erstellen
users	update	Aktualisieren Sie die E-Mail-Adresse, den Vor- oder Nachnamen eines Benutzers.
users	delete	Löschen Sie einen Benutzer nach ID.
users	invite	Laden Sie einen oder mehrere Benutzer per E-Mail ein.
groups	list	Alle Gruppen in der Partition auflisten.
groups	get	Rufen Sie die Details einer Gruppe nach ID ab.
groups	create	Neue lokale Gruppe erstellen.
groups	update	Eine Gruppe umbenennen.
groups	delete	Löschen Sie eine Gruppe nach ID.
groups members	list	Listen Sie die Mitglieder einer Gruppe auf.
groups members	add	Fügen Sie einen oder mehrere Benutzer zu einer Gruppe hinzu.
groups members	revoke	Entfernen Sie einen oder mehrere Benutzer aus einer Gruppe.

UIP-Administratorbenutzerliste

Listen Sie Benutzer in der Partition auf. Gibt Benutzer-ID, Benutzername, E-Mail-Adresse, Name und Erstellungszeit zurück.

Optionen

Long	Short	Wert	Standard	Beschreibung
--search <term>	-s	string	–	Suchen Sie Benutzer anhand des Namens oder der E-Mail-Adresse.
--sort-by <field>		string	–	Sortierfeld, z. B UserName, Email).
--sort-order <direction>		asc|desc	asc	Sortierrichtung.
--limit <number>	-l	Integer	50 (DEFAULT_PAGE_SIZE)	Anzahl der zurückzugebenden Elemente.
--offset <number>		Integer	0	Anzahl der zu überspringenden Elemente.
--login-validity <minutes>		Integer	–	Überschreiben Sie die Tokenvalidität für diesen Anruf.

Beispiel

uip admin users list --limit 5

Datenform (--output json)

{
  "Code": "UserList",
  "Data": [
    {
      "id": "a1b2c3d4-0000-0000-0000-000000000001",
      "userName": "[e-mail]",
      "email": "[e-mail]",
      "name": "Admin",
      "surname": "User",
      "displayName": "Admin User",
      "creationTime": "2026-01-15T10:00:00.000Z"
    }
  ]
}

UIP-Administratorbenutzer erhalten

Rufen Sie Benutzerdetails nach ID ab.

Argumente

Name	Erforderlich	Zweck
<user-id>	ja	Benutzer-ID (UUID). Finden Sie es mit users list.

Beispiel

uip admin users get a1b2c3d4-0000-0000-0000-000000000001

Datenform (--output json)

{
  "Code": "UserDetails",
  "Data": {
    "id": "a1b2c3d4-0000-0000-0000-000000000001",
    "userName": "[e-mail]",
    "email": "[e-mail]",
    "name": "Admin",
    "surname": "User",
    "displayName": "Admin User",
    "creationTime": "2026-01-15T10:00:00.000Z"
  }
}

UIP-Administratorbenutzer erstellen

Neuen lokalen Benutzer erstellen

Argumente

Name	Erforderlich	Zweck
<username>	ja	Benutzername für den neuen Benutzer.

Optionen

Long	Short	Wert	Erforderlich	Beschreibung
--email <email>	-e	E-Mail	ja	dieselbe E-Mail-Adresse erhält.
--name <name>	-n	string	nein	Vorname.
--surname <surname>		string	nein	Nachname.

Beispiel

uip admin users create newuser --email "[e-mail]" --name "John" --surname "Doe"

Datenform (--output json)

{ "Code": "UserCreated", "Data": { "Succeeded": true } }

Aktualisierung der UIP-Administratorbenutzer

Aktualisieren Sie die E-Mail-Adresse, den Vor- oder Nachnamen eines vorhandenen Benutzers. Mindestens ein Feld ist erforderlich – der Aufruf mit keinem Feld schlägt auf der Clientseite ("No fields to update") vor einem Netzwerkaufruf fehl.

Argumente

Name	Erforderlich	Zweck
<user-id>	ja	Benutzer-ID (UUID).

Optionen

Long	Short	Wert	Beschreibung
--email <email>	-e	E-Mail	Neue E-Mail-Adresse.
--name <name>	-n	string	Neuer Vorname.
--surname <surname>		string	Neuer Nachname.

Beispiel

uip admin users update a1b2c3d4-0000-0000-0000-000000000001 --name "Jane" --surname "Doe" --email "[e-mail]"

Datenform (--output json)

{ "Code": "UserUpdated" }

UIP-Administratorbenutzer löschen

Löschen Sie einen Benutzer nach ID.

Argumente

Name	Erforderlich	Zweck
<user-id>	ja	Benutzer-ID (UUID).

Beispiel

uip admin users delete a1b2c3d4-0000-0000-0000-000000000001

Datenform (--output json)

{ "Code": "UserDeleted", "Data": { "Id": "a1b2c3d4-0000-0000-0000-000000000001", "Status": "Deleted successfully" } }

UIP-Administratorbenutzer einladen

Laden Sie einen oder mehrere Benutzer per E-Mail ein. Sendet eine Einladung zum Beitritt zur Organisation.

Optionen

Long	Short	Wert	Erforderlich	Beschreibung
--email <emails>	-e	durch Kommas getrennt sind	ja	Eine oder mehrere E-Mail-Adressen, die eingeladen werden sollen.
--name <name>	-n	string	nein	Vorname, der auf jeden eingeladenen Benutzer angewendet wird.
--surname <surname>		string	nein	Nachname wird auf jeden eingeladenen Benutzer angewendet.

Beispiel

uip admin users invite --email "[e-mail]"

Datenform (--output json)

{ "Code": "UsersInvited", "Data": { "succeeded": true } }

UIP-Administratorgruppenliste

Alle Gruppen in der Partition auflisten. Gibt Gruppen-ID, Namen, Typ und Erstellungszeit zurück. Keine Filter-/Paginierungsoptionen – gibt alles in einem Aufruf zurück.

Beispiel

uip admin groups list

Datenform (--output json)

{
  "Code": "GroupList",
  "Data": [
    { "id": "a1b2c3d4-0000-0000-0000-000000000001", "name": "Administrators", "displayName": "Administrators", "type": "BuiltIn", "creationTime": "2026-01-15T10:00:00.000Z" }
  ]
}

UIP-Administratorgruppen abrufen

Rufen Sie Gruppendetails nach ID ab.

Argumente

Name	Erforderlich	Zweck
<group-id>	ja	Gruppen-ID (UUID). Finden Sie es mit groups list.

Beispiel

uip admin groups get a1b2c3d4-0000-0000-0000-000000000001

Datenform (--output json)

{ "Code": "GroupDetails", "Data": { "id": "a1b2c3d4-0000-0000-0000-000000000001", "name": "Administrators", "displayName": "Administrators", "type": "BuiltIn", "creationTime": "2026-01-15T10:00:00.000Z" } }

UIP-Administratorgruppen erstellen

Neue lokale Gruppe erstellen.

Argumente

Name	Erforderlich	Zweck
<name>	ja	Gruppenname.

Beispiel

uip admin groups create "DevOps Team"

Datenform (--output json)

{ "Code": "GroupCreated", "Data": { "id": "a1b2c3d4-0000-0000-0000-000000000002", "name": "DevOps Team", "displayName": "DevOps Team", "type": "Custom" } }

Der Befehl generiert eine clientseitige UUID für den id der Gruppe, bevor er die API aufruft – der Server weist die Gruppenerstellung mit einem 409er Fehler zurück, wenn keine ID angegeben wird.

Aktualisierung der UIP-Administratorgruppen

Eine Gruppe umbenennen. --name ist das einzige aktualisierte Feld und ist erforderlich – das Entfernen schlägt auf Clientseite fehl ("No fields to update").

Argumente

Name	Erforderlich	Zweck
<group-id>	ja	Gruppen-ID (UUID).

Optionen

Long	Short	Wert	Erforderlich	Beschreibung
--name <name>	-n	string	ja	Neuer Gruppenname.

Beispiel

uip admin groups update a1b2c3d4-0000-0000-0000-000000000001 --name "Renamed Group"

Datenform (--output json)

{ "Code": "GroupUpdated" }

UIP-Administratorgruppen löschen

Löschen Sie eine Gruppe nach ID.

Argumente

Name	Erforderlich	Zweck
<group-id>	ja	Gruppen-ID (UUID).

Beispiel

uip admin groups delete a1b2c3d4-0000-0000-0000-000000000002

Datenform (--output json)

{ "Code": "GroupDeleted", "Data": { "Id": "a1b2c3d4-0000-0000-0000-000000000002", "Status": "Deleted successfully" } }

Liste der Mitglieder der UIP-Administratorgruppe

Listen Sie die Mitglieder einer Gruppe auf.

Argumente

Name	Erforderlich	Zweck
<group-id>	ja	Gruppen-ID (UUID).

Optionen

Long	Short	Wert	Standard	Beschreibung
--limit <number>	-l	Integer	50	Anzahl der zurückzugebenden Elemente.
--offset <number>		Integer	0	Anzahl der zu überspringenden Elemente.

Beispiel

uip admin groups members list a1b2c3d4-0000-0000-0000-000000000001

Datenform (--output json)

{ "Code": "GroupMembers", "Data": [] }

UIP-Administratorgruppen Mitglieder hinzufügen

Fügen Sie einen oder mehrere Benutzer zu einer Gruppe hinzu.

Hinweis:

Implementiert als Read-Modify-Write: Der Befehl ruft den aktuellen Namen der Gruppe ab und ruft dann die Gruppenaktualisierungs-API mit directoryUserIDsToAdd auf – der gleiche zugrunde liegende Vorgang wie groups update, nur mit einem anderen Nutzlastfeld. Es gibt kein dediziertes „Mitglied hinzufügen“ API-Aufruf.

Argumente

Name	Erforderlich	Zweck
<group-id>	ja	Gruppen-ID (UUID).

Optionen

Long	Wert	Erforderlich	Beschreibung
--user-ids <ids>	durch Kommas getrennt sind	ja	Hinzuzufügende Benutzer-IDs. Finden Sie sie mit users list.

Beispiel

uip admin groups members add a1b2c3d4-0000-0000-0000-000000000001 --user-ids "user-id-1,user-id-2"

Datenform (--output json)

{ "Code": "GroupMembersAdded" }

UIP-Administratorgruppenmitglieder widerrufen

Entfernen Sie einen oder mehrere Benutzer aus einer Gruppe. Der gleiche Lese-, Änderungs- und Schreibmechanismus wie members add mit directoryUserIDsToRemove.

Argumente

Name	Erforderlich	Zweck
<group-id>	ja	Gruppen-ID (UUID).

Optionen

Long	Wert	Erforderlich	Beschreibung
--user-ids <ids>	durch Kommas getrennt sind	ja	Zu entfernende Benutzer-IDs. Muss aktuelle Mitglieder sein.

Beispiel

uip admin groups members revoke a1b2c3d4-0000-0000-0000-000000000001 --user-ids "user-id-1"

Datenform (--output json)

{ "Code": "GroupMembersRevoked" }

Zugehörig

• uip admin robot-accounts – nicht-menschliche Identitäten, persönliche Zugriffstoken und OAuth-Scope-Referenz.
• uip admin external-apps – OAuth2 Client-Registrierungen und verbundene Anmeldeinformationen.
• uip admin smtp – E-Mail-Konfiguration der Organisation.
• uip platform users – Lizenzzuweisung (eine andere, lizenzfokussierte Benutzeroberfläche).

Siehe auch

• Globale Optionen
• Exitcodes