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