az iot dps

  • Riferimento

Nota

Questo gruppo di comandi include comandi definiti sia nell'interfaccia della riga di comando di Azure che in almeno un'estensione. Installare ogni estensione per trarre vantaggio dalle funzionalità estese. Altre informazioni sulle estensioni.

Gestisce il servizio Device Provisioning in hub IoT di Azure.

Comandi

Nome Descrizione Tipo Status
az iot dps certificate

Gestire i certificati per un'istanza del servizio Device Provisioning hub IoT di Azure.

 Memoria centrale Disponibilità generale
az iot dps certificate create

Creare/caricare un certificato in un'istanza del servizio Device Provisioning hub IoT di Azure.

 Memoria centrale Disponibilità generale
az iot dps certificate delete

Eliminare un certificato in un'istanza del servizio Device Provisioning hub IoT di Azure.

 Memoria centrale Disponibilità generale
az iot dps certificate generate-verification-code

Generare un codice di verifica per un certificato in un'istanza del servizio Device Provisioning hub IoT di Azure.

 Memoria centrale Disponibilità generale
az iot dps certificate list

Elencare tutti i certificati contenuti in un'istanza del servizio Device Provisioning hub IoT di Azure.

 Memoria centrale Disponibilità generale
az iot dps certificate show

Visualizzare informazioni su un determinato certificato in un'istanza del servizio Device Provisioning hub IoT di Azure.

 Memoria centrale Disponibilità generale
az iot dps certificate update

Aggiornare un certificato in un'istanza del servizio Device Provisioning hub IoT di Azure.

 Memoria centrale Disponibilità generale
az iot dps certificate verify

Verificare un certificato in un'istanza del servizio Device Provisioning hub IoT di Azure.

 Memoria centrale Disponibilità generale
az iot dps compute-device-key

Generare una chiave di firma di accesso condiviso del dispositivo derivata.

 Estensione Deprecato
az iot dps connection-string

Gestire stringa di connessione per un'istanza del servizio Device Provisioning hub IoT di Azure.

 Estensione Disponibilità generale
az iot dps connection-string show

Visualizzare le stringa di connessione per i servizi Device Provisioning specificati usando il nome e la chiave dei criteri specificati.

 Estensione Disponibilità generale
az iot dps create

Crea un'istanza del servizio Device Provisioning in hub IoT di Azure.

 Memoria centrale Disponibilità generale
az iot dps delete

Elimina un'istanza del servizio Device Provisioning in hub IoT di Azure.

 Memoria centrale Disponibilità generale
az iot dps enrollment

Gestire le registrazioni dei singoli dispositivi in un servizio Device Provisioning hub IoT di Azure.

 Estensione Disponibilità generale
az iot dps enrollment-group

Gestire i gruppi di registrazione in un servizio device provisioning hub IoT di Azure.

 Estensione Disponibilità generale
az iot dps enrollment-group compute-device-key

Generare una chiave di firma di accesso condiviso del dispositivo derivata per un gruppo di registrazione in un servizio Device Provisioning hub IoT di Azure.

 Estensione Disponibilità generale
az iot dps enrollment-group create

Creare un gruppo di registrazione in un servizio Device Provisioning hub IoT di Azure.

 Estensione Disponibilità generale
az iot dps enrollment-group delete

Eliminare un gruppo di registrazione in un servizio Device Provisioning hub IoT di Azure.

 Estensione Disponibilità generale
az iot dps enrollment-group list

Elencare i gruppi di registrazioni in un servizio device provisioning di hub IoT di Azure.

 Estensione Disponibilità generale
az iot dps enrollment-group registration

Gestire le registrazioni dei dispositivi sul lato servizio per un gruppo di registrazione in un servizio Device Provisioning hub IoT di Azure.

 Estensione Disponibilità generale
az iot dps enrollment-group registration delete

Eliminare una registrazione del dispositivo per un gruppo di registrazione in un servizio Device Provisioning hub IoT di Azure.

 Estensione Disponibilità generale
az iot dps enrollment-group registration list

Elencare le registrazioni dei dispositivi per un gruppo di registrazione in un servizio Device Provisioning hub IoT di Azure.

 Estensione Disponibilità generale
az iot dps enrollment-group registration show

Ottenere una registrazione del dispositivo per un gruppo di registrazione in un servizio Device Provisioning hub IoT di Azure.

 Estensione Disponibilità generale
az iot dps enrollment-group show

Ottenere i dettagli di un gruppo di registrazione in un servizio Device Provisioning hub IoT di Azure.

 Estensione Disponibilità generale
az iot dps enrollment-group update

Aggiornare un gruppo di registrazione in un servizio Device Provisioning hub IoT di Azure.

 Estensione Disponibilità generale
az iot dps enrollment create

Creare una registrazione di un singolo dispositivo in un servizio device provisioning hub IoT di Azure.

 Estensione Disponibilità generale
az iot dps enrollment delete

Eliminare una registrazione di un singolo dispositivo in un servizio Device Provisioning hub IoT di Azure.

 Estensione Disponibilità generale
az iot dps enrollment list

Elencare le registrazioni dei singoli dispositivi in un servizio Device Provisioning hub IoT di Azure.

 Estensione Disponibilità generale
az iot dps enrollment registration

Gestire le registrazioni dei dispositivi lato servizio per una registrazione singola in un servizio Device Provisioning hub IoT di Azure.

 Estensione Disponibilità generale
az iot dps enrollment registration delete

Eliminare una registrazione del dispositivo per una registrazione singola in un servizio Device Provisioning hub IoT di Azure.

 Estensione Disponibilità generale
az iot dps enrollment registration show

Ottenere una registrazione del dispositivo per una registrazione singola in un servizio device provisioning hub IoT di Azure.

 Estensione Disponibilità generale
az iot dps enrollment show

Ottenere i dettagli di registrazione dei singoli dispositivi in un servizio Device Provisioning hub IoT di Azure.

 Estensione Disponibilità generale
az iot dps enrollment update

Aggiornare una registrazione di un singolo dispositivo in un servizio Device Provisioning hub IoT di Azure.

 Estensione Disponibilità generale
az iot dps linked-hub

Gestire hub IoT collegate in un'istanza del servizio Device Provisioning hub IoT di Azure.

 Memoria centrale Disponibilità generale
az iot dps linked-hub create

Crea un hub IoT collegato in un'istanza del servizio Device Provisioning in hub IoT di Azure.

 Memoria centrale Disponibilità generale
az iot dps linked-hub delete

Aggiorna un hub IoT collegato in un'istanza del servizio Device Provisioning in hub IoT di Azure.

 Memoria centrale Disponibilità generale
az iot dps linked-hub list

Elenca tutti gli hub IoT collegati in un'istanza del servizio Device Provisioning in hub IoT di Azure.

 Memoria centrale Disponibilità generale
az iot dps linked-hub show

Mostra i dettagli di un hub IoT collegato in un'istanza del servizio Device Provisioning in hub IoT di Azure.

 Memoria centrale Disponibilità generale
az iot dps linked-hub update

Aggiorna un hub IoT collegato in un'istanza del servizio Device Provisioning in hub IoT di Azure.

 Memoria centrale Disponibilità generale
az iot dps list

Elenca le istanze del servizio Device Provisioning in hub IoT di Azure.

 Memoria centrale Disponibilità generale
az iot dps policy

Gestire i criteri di accesso condiviso per un'istanza del servizio Device Provisioning hub IoT di Azure.

 Memoria centrale Disponibilità generale
az iot dps policy create

Crea nuovi criteri di accesso condiviso in un'istanza del servizio Device Provisioning in hub IoT di Azure.

 Memoria centrale Disponibilità generale
az iot dps policy delete

Elimina i criteri di accesso condiviso in un'istanza del servizio Device Provisioning in hub IoT di Azure.

 Memoria centrale Disponibilità generale
az iot dps policy list

Elenca tutti i criteri di accesso condiviso in un'istanza del servizio Device Provisioning in hub IoT di Azure.

 Memoria centrale Disponibilità generale
az iot dps policy show

Visualizzare i dettagli di un criterio di accesso condiviso in un'istanza del servizio Device Provisioning hub IoT di Azure.

 Memoria centrale Disponibilità generale
az iot dps policy update

Aggiorna i criteri di accesso condiviso in un'istanza del servizio Device Provisioning in hub IoT di Azure.

 Memoria centrale Disponibilità generale
az iot dps registration

Gestire le registrazioni dei dispositivi per un gruppo di registrazione in un servizio Device Provisioning hub IoT di Azure.

 Estensione Deprecato
az iot dps registration delete

Eliminare una registrazione del dispositivo in un servizio Device Provisioning hub IoT di Azure.

 Estensione Deprecato
az iot dps registration list

Elencare le registrazioni dei dispositivi per un gruppo di registrazione in un servizio Device Provisioning hub IoT di Azure.

 Estensione Deprecato
az iot dps registration show

Ottenere una registrazione del dispositivo per un gruppo di registrazione in un servizio Device Provisioning hub IoT di Azure.

 Estensione Deprecato
az iot dps show

Ottiene i dettagli di un'istanza del servizio Device Provisioning in hub IoT di Azure.

 Memoria centrale Disponibilità generale
az iot dps update

Aggiorna un'istanza del servizio Device Provisioning in hub IoT di Azure.

 Memoria centrale Disponibilità generale

az iot dps compute-device-key

Deprecato

Questo comando è stato deprecato e verrà rimosso in una versione futura. Usare invece "iot dps enrollment-group compute-device-key".

Generare una chiave di firma di accesso condiviso del dispositivo derivata.

Generare una chiave di dispositivo derivata per un gruppo di registrazione DPS.

az iot dps compute-device-key --registration-id
                              [--auth-type {key, login}]
                              [--dps-name]
                              [--eid]
                              [--key]
                              [--login]
                              [--resource-group]

Esempio

Calcolare la chiave del dispositivo con la chiave simmetrica specificata.

az iot dps compute-device-key --key {enrollement_group_symmetric_key} --registration-id {registration_id}

Calcolare la chiave del dispositivo con il gruppo di registrazione specificato.

az iot dps compute-device-key -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --registration-id {registration_id}

Parametri necessari

--registration-id

ID della registrazione del dispositivo.

Parametri facoltativi

--auth-type

Indica se l'operazione deve derivare automaticamente una chiave di criteri o usare la sessione di Azure AD corrente. Se il tipo di autenticazione è login e viene specificato il nome host della risorsa, la ricerca della risorsa verrà ignorata a meno che non sia necessario. È possibile configurare l'impostazione predefinita usando az configure --defaults iotdps-data-auth-type=<auth-type-value>.

Valori accettati: key, login
Valore predefinito: key
--dps-name -n

Nome o nome host del servizio Device Provisioning hub IoT di Azure. Obbligatorio se non viene specificato --login.

--eid --enrollment-id --gid --group-id

ID gruppo di registrazione.

--key --symmetric-key

Chiave di accesso condiviso simmetrico per il gruppo di registrazione. In questo modo viene ignorato il Registro di sistema del servizio Device Provisioning e viene generato il token di firma di accesso condiviso direttamente dalla chiave simmetrica fornita senza ulteriore convalida. Tutti gli altri parametri di comando a parte l'ID registrazione verranno ignorati.

--login -l

Questo comando supporta un'entità stringa di connessione con diritti per eseguire l'azione. Usare per evitare l'accesso di sessione tramite "az login". Se vengono forniti sia un stringa di connessione di entità che un nome, il stringa di connessione ha priorità. Obbligatorio se non viene specificato --dps-name.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

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 dps create

Modifica

Crea un'istanza del servizio Device Provisioning in hub IoT di Azure.

Per un'introduzione a hub IoT di Azure servizio Device Provisioning, vedere https://docs.microsoft.com/azure/iot-dps/about-iot-dps.

az iot dps create --name
                  --resource-group
                  [--edr {false, true}]
                  [--location]
                  [--sku {S1}]
                  [--tags]
                  [--unit]

Esempio

Creare un servizio device provisioning hub IoT di Azure con il piano tariffario standard S1, nell'area del gruppo di risorse.

az iot dps create --name MyDps --resource-group MyResourceGroup

Creare un servizio device provisioning hub IoT di Azure con il piano tariffario standard S1, nell'area "eastus".

az iot dps create --name MyDps --resource-group MyResourceGroup --location eastus

Creare un servizio device provisioning hub IoT di Azure con la residenza dei dati applicata. In questo modo verrà disabilitato il ripristino di emergenza tra aree.

az iot dps create --name MyDps --resource-group MyResourceGroup --edr

Parametri necessari

--name -n

hub IoT nome del servizio Device Provisioning.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--edr --enforce-data-residency

Applicare la residenza dei dati per questo hub IoT servizio Device Provisioning disabilitando il ripristino di emergenza tra coppie geografiche. Questa proprietà non è modificabile una volta impostata sulla risorsa. Disponibile solo nelle aree selezionate. Per ulteriori informazioni, vedi https://aka.ms/dpsdr.

Valori accettati: false, true
--location -l

Posizione del servizio Device Provisioning hub IoT. Il valore predefinito è il percorso del gruppo di risorse di destinazione.

--sku

Piano tariffario per il servizio Device Provisioning hub IoT.

Valori accettati: S1
Valore predefinito: S1
--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

--unit

Unità nel servizio Device Provisioning hub IoT.

Valore predefinito: 1
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 dps delete

Modifica

Elimina un'istanza del servizio Device Provisioning in hub IoT di Azure.

az iot dps delete [--ids]
                  [--name]
                  [--resource-group]
                  [--subscription]

Esempio

Eliminare un servizio device provisioning hub IoT di Azure 'MyDps'

az iot dps delete --name MyDps --resource-group MyResourceGroup

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--name -n

hub IoT nome del servizio Device Provisioning.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

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

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 dps list

Modifica

Elenca le istanze del servizio Device Provisioning in hub IoT di Azure.

az iot dps list [--resource-group]

Esempio

Elencare tutti i hub IoT di Azure Servizi Device Provisioning in una sottoscrizione.

az iot dps list

Elencare tutti i servizi Device Provisioning hub IoT di Azure nel gruppo di risorse 'MyResourceGroup'

az iot dps list --resource-group MyResourceGroup

Parametri facoltativi

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

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 dps show

Modifica

Ottiene i dettagli di un'istanza del servizio Device Provisioning in hub IoT di Azure.

az iot dps show [--ids]
                [--name]
                [--resource-group]
                [--subscription]

Esempio

Visualizzare i dettagli di un servizio device provisioning hub IoT di Azure 'MyDps'

az iot dps show --name MyDps --resource-group MyResourceGroup

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--name -n

hub IoT nome del servizio Device Provisioning.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

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

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 dps update

Modifica

Aggiorna un'istanza del servizio Device Provisioning in hub IoT di Azure.

az iot dps update [--add]
                  [--force-string]
                  [--ids]
                  [--name]
                  [--remove]
                  [--resource-group]
                  [--set]
                  [--subscription]
                  [--tags]

Esempio

Aggiornare i criteri di allocazione a "GeoLatency" di un servizio device provisioning hub IoT di Azure 'MyDps'

az iot dps update --name MyDps --resource-group MyResourceGroup --set properties.allocationPolicy="GeoLatency"

Parametri facoltativi

--add

Aggiungere un oggetto a un elenco di oggetti specificando un percorso e coppie chiave-valore. Esempio: --add property.listProperty <key=value, string or JSON string>.

Valore predefinito: []
--force-string

Quando si usa 'set' o 'add', mantenere i valori letterali stringa anziché tentare di eseguire la conversione in JSON.

Valore predefinito: False
--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--name -n

hub IoT nome del servizio Device Provisioning.

--remove

Rimuovere una proprietà o un elemento da un elenco. Esempio: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Valore predefinito: []
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--set

Aggiornare un oggetto specificando un percorso di proprietà e un valore da impostare. Esempio: --set property1.property2=<value>.

Valore predefinito: []
--subscription

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

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

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.