Share via

az dt role-assignment

  • Referencia

Nota:

Esta referencia forma parte de la extensión azure-iot para la CLI de Azure (versión 2.37.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az dt role-assignment . Obtenga más información sobre las extensiones.

Administrar asignaciones de roles de RBAC para una instancia de Digital Twins.

Tenga en cuenta que para realizar asignaciones de roles, la entidad de seguridad registrada necesita permisos como Propietario o Acceso de usuario Administración istrator en el ámbito asignado.

Este grupo de comandos se proporciona para mayor comodidad. Para escenarios de asignación de roles más complejos, use el grupo de comandos "az role assignment".

Comandos

Nombre Description Tipo Estado
az dt role-assignment create

Asigne un usuario, un grupo o una entidad de servicio a un rol en una instancia de Digital Twins.

 Extensión GA
az dt role-assignment delete

Quite una asignación de roles de usuario, grupo o entidad de servicio de una instancia de Digital Twins.

 Extensión GA
az dt role-assignment list

Enumere las asignaciones de roles existentes de una instancia de Digital Twins.

 Extensión GA

az dt role-assignment create

Asigne un usuario, un grupo o una entidad de servicio a un rol en una instancia de Digital Twins.

Tenga en cuenta que para realizar asignaciones de roles, la entidad de seguridad registrada necesita permisos como Propietario o Acceso de usuario Administración istrator en el ámbito asignado.

az dt role-assignment create --assignee
                             --dt-name
                             --role
                             [--resource-group]

Ejemplos

Asigne a un usuario (por correo electrónico) el rol integrado Propietario de Digital Twins en una instancia de destino.

az dt role-assignment create -n {instance_name} --assignee "owneruser@microsoft.com" --role "Azure Digital Twins Data Owner"

Asigne a un usuario (por identificador de objeto) el rol integrado Lector de Digital Twins en una instancia de destino.

az dt role-assignment create -n {instance_name} --assignee "97a89267-0966-4054-a156-b7d86ef8e216" --role "Azure Digital Twins Data Reader"

Asigne a una entidad de servicio un rol personalizado en una instancia de destino.

az dt role-assignment create -n {instance_name} --assignee {service_principal_name_or_id} --role {role_name_or_id}

Parámetros requeridos

--assignee

Representa un usuario, un grupo o una entidad de servicio. formato admitido: id. de objeto, nombre de inicio de sesión de usuario o nombre de entidad de seguridad de servicio.

--dt-name --dtn -n

Nombre de instancia de Digital Twins.

--role

Nombre de rol o Identificador.

Parámetros opcionales

--resource-group -g

Grupo de recursos de instancia de Digital Twins. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az dt role-assignment delete

Quite una asignación de roles de usuario, grupo o entidad de servicio de una instancia de Digital Twins.

Tenga en cuenta que para realizar asignaciones de roles, la entidad de seguridad registrada necesita permisos como Propietario o Acceso de usuario Administración istrator en el ámbito asignado.

az dt role-assignment delete --dt-name
                             [--assignee]
                             [--resource-group]
                             [--role]

Ejemplos

Quite un usuario de una asignación de roles específica de una instancia de Digital Twins.

az dt role-assignment delete -n {instance_name} --assignee "removeuser@microsoft.com" --role "Azure Digital Twins Data Reader"

Quite un usuario de todos los roles asignados de una instancia de Digital Twins.

az dt role-assignment delete -n {instance_name} --assignee "removeuser@microsoft.com"

Parámetros requeridos

--dt-name --dtn -n

Nombre de instancia de Digital Twins.

Parámetros opcionales

--assignee

Representa un usuario, un grupo o una entidad de servicio. formato admitido: id. de objeto, nombre de inicio de sesión de usuario o nombre de entidad de seguridad de servicio.

--resource-group -g

Grupo de recursos de instancia de Digital Twins. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--role

Nombre de rol o Identificador.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az dt role-assignment list

Enumere las asignaciones de roles existentes de una instancia de Digital Twins.

az dt role-assignment list --dt-name
                           [--include-inherited {false, true}]
                           [--resource-group]
                           [--role]

Ejemplos

Enumere las asignaciones de roles en una instancia de destino.

az dt role-assignment list -n {instance_name}

Enumere las asignaciones de roles en una instancia de destino y filtre por rol.

az dt role-assignment list -n {instance_name} --role {role_name_or_id}

Parámetros requeridos

--dt-name --dtn -n

Nombre de instancia de Digital Twins.

Parámetros opcionales

--include-inherited

Incluir asignaciones aplicadas en ámbitos primarios.

valores aceptados: false, true
valor predeterminado: False
--resource-group -g

Grupo de recursos de instancia de Digital Twins. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--role

Nombre de rol o Identificador.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.