ruolorole

Gestisce i ruoli utente nei tenant per il controllo degli accessi in base al ruolo (RBAC).Manages user roles in tenants for role-based access control (RBAC).

OperazioneOperation descriptiondescription
addadd Aggiunge un ruolo per un utenteAdds a role for a user
deletedelete Rimuove un ruolo utenteRemoves a user role
listlist Visualizza un elenco di utenti e i relativi ruoliDisplays a list of users and their roles
remove-legacy-accessremove-legacy-access Rimuove l'accesso legacyRemoves legacy access
showshow Restituisce i ruoli assegnati a un account utente specificoReturns roles assigned to a particular user account
show-typesshow-types Visualizza un elenco di ruoli supportati per questo tenantDisplays a list of roles supported for this tenant

addadd

Aggiunge un ruolo a un utente registrato.Adds a role to a registered user.

  • Un amministratore ha accesso completo a tutti i dispositivi e le operazioni all'interno del tenant, inclusa l'autorizzazione per l'aggiunta o l'eliminazione di altri utenti.An Administrator has full access to all devices and operations within the tenant, including the permission to add or delete other users. Per impostazione predefinita, il ruolo di amministratore viene assegnato all'utente che crea il tenant.The Administrator role is assigned by default to the user who creates the tenant.
  • Un collaboratore può aggiungere dispositivi e creare e modificare le distribuzioni.A Contributor can add devices and create and change deployments. Gli sviluppatori di software e hardware che creano applicazioni, gestiscono dispositivi connessi e aggiornano le distribuzioni, ma non sono responsabili della gestione dell'accesso dei tenant, devono avere il ruolo Collaboratore.Software and hardware developers who create applications, manage connected devices, and update deployments, but are not responsible for managing tenant access, should have the Contributor role.
  • Un lettore può accedere alle informazioni sul tenant, inclusi i dispositivi richiesti, le distribuzioni e, quando disponibili, eventuali dati di segnalazione degli errori dai dispositivi.A Reader has access to information about the tenant, including the claimed devices, deployments, and, when available, any error reporting data from the devices. Questo ruolo è appropriato per il personale operativo e di manutenzione responsabile del monitoraggio delle prestazioni dei dispositivi connessi durante le installazioni degli utenti finali.This role is appropriate for maintenance and operations personnel who are responsible for tracking connected device performance at end-user installations.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-u, --user-u, --user stringString Specifica il nome dell'utente (indirizzo di posta elettronica).Specifies the name of the user (email address). -Azure Sphere CLI V1- Azure Sphere CLI v1
-Azure Sphere interfaccia della riga di comando v2 beta- Azure Sphere CLI v2 Beta
-r, --role -r, --role stringString Specifica il ruolo da assegnare all'utente selezionato.Specifies the role to assign to the selected user. I ruoli possibili sono amministratore, collaboratore e lettore.Possible roles are: Administrator, Contributor, and Reader. I valori non fanno distinzione tra maiuscole e minuscole.The values are not case-sensitive. -Azure Sphere CLI V1- Azure Sphere CLI v1
-Azure Sphere interfaccia della riga di comando v2 beta- Azure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-t,--tenant-t, --tenant stringString Specifica l'ID o il nome del tenant Azure Sphere a cui è assegnato il ruolo e l'utente.Specifies the ID or name of the Azure Sphere tenant to which the role and user is assigned. Azure Sphere dell'interfaccia della riga di comando v2 betaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere role add --user user1@microsoft.com --role administrator

eliminaredelete

Rimuove un ruolo da un utente nel tenant di Azure Sphere corrente o selezionato.Removes a role from a user in the current or selected Azure Sphere tenant.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-u, --user-u, --user stringString Specifica l'ID o l'indirizzo di posta elettronica dell'utente per identificare l'utente da cui viene eliminato il ruolo.Specifies the user's ID or email to identify the user from whom the role is being deleted. -Azure Sphere CLI V1- Azure Sphere CLI v1
-Azure Sphere interfaccia della riga di comando v2 beta- Azure Sphere CLI v2 Beta
-r, --role -r, --role EnumerazioneEnum Specifica il ruolo da eliminare.Specifies the role to be deleted. I ruoli possibili sono amministratore, collaboratore e lettore.Possible roles are: Administrator, Contributor, and Reader. I valori non fanno distinzione tra maiuscole e minuscole.The values are not case-sensitive. -Azure Sphere CLI V1- Azure Sphere CLI v1
-Azure Sphere interfaccia della riga di comando v2 beta- Azure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-t,--tenant-t, --tenant stringString Specifica l'ID o il nome del tenant Azure Sphere.Specifies the ID or name of the Azure Sphere tenant. Azure Sphere dell'interfaccia della riga di comando v2 betaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere role delete --user user1@microsoft.com --role contributor

Nota

Se l'utente è l'unico amministratore per il tenant, viene restituito un errore quando si elimina il administrator ruolo per tale utente.If the user is the only administrator for the tenant, an error is reported when you delete the administrator role for that user.

listlist

Visualizza un elenco di ruoli utente nel tenant corrente o selezionato.Displays a list of user roles in the current or selected tenant.

L'elenco viene troncato dopo le prime 500 voci.The list will truncate after the first 500 entries.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-t,--tenant-t, --tenant stringString Specifica l'ID o il nome del tenant Azure Sphere.Specifies the ID or name of the Azure Sphere tenant. Azure Sphere dell'interfaccia della riga di comando v2 betaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere role list
The following users and services are assigned to the Azure Sphere tenant with ID '143adbc9-a5c4-4be2-84a2-c4f00f73a472':
Name                  Roles
----                  -----
user@microsoft.com Administrator, Contributor

remove-legacy-accessremove-legacy-access

Comando monouso per rimuovere i metodi di controllo di accesso legacy dal tenant.One-time command to remove legacy access control methods from the tenant.

Quando si usa questo comando, solo gli utenti che sono stati registrati e assegnati a un ruolo possono accedere al tenant.Once this command is used, only users that have been registered and assigned a role can access the tenant.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-t,--tenant-t, --tenant stringString Specifica l'ID o il nome del tenant Azure Sphere per il quale viene rimosso l'accesso legacy.Specifies the ID or name of the Azure Sphere tenant for which the legacy access is removed. Azure Sphere dell'interfaccia della riga di comando v2 betaAzure Sphere CLI v2 Beta

EsempioExample

azsphere role remove-legacy-access

showshow

Visualizza le informazioni sul ruolo per un utente selezionato.Displays role information for a selected user.

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-u, --user-u, --user stringString Nome utente da visualizzare (indirizzo e-mail).User name to display (email address). -Azure Sphere CLI V1- Azure Sphere CLI v1
-Azure Sphere interfaccia della riga di comando v2 beta- Azure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-t,--tenant-t, --tenant stringString Specifica l'ID o il nome del tenant Azure Sphere.Specifies the ID or name of the Azure Sphere tenant. Azure Sphere dell'interfaccia della riga di comando v2 betaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere role show --user user@microsoft.com
The user 'user@microsoft.com' in the Azure Sphere tenant with ID 'd343c263-4aa3-4558-adbb-d3fc3463180' has the following roles:
Administrator, Contributor

show-typesshow-types

Visualizza i ruoli che possono essere assegnati in questo tenant.Displays roles that can be assigned in this tenant.

Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere role show-types
The following role types are available:
* Administrator
* Contributor
* Reader