Usuarios administradores de UIP

Sintaxis y opciones para `usuarios administradores de UIP` y `grupos administradores de UIP`, que gestionan los usuarios del directorio de Identity Server, los grupos y la pertenencia a grupos.

uip admin users y uip admin groups gestionan los usuarios y grupos locales de Identity Server dentro de la partición de tu organización: las identidades a nivel de directorio detrás del inicio de sesión, no las asignaciones de roles a nivel de Orchestrator. Aquí hay dos grupos de comandos independientes: users (crear/leer/actualizar/eliminar/invitar a usuarios del directorio) y groups (crear/leer/actualizar/eliminar grupos, más gestión de membresía).

--organization se acepta en la mayoría de los verbos de ambos grupos, pero está obsoleto e ignorado : la organización siempre se deriva de tu contexto de inicio de sesión actual. Al pasarlo se imprime una advertencia (--organization is deprecated and ignored; organization is derived from login context) pero no tiene efecto.

Sinopsis

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>

Verbos

Grupo	Verbo	Propósito
users	list	Enumera los usuarios en la partición (buscables, ordenables, paginadas).
users	get	Obtener los detalles completos de un usuario por ID.
users	create	Crea un nuevo usuario local.
users	update	Actualizar el correo electrónico, el nombre o el apellido de un usuario.
users	delete	Eliminar un usuario por ID.
users	invite	Invite a uno o más usuarios por correo electrónico.
groups	list	Enumera todos los grupos en la partición.
groups	get	Obtener los detalles de un grupo por ID.
groups	create	Crea un nuevo grupo local.
groups	update	Cambiar el nombre de un grupo.
groups	delete	Eliminar un grupo por ID.
groups members	list	Enumerar los miembros de un grupo.
groups members	add	Añade uno o más usuarios a un grupo.
groups members	revoke	Eliminar uno o más usuarios de un grupo.

lista de usuarios administradores de uip

Enumera los usuarios en la partición. Devuelve el ID de usuario, el nombre de usuario, el correo electrónico, el nombre y la hora de creación.

Opciones

Largo	Corto	Valor	Predeterminado	Descripción
--search <term>	-s	String	—	Buscar usuarios por nombre o correo electrónico.
--sort-by <field>		String	—	Ordenar campo, por ejemplo UserName, Email.
--sort-order <direction>		asc|desc	asc	Ordenar dirección.
--limit <number>	-l	Entero	50 (DEFAULT_PAGE_SIZE)	Número de elementos que se van a devolver.
--offset <number>		Entero	0	Número de elementos que omitir.
--login-validity <minutes>		Entero	—	Anule la validez del token para esta llamada.

Ejemplo

uip admin users list --limit 5

Forma de datos (--json de salida)

{
  "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"
    }
  ]
}

los usuarios administradores de uip obtienen

Obtener detalles del usuario por ID.

Argumentos

Nombre	Obligatorio	Propósito
<user-id>	Sí	ID de usuario (UUID). Encuéntralo con users list.

Ejemplo

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

Forma de datos (--json de salida)

{
  "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"
  }
}

creación de usuarios administradores de uip

Crea un nuevo usuario local.

Argumentos

Nombre	Obligatorio	Propósito
<username>	Sí	Nombre de usuario para el nuevo usuario.

Opciones

Largo	Corto	Valor	Obligatorio	Descripción
--email <email>	-e	Correo electrónico	Sí	'juan.pé[e-mail]'.
--name <name>	-n	String	No	Nombre.
--surname <surname>		String	No	Apellido.

Ejemplo

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

Forma de datos (--json de salida)

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

actualización de usuarios administradores de uip

Actualizar el correo electrónico, el nombre o el apellido de un usuario existente. Se requiere al menos un campo: llamar con ninguno falla en el lado del cliente ("No fields to update") antes de cualquier llamada de red.

Argumentos

Nombre	Obligatorio	Propósito
<user-id>	Sí	ID de usuario (UUID).

Opciones

Largo	Corto	Valor	Descripción
--email <email>	-e	Correo electrónico	Nueva dirección de correo electrónico.
--name <name>	-n	String	Nuevo nombre.
--surname <surname>		String	Nuevo apellido.

Ejemplo

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

Forma de datos (--json de salida)

{ "Code": "UserUpdated" }

eliminar usuarios administradores de uip

Eliminar un usuario por ID.

Argumentos

Nombre	Obligatorio	Propósito
<user-id>	Sí	ID de usuario (UUID).

Ejemplo

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

Forma de datos (--json de salida)

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

Invitación de usuarios administradores de UIP

Invite a uno o más usuarios por correo electrónico. Envía una invitación para unirse a la organización.

Opciones

Largo	Corto	Valor	Obligatorio	Descripción
--email <emails>	-e	separados por comas	Sí	Una o más direcciones de correo electrónico para invitar.
--name <name>	-n	String	No	Nombre aplicado a cada usuario invitado.
--surname <surname>		String	No	Apellido aplicado a cada usuario invitado.

Ejemplo

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

Forma de datos (--json de salida)

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

lista de grupos de administración de uip

Enumera todos los grupos en la partición. Devuelve el ID, el nombre, el tipo y la hora de creación del grupo. Sin opciones de filtrado/paginación: devuelve todo en una llamada.

Ejemplo

uip admin groups list

Forma de datos (--json de salida)

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

grupos de administración de uip obtener

Obtener detalles del grupo por ID.

Argumentos

Nombre	Obligatorio	Propósito
<group-id>	Sí	ID de grupo (UUID). Encuéntralo con groups list.

Ejemplo

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

Forma de datos (--json de salida)

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

creación de grupos de administración de uip

Crea un nuevo grupo local.

Argumentos

Nombre	Obligatorio	Propósito
<name>	Sí	Nombre del grupo.

Ejemplo

uip admin groups create "DevOps Team"

Forma de datos (--json de salida)

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

El comando genera un UUID del lado del cliente para el id del grupo antes de llamar a la API: el servidor rechaza la creación del grupo con un 409 si no se proporciona ningún ID.

actualización de grupos de administración de uip

Cambiar el nombre de un grupo. --name es el único campo actualizable y es obligatorio; omitirlo falla en el lado del cliente ("No fields to update").

Argumentos

Nombre	Obligatorio	Propósito
<group-id>	Sí	ID de grupo (UUID).

Opciones

Largo	Corto	Valor	Obligatorio	Descripción
--name <name>	-n	String	Sí	Nuevo nombre de grupo.

Ejemplo

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

Forma de datos (--json de salida)

{ "Code": "GroupUpdated" }

eliminar grupos de administración de uip

Eliminar un grupo por ID.

Argumentos

Nombre	Obligatorio	Propósito
<group-id>	Sí	ID de grupo (UUID).

Ejemplo

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

Forma de datos (--json de salida)

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

lista de miembros de grupos de administración de uip

Enumerar los miembros de un grupo.

Argumentos

Nombre	Obligatorio	Propósito
<group-id>	Sí	ID de grupo (UUID).

Opciones

Largo	Corto	Valor	Predeterminado	Descripción
--limit <number>	-l	Entero	50	Número de elementos que se van a devolver.
--offset <number>		Entero	0	Número de elementos que omitir.

Ejemplo

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

Forma de datos (--json de salida)

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

miembros de grupos de administración de uip añadir

Añade uno o más usuarios a un grupo.

Nota:

Implementado como leer-modificar-escribir: el comando obtiene el nombre actual del grupo y luego llama a la API de actualización de grupo con directoryUserIDsToAdd — la misma operación subyacente que groups update, solo que con un campo de carga útil diferente. No hay ninguna opción dedicada a "añadir miembro" llamada a la API.

Argumentos

Nombre	Obligatorio	Propósito
<group-id>	Sí	ID de grupo (UUID).

Opciones

Largo	Valor	Obligatorio	Descripción
--user-ids <ids>	separados por comas	Sí	ID de usuario para añadir. Encuéntralos con users list.

Ejemplo

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

Forma de datos (--json de salida)

{ "Code": "GroupMembersAdded" }

miembros de grupos de administración de uip revocar

Eliminar uno o más usuarios de un grupo. El mismo mecanismo de lectura-modificación-escritura que members add, utilizando directoryUserIDsToRemove.

Argumentos

Nombre	Obligatorio	Propósito
<group-id>	Sí	ID de grupo (UUID).

Opciones

Largo	Valor	Obligatorio	Descripción
--user-ids <ids>	separados por comas	Sí	ID de usuario que se eliminarán. Deben ser miembros actuales.

Ejemplo

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

Forma de datos (--json de salida)

{ "Code": "GroupMembersRevoked" }

Relacionado

• uip admin robot-accounts : identidades no humanas, tokens de acceso personal y referencia de ámbito OAuth.
• uip admin external-apps : registros de clientes OAuth2 y credenciales federadas.
• uip admin smtp — configuración del correo electrónico de la organización.
• uip platform users : asignación de licencias (una superficie de usuario diferente, centrada en la licencia).

Ver también

• Opciones globales
• Códigos de salida