az iot dps enrollment-group
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 dps enrollment-group . Altre informazioni sulle estensioni.
Gestisce i gruppi di registrazioni in un servizio Device Provisioning in hub IoT di Azure.
Comandi
Nome | Descrizione | Tipo | Status |
---|---|---|---|
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-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.
az iot dps enrollment-group 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 enrollment-group 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 enrollment-group compute-device-key -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --registration-id {registration_id}
Parametri necessari
ID della registrazione del dispositivo.
Parametri facoltativi
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>
.
Nome o nome host del servizio Device Provisioning hub IoT di Azure. Obbligatorio se non viene specificato --login.
ID gruppo di registrazione.
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.
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.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az iot dps enrollment-group create
Creare un gruppo di registrazione in un servizio Device Provisioning hub IoT di Azure.
Specificare il formato certificato usando la codifica ASCII Base64 e il certificato deve avere segmenti BEGIN e END corrispondenti, ad esempio: iniziare con "-----BEGIN CERTIFICATE-----" e terminare con "-----END CERTIFICATE-----".
az iot dps enrollment-group create --eid
[--allocation-policy {custom, geoLatency, hashed, static}]
[--api-version]
[--auth-type {key, login}]
[--ca-name]
[--certificate-path]
[--dps-name]
[--edge-enabled {false, true}]
[--ih]
[--initial-twin-properties]
[--initial-twin-tags]
[--login]
[--pk]
[--provisioning-status {disabled, enabled}]
[--reprovision-policy {never, reprovisionandmigratedata, reprovisionandresetdata}]
[--resource-group]
[--scn]
[--scp]
[--secondary-key]
[--webhook-url]
Esempio
Creare un gruppo di registrazione '{enrollment_id}' nel servizio di provisioning di Azure IoT '{dps_name}' nel gruppo di risorse '{resource_group_name} usando un certificato intermedio come certificato primario'.
az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --certificate-path /certificates/Certificate.pem
Creare un gruppo di registrazione '{enrollment_id}' nel servizio di provisioning di Azure IoT '{dps_name}' nel gruppo di risorse '{resource_group_name} usando un certificato ca {certificate_name} come certificato secondario'.
az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --secondary-ca-name {certificate_name}
Creare un gruppo di registrazione '{enrollment_id}' nel servizio di provisioning di Azure IoT 'MyDps' nel gruppo di risorse '{resource_group_name}' con stato di provisioning 'enabled', proprietà del gemello iniziali '{"location":{"region":"US"}}' e tag gemelli iniziali '{"version_dps":"1"}' usando un certificato intermedio come certificato primario.
az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --certificate-path /certificates/Certificate.pem --provisioning-status enabled --initial-twin-properties "{'location':{'region':'US'}}" --initial-twin-tags "{'version_dps':'1'}"
Creare un gruppo di registrazione '{enrollment_id}' nel servizio di provisioning di Azure IoT '{dps_name}' nel gruppo di risorse '{resource_group_name} con tipo di attestazione 'symmetrickey'.
az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --primary-key {primary_key} --secondary-key {secondary_key}
Creare un gruppo di registrazione '{enrollment_id}' con criteri di allocazione personalizzati,
az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --allocation-policy custom --webhook-url {webhook_url} --api-version {api_version}
Parametri necessari
ID gruppo di registrazione.
Parametri facoltativi
Tipo di criteri di allocazione per determinare la modalità di assegnazione di un dispositivo a un hub IoT. Se non specificato, i criteri di allocazione saranno i criteri di allocazione correnti impostati per l'istanza del servizio Device Provisioning.
Versione API dei tipi di servizio di provisioning inviati nella richiesta di allocazione personalizzata. Versione minima supportata: 2018-09-01-preview.
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>
.
Nome del certificato CA radice primario. Se è necessario specificare un'attestazione con un certificato CA radice, è necessario specificare un nome ca radice.
Percorso del file contenente il certificato primario. Se l'attestazione con un certificato intermedio è desiderata, è necessario specificare un percorso del certificato.
Nome o nome host del servizio Device Provisioning hub IoT di Azure. Obbligatorio se non viene specificato --login.
Flag che indica l'abilitazione dei bordi.
Nome host del hub IoT di destinazione associato ai criteri di allocazione. Usare un elenco delimitato da spazi per più hub IoT.
Proprietà iniziali del dispositivo gemello.
Tag iniziali del dispositivo gemello.
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.
Chiave di accesso condiviso simmetrica primaria archiviata in formato Base64.
Abilitare o disabilitare la voce di registrazione.
Criteri per determinare il modo in cui i dati del dispositivo devono essere gestiti al nuovo provisioning in un hub IoT diverso.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
Nome del certificato CA radice secondario. Se è necessario specificare un'attestazione con un certificato CA radice, è necessario specificare un nome ca radice.
Percorso del file contenente il certificato secondario. Se l'attestazione con un certificato intermedio è desiderata, è necessario specificare un percorso del certificato.
Chiave di accesso condiviso simmetrica secondaria archiviata in formato Base64.
URL webhook della funzione di Azure usato per le richieste di allocazione personalizzate.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az iot dps enrollment-group delete
Eliminare un gruppo di registrazione in un servizio Device Provisioning hub IoT di Azure.
az iot dps enrollment-group delete --eid
[--auth-type {key, login}]
[--dps-name]
[--etag]
[--login]
[--resource-group]
Parametri necessari
ID gruppo di registrazione.
Parametri facoltativi
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>
.
Nome o nome host del servizio Device Provisioning hub IoT di Azure. Obbligatorio se non viene specificato --login.
Tag Etag o tag di entità corrispondente all'ultimo stato della risorsa. Se non viene specificato alcun etag, viene usato il valore '*'.
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.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az iot dps enrollment-group list
Elencare i gruppi di registrazioni in un servizio device provisioning di hub IoT di Azure.
az iot dps enrollment-group list [--auth-type {key, login}]
[--dps-name]
[--login]
[--resource-group]
[--top]
Parametri facoltativi
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>
.
Nome o nome host del servizio Device Provisioning hub IoT di Azure. Obbligatorio se non viene specificato --login.
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.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
Numero massimo di elementi da restituire. Usare -1 per un numero illimitato.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az iot dps enrollment-group show
Ottenere i dettagli di un gruppo di registrazione in un servizio Device Provisioning hub IoT di Azure.
az iot dps enrollment-group show --eid
[--auth-type {key, login}]
[--dps-name]
[--keys {false, true}]
[--login]
[--resource-group]
Esempio
Utilizzo di base
az iot dps enrollment-group show --dps-name {dps_name} -g {resource_group} --enrollment-id {enrollment_id}
Includere informazioni complete sull'attestazione nei risultati per un gruppo di registrazioni con chiave simmetrica
az iot dps enrollment-group show --dps-name {dps_name} -g {resource_group} --enrollment-id {symmetric_key_enrollment_id} --show-keys
Parametri necessari
ID gruppo di registrazione.
Parametri facoltativi
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>
.
Nome o nome host del servizio Device Provisioning hub IoT di Azure. Obbligatorio se non viene specificato --login.
Includere le chiavi di attestazione e le informazioni nei risultati del gruppo di registrazione.
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.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az iot dps enrollment-group update
Aggiornare un gruppo di registrazione in un servizio Device Provisioning hub IoT di Azure.
Specificare il formato certificato usando la codifica ASCII Base64 e il certificato deve avere segmenti BEGIN e END corrispondenti, ad esempio: iniziare con "-----BEGIN CERTIFICATE-----" e terminare con "-----END CERTIFICATE-----".
az iot dps enrollment-group update --eid
[--allocation-policy {custom, geoLatency, hashed, static}]
[--api-version]
[--auth-type {key, login}]
[--ca-name]
[--certificate-path]
[--dps-name]
[--edge-enabled {false, true}]
[--etag]
[--ih]
[--initial-twin-properties]
[--initial-twin-tags]
[--login]
[--pk]
[--provisioning-status {disabled, enabled}]
[--rc {false, true}]
[--remove-secondary-certificate {false, true}]
[--reprovision-policy {never, reprovisionandmigratedata, reprovisionandresetdata}]
[--resource-group]
[--scn]
[--scp]
[--secondary-key]
[--webhook-url]
Esempio
Aggiornare il gruppo di registrazione '{enrollment_id}' nel servizio di provisioning di Azure IoT '{dps_name}' nel gruppo di risorse '{resource_group_name}' con le proprietà iniziali dei dispositivi gemelli e i tag iniziali dei gemelli.
az iot dps enrollment-group update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --initial-twin-properties "{'location':{'region':'USA'}}" --initial-twin-tags "{'version_dps':'2'}" --etag AAAAAAAAAAA=
Aggiornare il gruppo di registrazione '{enrollment_id}' nel servizio di provisioning di Azure IoT '{dps_name}' nel gruppo di risorse '{resource_group_name}' con nuovo certificato intermedio primario e rimuovere il certificato intermedio secondario esistente.
az iot dps enrollment-group update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --certificate-path /certificates/NewCertificate.pem --remove-secondary-certificate --etag AAAAAAAAAAA=
Aggiornare il gruppo di registrazione '{enrollment_id}' nel servizio di provisioning di Azure IoT '{dps_name}' nel gruppo di risorse '{resource_group_name}' con nuovo certificato CA secondario '{certificate_name}' e rimuovere il certificato CA primario esistente.
az iot dps enrollment-group update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --secondary-ca-name {certificate_name} --remove-certificate --etag AAAAAAAAAAA=
Aggiornare il gruppo di registrazione '{enrollment_id}' nel servizio di provisioning di Azure IoT '{dps_name}' nel gruppo di risorse '{resource_group_name}' con nuova chiave primaria.
az iot dps enrollment-group update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --primary-key {new_primary_key} --etag AAAAAAAAAAA=
Parametri necessari
ID gruppo di registrazione.
Parametri facoltativi
Tipo di criteri di allocazione per determinare la modalità di assegnazione di un dispositivo a un hub IoT. Se non specificato, i criteri di allocazione saranno i criteri di allocazione correnti impostati per l'istanza del servizio Device Provisioning.
Versione API dei tipi di servizio di provisioning inviati nella richiesta di allocazione personalizzata. Versione minima supportata: 2018-09-01-preview.
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>
.
Nome del certificato CA radice primario. Se è necessario specificare un'attestazione con un certificato CA radice, è necessario specificare un nome ca radice.
Percorso del file contenente il certificato primario. Se l'attestazione con un certificato intermedio è desiderata, è necessario specificare un percorso del certificato.
Nome o nome host del servizio Device Provisioning hub IoT di Azure. Obbligatorio se non viene specificato --login.
Flag che indica l'abilitazione dei bordi.
Tag Etag o tag di entità corrispondente all'ultimo stato della risorsa. Se non viene specificato alcun etag, viene usato il valore '*'.
Nome host del hub IoT di destinazione associato ai criteri di allocazione. Usare un elenco delimitato da spazi per più hub IoT.
Proprietà iniziali del dispositivo gemello.
Tag iniziali del dispositivo gemello.
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.
Chiave di accesso condiviso simmetrica primaria archiviata in formato Base64.
Abilitare o disabilitare la voce di registrazione.
Flag per rimuovere il certificato primario corrente.
Flag per rimuovere il certificato secondario corrente.
Criteri per determinare il modo in cui i dati del dispositivo devono essere gestiti al nuovo provisioning in un hub IoT diverso.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
Nome del certificato CA radice secondario. Se è necessario specificare un'attestazione con un certificato CA radice, è necessario specificare un nome ca radice.
Percorso del file contenente il certificato secondario. Se l'attestazione con un certificato intermedio è desiderata, è necessario specificare un percorso del certificato.
Chiave di accesso condiviso simmetrica secondaria archiviata in formato Base64.
URL webhook della funzione di Azure usato per le richieste di allocazione personalizzate.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.