az iot central user

Nota

Questo riferimento fa parte dell'estensione azure-iot per l'interfaccia della riga di comando di Azure (versione 2.46.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az iot central user . Altre informazioni sulle estensioni.

Gestire e configurare gli utenti di IoT Central.

Comandi

Nome	Descrizione	Tipo	Status
az iot central user create	Aggiungere un utente all'applicazione.	Estensione	Disponibilità generale
az iot central user delete	Eliminare un utente dall'applicazione.	Estensione	Disponibilità generale
az iot central user list	Ottenere l'elenco di utenti per un'applicazione IoT Central.	Estensione	Disponibilità generale
az iot central user show	Ottenere i dettagli di un utente in base all'ID.	Estensione	Disponibilità generale
az iot central user update	Aggiornare i ruoli per un utente nell'applicazione.	Estensione	Disponibilità generale

az iot central user create

Aggiungere un utente all'applicazione.

az iot central user create --app-id
                           --assignee
                           --role
                           [--api-version {2022-06-30-preview, 2022-07-31}]
                           [--central-api-uri]
                           [--email]
                           [--object-id]
                           [--org-id]
                           [--tenant-id]
                           [--token]

Esempio

Aggiungere un utente tramite posta elettronica all'applicazione

az iot central user create --user-id {userId} --app-id {appId} --email {emailAddress} --role admin

Aggiungere un'entità servizio all'applicazione

az iot central user create --user-id {userId} --app-id {appId} --tenant-id {tenantId} --object-id {objectId} --role operator

Parametri necessari

--app-id -n

ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.

--assignee --user-id

ID associato all'utente.

--role -r

Ruolo che verrà associato a questo token o utente. È possibile specificare uno dei ruoli predefiniti o specificare l'ID ruolo di un ruolo personalizzato. Per altre informazioni, vedere https://aka.ms/iotcentral-customrolesdocs.

Parametri facoltativi

--api-version --av

Deprecato

L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.

Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.

Valori accettati: 2022-06-30-preview, 2022-07-31

Valore predefinito: 2022-07-31

--central-api-uri --central-dns-suffix

Suffisso DNS di IoT Central associato all'applicazione.

Valore predefinito: azureiotcentral.com

--email

Indirizzo di posta elettronica dell'utente da aggiungere all'app. Se questa opzione è specificata, i parametri dell'entità servizio (tenant_id e object_id) verranno ignorati.

--object-id --oid

ID oggetto per l'entità servizio da aggiungere all'app. È necessario specificare anche l'ID tenant. Se si specifica un messaggio di posta elettronica, questo viene ignorato e l'utente non sarà un utente dell'entità servizio ma un utente standard di "posta elettronica".

--org-id --organization-id

ID dell'organizzazione per l'assegnazione di ruolo utente. Disponibile solo per api-version == 1.1-preview.

--tenant-id --tnid

ID tenant per l'entità servizio da aggiungere all'app. È necessario specificare anche l'ID oggetto. Se si specifica un messaggio di posta elettronica, questo viene ignorato e l'utente non sarà un utente dell'entità servizio ma un utente standard di "posta elettronica".

--token

Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

Valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az iot central user delete

Eliminare un utente dall'applicazione.

az iot central user delete --app-id
                           --assignee
                           [--api-version {2022-06-30-preview, 2022-07-31}]
                           [--central-api-uri]
                           [--token]

Esempio

Eliminare un utente

az iot central user delete --app-id {appid} --user-id {userId}

Parametri necessari

--app-id -n

ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.

--assignee --user-id

ID associato all'utente.

Parametri facoltativi

--api-version --av

Deprecato

L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.

Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.

Valori accettati: 2022-06-30-preview, 2022-07-31

Valore predefinito: 2022-07-31

--central-api-uri --central-dns-suffix

Suffisso DNS di IoT Central associato all'applicazione.

Valore predefinito: azureiotcentral.com

--token

Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

Valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az iot central user list

Ottenere l'elenco di utenti per un'applicazione IoT Central.

az iot central user list --app-id
                         [--api-version {2022-06-30-preview, 2022-07-31}]
                         [--central-api-uri]
                         [--token]

Esempio

Elenco di utenti

az iot central user list --app-id {appid}

Parametri necessari

--app-id -n

ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.

Parametri facoltativi

--api-version --av

Deprecato

L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.

Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.

Valori accettati: 2022-06-30-preview, 2022-07-31

Valore predefinito: 2022-07-31

--central-api-uri --central-dns-suffix

Suffisso DNS di IoT Central associato all'applicazione.

Valore predefinito: azureiotcentral.com

--token

Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

Valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az iot central user show

Ottenere i dettagli di un utente in base all'ID.

az iot central user show --app-id
                         --assignee
                         [--api-version {2022-06-30-preview, 2022-07-31}]
                         [--central-api-uri]
                         [--token]

Esempio

Ottenere i dettagli dell'utente

az iot central user show --app-id {appid} --user-id {userId}

Parametri necessari

--app-id -n

ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.

--assignee --user-id

ID associato all'utente.

Parametri facoltativi

--api-version --av

Deprecato

L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.

Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.

Valori accettati: 2022-06-30-preview, 2022-07-31

Valore predefinito: 2022-07-31

--central-api-uri --central-dns-suffix

Suffisso DNS di IoT Central associato all'applicazione.

Valore predefinito: azureiotcentral.com

--token

Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

Valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az iot central user update

Aggiornare i ruoli per un utente nell'applicazione.

Aggiornare un utente con ruoli diversi. L'aggiornamento di tenantId o objectId per un utente dell'entità servizio non è consentito. L'aggiornamento dell'indirizzo di posta elettronica per un utente di posta elettronica non è consentito.

az iot central user update --app-id
                           --assignee
                           [--api-version {2022-06-30-preview, 2022-07-31}]
                           [--central-api-uri]
                           [--email]
                           [--object-id]
                           [--roles]
                           [--tenant-id]
                           [--token]

Esempio

Aggiornare i ruoli per un utente tramite posta elettronica o entità servizio nell'applicazione.

az iot central user update --user-id {userId} --app-id {appId} --roles "org1\admin"

Parametri necessari

--app-id -n

ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.

--assignee --user-id

ID associato all'utente.

Parametri facoltativi

--api-version --av

Deprecato

L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.

Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.

Valori accettati: 2022-06-30-preview, 2022-07-31

Valore predefinito: 2022-07-31

--central-api-uri --central-dns-suffix

Suffisso DNS di IoT Central associato all'applicazione.

Valore predefinito: azureiotcentral.com

--email

Indirizzo di posta elettronica dell'utente da aggiungere all'app. Se questa opzione è specificata, i parametri dell'entità servizio (tenant_id e object_id) verranno ignorati.

--object-id --oid

ID oggetto per l'entità servizio da aggiungere all'app. È necessario specificare anche l'ID tenant. Se si specifica un messaggio di posta elettronica, questo viene ignorato e l'utente non sarà un utente dell'entità servizio ma un utente standard di "posta elettronica".

--roles

Elenco delimitato da virgole di ruoli che verranno associati all'utente. È possibile specificare uno dei ruoli predefiniti o specificare l'ID ruolo di un ruolo personalizzato. Per altre informazioni, vedere https://aka.ms/iotcentral-customrolesdocs. Le organizzazioni possono essere specificate insieme ai ruoli durante l'esecuzione con la versione API == 1.1-preview. Ad esempio, "organization_id\role".

--tenant-id --tnid

ID tenant per l'entità servizio da aggiungere all'app. È necessario specificare anche l'ID oggetto. Se si specifica un messaggio di posta elettronica, questo viene ignorato e l'utente non sarà un utente dell'entità servizio ma un utente standard di "posta elettronica".

--token

Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

Valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.