UIP o roles

uip or roles los roles y permisos de Orchestrator (RBAC). Los roles agrupan los permisos y se asignan a los usuarios a nivel de tenant (globalmente) o de carpeta (ámbito). Los verbos de esta página cubren los roles y sus permisos, la pertenencia a roles y usuarios y las asignaciones a nivel de carpeta. Para la asignación de roles en el nivel de tenant por usuario, consulta users assign-roles en uip or users.

Sinopsis

uip or roles <verb> [options]

Verbos

Verbo	Propósito
list-permissions	Enumerar los nombres de permisos que se pueden conceder.
list-roles	Enumera los roles en el tenant.
get-role	Obtener un rol con sus permisos concedidos.
create-role	Crea un rol (sin permisos) en el ámbito Tenant o Folder .
edit-role	Añade o elimina permisos en un rol.
delete-role	Eliminar un rol creado por el usuario.
list-role-users	Enumerar los usuarios asignados a un rol.
set-role-users	Añadir o eliminar usuarios en un rol (en masa).
list-user-roles	Muestra las asignaciones de roles completas de un usuario en el tenant y en cada carpeta.
assign	Asigna roles en el nivel de carpeta a un usuario en una carpeta específica.

UIP o permisos de lista de roles

Enumera todos los nombres de permisos que se pueden conceder. Utilice estos nombres con roles edit-role --add-permissions.

Opciones

Corto	Largo	Valor	Predeterminado	Descripción
-t	--tenant	name	sesión predeterminada	Anula el tenant.
-l	--limit	Número	50	Tamaño de la página.
—	--offset	Número	0	Omitir recuento.
—	--order-by	Campo	Name asc	Ordenación de OData.

Ejemplos

uip or roles list-permissions --limit 200
uip or roles list-permissions --output-filter 'Data[].Name'
uip or roles list-permissions --output table

Forma de datos (--json de salida)

{
  "Code": "PermissionList",
  "Data": [{ "Name": "Assets.Create" }, { "Name": "Assets.Delete" }]
}

uip o roles lista-roles

Enumerar roles. Devuelve la clave (GUID), ID, nombre, nombre para mostrar, tipo y si el rol es editable.

Opciones

Corto	Largo	Valor	Predeterminado	Descripción
-t	--tenant	name	sesión predeterminada	Anula el tenant.
-l	--limit	Número	50	Tamaño de la página.
—	--offset	Número	0	Omitir recuento.
—	--order-by	Campo	Id desc	Ordenación de OData.

Ejemplos

uip or roles list-roles --limit 50
uip or roles list-roles --output-filter "Data[?Type=='Tenant'].Name"
uip or roles list-roles --output table

Forma de datos (--json de salida)

{
  "Code": "RoleList",
  "Data": [
    {
      "Key": "a1b2c3d4-0000-0000-0000-000000000001",
      "ID": 1,
      "Name": "Administrator",
      "DisplayName": "Administrator",
      "Type": "Tenant",
      "IsEditable": false
    }
  ]
}

uip o roles get-role

Obtener un rol con sus permisos concedidos.

Argumentos

Nombre	Obligatorio	Propósito
<role-key>	Sí	Clave de rol (GUID).

Opciones

Corto	Largo	Valor	Predeterminado	Descripción
-t	--tenant	name	sesión predeterminada	Anula el tenant.

Ejemplos

uip or roles get-role a1b2c3d4-0000-0000-0000-000000000001
uip or roles get-role a1b2c3d4-0000-0000-0000-000000000001 \
    --output-filter 'Data.Permissions'
uip or roles get-role a1b2c3d4-0000-0000-0000-000000000001 --output table

Forma de datos (--json de salida)

{
  "Code": "Role",
  "Data": {
    "Key": "a1b2c3d4-0000-0000-0000-000000000001",
    "ID": 1,
    "Name": "Administrator",
    "DisplayName": "Administrator",
    "Type": "Tenant",
    "IsStatic": true,
    "IsEditable": false,
    "Permissions": "Assets.View, Assets.Create, Jobs.View"
  }
}

uip o roles create-role

Cree un rol sin permisos. Después de la creación, concede permisos con roles edit-role --add-permissions.

Opciones

Corto	Largo	Valor	Predeterminado	Descripción
—	--name	text	obligatorio	Nombre del rol.
—	--type	ENUM	obligatorio	Tenant (se aplica en todo el tenant) o ( Folder aplica dentro de las carpetas).
-t	--tenant	name	sesión predeterminada	Anula el tenant.

Ejemplos

uip or roles create-role --name "Read Only" --type Tenant
uip or roles create-role --name "Folder Viewer" --type Folder
uip or roles create-role --name "Read Only" --type Tenant \
    --output-filter 'Data.Key'

Forma de datos (--json de salida)

{
  "Code": "RoleCreated",
  "Data": {
    "Key": "a1b2c3d4-0000-0000-0000-000000000010",
    "ID": 10,
    "Name": "Read Only",
    "Type": "Tenant",
    "Status": "Created successfully"
  }
}

rol de edición de uip o roles

Añade o elimina permisos en un rol. Lee los permisos actuales, alterna isGranted para los nombres en --add-permissions / --remove-permissions y guarda. Los nuevos nombres (que aún no están en el rol) se buscan en el catálogo de permisos completo del tenant y se añaden.

Argumentos

Nombre	Obligatorio	Propósito
<role-key>	Sí	Clave de rol (GUID).

Opciones

Corto	Largo	Valor	Predeterminado	Descripción
—	--add-permissions	CSV de nombres	—	Permisos para conceder.
—	--remove-permissions	CSV de nombres	—	Permisos para revocar.
-t	--tenant	name	sesión predeterminada	Anula el tenant.

Se requiere al menos uno de --add-permissions o --remove-permissions .

Ejemplos

uip or roles edit-role a1b2c3d4-0000-0000-0000-000000000010 \
    --add-permissions Assets.View,Jobs.View

uip or roles edit-role a1b2c3d4-0000-0000-0000-000000000010 \
    --remove-permissions Jobs.Edit

uip or roles edit-role a1b2c3d4-0000-0000-0000-000000000010 \
    --add-permissions Assets.View --output-filter 'Data.Status'

Forma de datos (--json de salida)

{
  "Code": "RoleUpdated",
  "Data": { "Key": "a1b2c3d4-0000-0000-0000-000000000010", "Status": "Updated successfully" }
}

uip o roles eliminar-rol

Eliminar un rol creado por el usuario. Los roles integrados (donde IsStatic=true) no se pueden eliminar.

Argumentos

Nombre	Obligatorio	Propósito
<role-key>	Sí	Clave de rol (GUID).

Opciones

Corto	Largo	Valor	Predeterminado	Descripción
-t	--tenant	name	sesión predeterminada	Anula el tenant.

Ejemplos

uip or roles delete-role a1b2c3d4-0000-0000-0000-000000000010
uip or roles delete-role a1b2c3d4-0000-0000-0000-000000000010 \
    --output-filter 'Data.Status'
uip or roles delete-role a1b2c3d4-0000-0000-0000-000000000010 --output plain

Forma de datos (--json de salida)

{
  "Code": "RoleDeleted",
  "Data": { "Key": "a1b2c3d4-0000-0000-0000-000000000010", "Status": "Deleted successfully" }
}

uip o roles list-role-users

Enumerar los usuarios asignados a un rol.

Argumentos

Nombre	Obligatorio	Propósito
<role-key>	Sí	Clave de rol (GUID).

Opciones

Corto	Largo	Valor	Predeterminado	Descripción
-t	--tenant	name	sesión predeterminada	Anula el tenant.
-l	--limit	Número	50	Tamaño de la página.
—	--offset	Número	0	Omitir recuento.

Ejemplos

uip or roles list-role-users a1b2c3d4-0000-0000-0000-000000000001
uip or roles list-role-users a1b2c3d4-0000-0000-0000-000000000001 --limit 200
uip or roles list-role-users a1b2c3d4-0000-0000-0000-000000000001 \
    --output-filter 'Data[].UserName'

Forma de datos (--json de salida)

{
  "Code": "RoleUserList",
  "Data": [
    {
      "Key": "d4e5f6a7-0000-0000-0000-000000000001",
      "ID": 101,
      "UserName": "[e-mail]",
      "FullName": "Admin User",
      "Type": "User"
    }
  ]
}

uip o roles set-role-users

Añadir o eliminar usuarios en un rol (en masa). Proporcione --add-user-keys, --remove-user-keys o ambos. Se requiere al menos uno.

Argumentos

Nombre	Obligatorio	Propósito
<role-key>	Sí	Clave de rol (GUID).

Opciones

Corto	Largo	Valor	Predeterminado	Descripción
—	--add-user-keys	CSV de GUID	—	Usuarios a añadir.
—	--remove-user-keys	CSV de GUID	—	Usuarios a eliminar.
-t	--tenant	name	sesión predeterminada	Anula el tenant.

Ejemplos

uip or roles set-role-users a1b2c3d4-0000-0000-0000-000000000010 \
    --add-user-keys d4e5f6a7-0000-0000-0000-000000000001

uip or roles set-role-users a1b2c3d4-0000-0000-0000-000000000010 \
    --add-user-keys d4e5f6a7-…-001,d4e5f6a7-…-002 \
    --remove-user-keys d4e5f6a7-…-099

uip or roles set-role-users a1b2c3d4-0000-0000-0000-000000000010 \
    --add-user-keys d4e5f6a7-…-001 --output-filter 'Data.Added'

Forma de datos (--json de salida)

{
  "Code": "RoleUsersUpdated",
  "Data": {
    "RoleKey": "a1b2c3d4-0000-0000-0000-000000000010",
    "Added": 1,
    "Removed": 0,
    "Status": "Updated successfully"
  }
}

uip o roles lista-usuario-roles

Enumera todas las asignaciones de roles para un usuario en el tenant y en cada carpeta. Útil para auditar el perfil de acceso completo de un usuario.

Argumentos

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

Opciones

Corto	Largo	Valor	Predeterminado	Descripción
-t	--tenant	name	sesión predeterminada	Anula el tenant.
-l	--limit	Número	50	Tamaño de la página.
—	--offset	Número	0	Omitir recuento.

Ejemplos

uip or roles list-user-roles [e-mail]
uip or roles list-user-roles [e-mail] \
    --output-filter "Data[?Scope=='Folder']"
uip or roles list-user-roles [e-mail] --output table

Forma de datos (--json de salida)

{
  "Code": "UserRoleList",
  "Data": [
    { "Scope": "Tenant", "FolderPath": "", "Role": "Administrator" },
    { "Scope": "Folder", "FolderPath": "Shared", "Role": "Folder Administrator" }
  ]
}

UIP o asignación de roles

Asigna roles en el nivel de carpeta a un usuario. Usa solo roles de tipo Carpeta. Requiere --folder-path o --folder-key.

Opciones

Corto	Largo	Valor	Predeterminado	Descripción
—	--user-key	GUID	obligatorio	Clave de usuario.
—	--role-keys	CSV de GUID	obligatorio	GUID de rol para asignar en la carpeta.
—	--folder-path	Ruta	—	Carpeta de destino. Proporciona esto o --folder-key.
—	--folder-key	GUID	—	Carpeta de destino.
-t	--tenant	name	sesión predeterminada	Anula el tenant.

Ejemplos

uip or roles assign --user-key d4e5f6a7-0000-0000-0000-000000000001 \
    --role-keys a1b2c3d4-0000-0000-0000-000000000002 \
    --folder-path "Shared"

uip or roles assign --user-key d4e5f6a7-0000-0000-0000-000000000001 \
    --role-keys a1b2c3d4-…-002,a1b2c3d4-…-003 \
    --folder-key b1c2d3e4-0000-0000-0000-000000000001

uip or roles assign --user-key d4e5f6a7-0000-0000-0000-000000000001 \
    --role-keys a1b2c3d4-0000-0000-0000-000000000002 \
    --folder-path "Shared" --output-filter 'Data.Status'

Forma de datos (--json de salida)

{
  "Code": "PermissionsAssigned",
  "Data": {
    "UserKey": "d4e5f6a7-0000-0000-0000-000000000001",
    "FolderPath": "Shared",
    "Status": "Assigned successfully"
  }
}

Códigos de salida

Consulta Códigos de salida. Sin anulaciones específicas de verbos.

Comandos relacionados

• uip or users : buscar claves de usuario; users assign-roles para asignaciones de roles en el nivel de tenant.
• uip or folders : localiza las claves de carpeta para roles assign.

Ver también

• Opciones globales.
• Autenticación.