Ruolo

Gestisce i ruoli utente nei tenant per il controllo degli accessi basato sui ruoli.

Operazione Descrizione
Aggiungere Aggiunge un ruolo per un utente.
Elimina Rimuove un ruolo utente.
Elenco Visualizza un elenco di utenti e relativi ruoli.
Visualizza Restituisce i ruoli assegnati a un particolare account utente.
show-types Visualizza un elenco di ruoli supportati per il tenant.

Aggiungere

Aggiunge un ruolo a un utente registrato.

  • Un amministratore ha accesso completo a tutti i dispositivi e alle operazioni all'interno del tenant, inclusa l'autorizzazione per aggiungere o eliminare altri utenti. Il ruolo Amministratore viene assegnato per impostazione predefinita all'utente che crea il tenant.
  • Un collaboratore può aggiungere dispositivi e creare e modificare le distribuzioni. Gli sviluppatori di software e hardware che creano applicazioni, gestiscono dispositivi connessi e aggiornano le distribuzioni, ma non sono responsabili della gestione dell'accesso al tenant, devono avere il ruolo di collaboratore.
  • Un lettore ha accesso alle informazioni sul tenant, inclusi i dispositivi rivendicati, le distribuzioni e, se disponibili, i dati di segnalazione degli errori dai dispositivi. Questo ruolo è appropriato per il personale addetto alla manutenzione e alle operazioni, responsabile del monitoraggio delle prestazioni dei dispositivi connessi nelle installazioni degli utenti finali.

Parametri obbligatori

Parametro Digitare Descrizione
-u, --utente Stringa Specifica il nome dell'utente (indirizzo di posta elettronica).
-r, --role Stringa Specifica il ruolo da assegnare all'utente selezionato. I possibili ruoli sono: Amministratore, Collaboratore e Lettore.

Parametri facoltativi

Parametro Digitare Descrizione
-t, --tenant GUID o nome Specifica il tenant in cui eseguire questa operazione. Sostituisce il tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant.
Parametri globali

Per Azure Sphere CLI sono disponibili i seguenti parametri globali:

Parametro Descrizione
--debug Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se trovi un bug, fornisci l'output generato con il --debug flag attivato quando invii una segnalazione di bug.
-h, --help Stampa informazioni di riferimento CLI sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili.
--only-show-errors Mostra solo gli errori, eliminando gli avvisi.
-o, --output Cambia il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori separati da tabulazione), tabella (tabelle ASCII leggibili dall'uomo) e yaml. Per impostazione predefinita, l'output CLI .table Per altre informazioni sui formati di output disponibili, vedi Formato di output per i comandi CLI di Azure Sphere.
--Query Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere Security Services. Per altre informazioni ed esempi, vedere l'esercitazione su JMESPath e l'output del comando CLI di Azure query.
--Dettagliato Consente di stampare informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Da usare --debug per i log di debug completi.

Nota

Se si usa la cli classica di Azure Sphere, vedere Parametri globali per ulteriori informazioni sulle opzioni disponibili.

Esempio

azsphere role add --user john@contoso.com --role Administrator

Elimina

Rimuove un ruolo da un utente nel tenant Azure Sphere corrente o selezionato.

Parametri obbligatori

Parametro Digitare Descrizione
-u, --utente Stringa Specifica l'ID o l'indirizzo e-mail dell'utente per identificare l'utente da cui viene eliminato il ruolo.
-r, --role Enum Specifica il ruolo da eliminare. I possibili ruoli sono: Amministratore, Collaboratore e Lettore.

Parametri facoltativi

Parametro Digitare Descrizione
-t, --tenant GUID o nome Specifica il tenant in cui eseguire questa operazione. Sostituisce il tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant.

Nota

Il ruolo Amministratore dell'utente corrente può essere eliminato solo da un altro amministratore.

Parametri globali

Per Azure Sphere CLI sono disponibili i seguenti parametri globali:

Parametro Descrizione
--debug Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se trovi un bug, fornisci l'output generato con il --debug flag attivato quando invii una segnalazione di bug.
-h, --help Stampa informazioni di riferimento CLI sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili.
--only-show-errors Mostra solo gli errori, eliminando gli avvisi.
-o, --output Cambia il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori separati da tabulazione), tabella (tabelle ASCII leggibili dall'uomo) e yaml. Per impostazione predefinita, l'output CLI .table Per altre informazioni sui formati di output disponibili, vedi Formato di output per i comandi CLI di Azure Sphere.
--Query Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere Security Services. Per altre informazioni ed esempi, vedere l'esercitazione su JMESPath e l'output del comando CLI di Azure query.
--Dettagliato Consente di stampare informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Da usare --debug per i log di debug completi.

Nota

Se si usa la cli classica di Azure Sphere, vedere Parametri globali per ulteriori informazioni sulle opzioni disponibili.

Esempio

azsphere role delete --user bob@contoso.com --role contributor --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb

Elenco

Visualizza un elenco di ruoli utente nel tenant corrente o selezionato.

L'elenco verrà troncato dopo le prime 500 voci.

Parametri facoltativi

Parametro Digitare Descrizione
-t, --tenant GUID o nome Specifica il tenant in cui eseguire questa operazione. Sostituisce il tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant.
Parametri globali

Per Azure Sphere CLI sono disponibili i seguenti parametri globali:

Parametro Descrizione
--debug Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se trovi un bug, fornisci l'output generato con il --debug flag attivato quando invii una segnalazione di bug.
-h, --help Stampa informazioni di riferimento CLI sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili.
--only-show-errors Mostra solo gli errori, eliminando gli avvisi.
-o, --output Cambia il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori separati da tabulazione), tabella (tabelle ASCII leggibili dall'uomo) e yaml. Per impostazione predefinita, l'output CLI .table Per altre informazioni sui formati di output disponibili, vedi Formato di output per i comandi CLI di Azure Sphere.
--Query Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere Security Services. Per altre informazioni ed esempi, vedere l'esercitazione su JMESPath e l'output del comando CLI di Azure query.
--Dettagliato Consente di stampare informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Da usare --debug per i log di debug completi.

Nota

Se si usa la cli classica di Azure Sphere, vedere Parametri globali per ulteriori informazioni sulle opzioni disponibili.

Esempio

 azsphere role list --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
 --------------------- -------------
 Name                  Roles
 ===================================
 bob@contoso.com       Administrator
                       Contributor
 --------------------- -------------

Visualizza

Visualizza le informazioni sul ruolo per un utente selezionato.

Parametri obbligatori

Parametro Digitare Descrizione
-u, --utente Stringa Nome utente da visualizzare (indirizzo di posta elettronica).

Parametri facoltativi

Parametro Digitare Descrizione
-t, --tenant GUID o nome Specifica il tenant in cui eseguire questa operazione. Sostituisce il tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant.
Parametri globali

Per Azure Sphere CLI sono disponibili i seguenti parametri globali:

Parametro Descrizione
--debug Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se trovi un bug, fornisci l'output generato con il --debug flag attivato quando invii una segnalazione di bug.
-h, --help Stampa informazioni di riferimento CLI sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili.
--only-show-errors Mostra solo gli errori, eliminando gli avvisi.
-o, --output Cambia il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori separati da tabulazione), tabella (tabelle ASCII leggibili dall'uomo) e yaml. Per impostazione predefinita, l'output CLI .table Per altre informazioni sui formati di output disponibili, vedi Formato di output per i comandi CLI di Azure Sphere.
--Query Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere Security Services. Per altre informazioni ed esempi, vedere l'esercitazione su JMESPath e l'output del comando CLI di Azure query.
--Dettagliato Consente di stampare informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Da usare --debug per i log di debug completi.

Nota

Se si usa la cli classica di Azure Sphere, vedere Parametri globali per ulteriori informazioni sulle opzioni disponibili.

Esempio

azsphere role show --user john@contoso.com --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
 -------------
 Roles
 =============
 Administrator
 Contributor
 -------------

show-types

Visualizza i ruoli che possono essere assegnati in questo tenant.

Parametri globali

Per Azure Sphere CLI sono disponibili i seguenti parametri globali:

Parametro Descrizione
--debug Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se trovi un bug, fornisci l'output generato con il --debug flag attivato quando invii una segnalazione di bug.
-h, --help Stampa informazioni di riferimento CLI sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili.
--only-show-errors Mostra solo gli errori, eliminando gli avvisi.
-o, --output Cambia il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori separati da tabulazione), tabella (tabelle ASCII leggibili dall'uomo) e yaml. Per impostazione predefinita, l'output CLI .table Per altre informazioni sui formati di output disponibili, vedi Formato di output per i comandi CLI di Azure Sphere.
--Query Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere Security Services. Per altre informazioni ed esempi, vedere l'esercitazione su JMESPath e l'output del comando CLI di Azure query.
--Dettagliato Consente di stampare informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Da usare --debug per i log di debug completi.

Nota

Se si usa la cli classica di Azure Sphere, vedere Parametri globali per ulteriori informazioni sulle opzioni disponibili.

Esempio

azsphere role show-types
 -------------
 Result
 =============
 Administrator
 -------------
 Contributor
 -------------
 Reader
 -------------