az iot central user

Note

Questo riferimento fa parte dell'estensione azure-iot per il interfaccia della riga di comando di Azure (versione 2.73.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.

 Extension GA
az iot central user delete

Eliminare un utente dall'applicazione.

 Extension GA
az iot central user list

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

 Extension GA
az iot central user show

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

 Extension GA
az iot central user update

Aggiornare i ruoli per un utente nell'applicazione.

 Extension GA

az iot central user create

Aggiungere un utente all'applicazione.

az iot central user create --app-id
                           --assignee --user-id
                           --role
                           [--acquire-policy-token]
                           [--api-version --av {2022-06-30-preview, 2022-07-31}]
                           [--central-api-uri --central-dns-suffix]
                           [--change-reference]
                           [--email]
                           [--object-id --oid]
                           [--org-id --organization-id]
                           [--tenant-id --tnid]
                           [--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

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--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.

Proprietà Valore
Valore predefinito: 2022-07-31
Valori accettati: 2022-06-30-preview, 2022-07-31
--central-api-uri --central-dns-suffix

Suffisso DNS di IoT Central associato all'applicazione.

Proprietà Valore
Valore predefinito: azureiotcentral.com
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--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 con il 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. Scopri di più su https://aka.ms/iotcentraldocsapi.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False

az iot central user delete

Eliminare un utente dall'applicazione.

az iot central user delete --app-id
                           --assignee --user-id
                           [--acquire-policy-token]
                           [--api-version --av {2022-06-30-preview, 2022-07-31}]
                           [--central-api-uri --central-dns-suffix]
                           [--change-reference]
                           [--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

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--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.

Proprietà Valore
Valore predefinito: 2022-07-31
Valori accettati: 2022-06-30-preview, 2022-07-31
--central-api-uri --central-dns-suffix

Suffisso DNS di IoT Central associato all'applicazione.

Proprietà Valore
Valore predefinito: azureiotcentral.com
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--token

Se si preferisce inviare la richiesta senza eseguire l'autenticazione con il 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. Scopri di più su https://aka.ms/iotcentraldocsapi.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False

az iot central user list

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

az iot central user list --app-id
                         [--api-version --av {2022-06-30-preview, 2022-07-31}]
                         [--central-api-uri --central-dns-suffix]
                         [--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

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--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.

Proprietà Valore
Valore predefinito: 2022-07-31
Valori accettati: 2022-06-30-preview, 2022-07-31
--central-api-uri --central-dns-suffix

Suffisso DNS di IoT Central associato all'applicazione.

Proprietà Valore
Valore predefinito: azureiotcentral.com
--token

Se si preferisce inviare la richiesta senza eseguire l'autenticazione con il 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. Scopri di più su https://aka.ms/iotcentraldocsapi.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False

az iot central user show

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

az iot central user show --app-id
                         --assignee --user-id
                         [--api-version --av {2022-06-30-preview, 2022-07-31}]
                         [--central-api-uri --central-dns-suffix]
                         [--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

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--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.

Proprietà Valore
Valore predefinito: 2022-07-31
Valori accettati: 2022-06-30-preview, 2022-07-31
--central-api-uri --central-dns-suffix

Suffisso DNS di IoT Central associato all'applicazione.

Proprietà Valore
Valore predefinito: azureiotcentral.com
--token

Se si preferisce inviare la richiesta senza eseguire l'autenticazione con il 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. Scopri di più su https://aka.ms/iotcentraldocsapi.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False

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 --user-id
                           [--acquire-policy-token]
                           [--api-version --av {2022-06-30-preview, 2022-07-31}]
                           [--central-api-uri --central-dns-suffix]
                           [--change-reference]
                           [--email]
                           [--object-id --oid]
                           [--roles]
                           [--tenant-id --tnid]
                           [--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

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--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.

Proprietà Valore
Valore predefinito: 2022-07-31
Valori accettati: 2022-06-30-preview, 2022-07-31
--central-api-uri --central-dns-suffix

Suffisso DNS di IoT Central associato all'applicazione.

Proprietà Valore
Valore predefinito: azureiotcentral.com
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--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 con il 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. Scopri di più su https://aka.ms/iotcentraldocsapi.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False