Administración de roles de función
Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer
A las entidades de seguridad se les concede acceso a los recursos a través de un modelo de control de acceso basado en roles, donde sus roles de seguridad asignados determinan su acceso a los recursos.
En las funciones, el único rol de seguridad es admins. La función admins tiene la capacidad de ver, modificar y quitar la función.
En este artículo, aprenderá a usar comandos de administración para ver los administradores existentes, así como agregar y quitar administradores en funciones.
Nota:
Una entidad de seguridad debe tener acceso en el nivel de base de datos o tabla para que sea un administrador de funciones.
Permisos
Debe tener permisos de administrador de base de datos o ser administrador de funciones en la función específica para ejecutar estos comandos. Para más información, vea Control de acceso basado en roles.
Mostrar administradores existentes
Antes de agregar o quitar entidades de seguridad, puede usar el .show comando para ver una tabla con todas las entidades de seguridad que ya tienen acceso de administrador en la función.
Sintaxis
Para mostrar todos los roles:
.showfunction FunctionName principals
Para mostrar los roles:
.showfunction FunctionName principal roles
Obtenga más información sobre las convenciones de sintaxis.
Parámetros
| Nombre | Type | Obligatorio | Descripción |
|---|---|---|---|
| FunctionName | string |
✔️ | Nombre de la función para la que se van a enumerar las entidades de seguridad. |
Ejemplo
El comando siguiente enumera todas las entidades de seguridad que tienen acceso a la SampleFunction función.
.show function SampleFunction principals
Salida del ejemplo
| Role | PrincipalType | PrincipalDisplayName | PrincipalObjectId | PrincipalFQN |
|---|---|---|---|---|
| Administrador de Function SampleFunction | Usuario de Microsoft Entra | Abbi Atkins | cd709aed-a26c-e3953dec735e | aaduser=abbiatkins@fabrikam.com |
Agregar y quitar administradores
En esta sección se proporciona sintaxis, parámetros y ejemplos para agregar y quitar entidades de seguridad.
Sintaxis
Action function FunctionName ( admins Principal [, Principal...] ) [skip-results] [ Description ]
Obtenga más información sobre las convenciones de sintaxis.
Parámetros
| Nombre | Type | Obligatorio | Descripción |
|---|---|---|---|
| Acción | string |
✔️ | .addComando , .dropo .set..add agrega las entidades de seguridad especificadas, .drop quita las entidades de seguridad especificadas y .set agrega las entidades de seguridad especificadas y quita todas las anteriores. |
| FunctionName | string |
✔️ | Nombre de la función para la que se van a agregar entidades de seguridad. |
| Principal | string |
✔️ | Una o varias entidades de seguridad. Para obtener instrucciones sobre cómo especificar estas entidades de seguridad, consulte Referencia a entidades de seguridad. |
skip-results |
string |
Si se proporciona, el comando no devolverá la lista actualizada de entidades de seguridad de función. | |
| Descripción | string |
Texto para describir el cambio que se mostrará al usar el .show comando . |
Nota:
El .set comando con none en lugar de una lista de entidades de seguridad quitará todas las entidades de seguridad.
Ejemplos
En los ejemplos siguientes, verá cómo agregar administradores, quitar administradores y agregar y quitar administradores en el mismo comando.
Adición de administradores con .add
En el ejemplo siguiente se agrega una entidad de seguridad al admins rol de la SampleFunction función .
.add function SampleFunction admins ('aaduser=imikeoein@fabrikam.com')
Quitar administradores con .drop
En el ejemplo siguiente se quitan todas las entidades de seguridad del grupo del admins rol de la SampleFunction función .
.drop function SampleFunction admins ('aadGroup=SomeGroupEmail@fabrikam.com')
Agregar nuevos administradores y quitar el antiguo con .set
En el ejemplo siguiente se quitan las entidades de seguridad existentes admins y se agregan las entidades de seguridad proporcionadas como admins en la SampleFunction función .
.set function SampleFunction admins ('aaduser=imikeoein@fabrikam.com', 'aaduser=abbiatkins@fabrikam.com')
Quitar todos los administradores con .set
El siguiente comando quita todos los existentes admins en la SampleFunction función.
.set function SampleFunction admins none