az iot device registration

Anteprima
Riferimento

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 device registration . Altre informazioni sulle estensioni.

Questo gruppo di comandi è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Gestire le registrazioni dei dispositivi IoT per il servizio Device Provisioning IoT.

Usare az iot dps enrollment registration o az iot dps enrollment-group registration per visualizzare ed eliminare le registrazioni.

Comandi

Nome	Descrizione	Tipo	Status
az iot device registration create	Registrare un dispositivo IoT con il servizio Device Provisioning IoT.	Estensione	Anteprima

az iot device registration create

Anteprima

Il gruppo di comandi 'iot device registration' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Registrare un dispositivo IoT con il servizio Device Provisioning IoT.

Sono supportati i meccanismi di attestazione seguenti:

Chiave simmetrica
Certificato x509 Se si usano metodi di autenticazione x509, è necessario specificare i file di certificato e di chiave (e passphrase, se necessario).

az iot device registration create --registration-id
                                  [--auth-type {key, login}]
                                  [--certificate-file-path]
                                  [--ck]
                                  [--dps-name]
                                  [--enrollment-group-id]
                                  [--host]
                                  [--id-scope]
                                  [--key]
                                  [--key-file-path]
                                  [--login]
                                  [--pass]
                                  [--payload]
                                  [--resource-group]

Esempio

Registrare un dispositivo IoT usando una registrazione singola.

az iot device registration create -n {dps_name} --rid {registration_id}

Registrare un dispositivo IoT usando una registrazione di gruppo.

az iot device registration create -n {dps_name} --rid {registration_id} --gid {group_enrollment_id}

Registrare un dispositivo IoT usando una registrazione singola, l'ambito ID servizio Device Provisioning e la chiave simmetrica specificata. In questo modo verrà ignorato il recupero dell'ambito ID e della chiave simmetrica di registrazione individale.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --key {symmetric_key}

Registrare un dispositivo IoT usando una registrazione di gruppo, l'ambito ID servizio Device Provisioning e la chiave simmetrica del gruppo di registrazione specificato. In questo modo verrà ignorato il recupero dell'ambito ID e della chiave simmetrica del gruppo di registrazione. La chiave simmetrica usata per la registrazione del dispositivo verrà calcolata dalla chiave simmetrica specificata.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --gid {group_enrollment_id} --key {symmetric_key} --ck

Registrare un dispositivo IoT usando una registrazione di gruppo, l'ambito ID servizio Device Provisioning e la chiave simmetrica specificata. In questo modo verrà ignorato il recupero dell'ambito ID. Si noti che poiché la chiave simmetrica deve essere la chiave del dispositivo calcolata, l'ID del gruppo di registrazione non è necessario.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --key {symmetric_key}

Registrare un dispositivo IoT usando una registrazione singola, l'ambito ID servizio Device Provisioning e i file di certificato e chiave specificati. In questo modo verrà ignorato il recupero dell'ambito ID.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --cp {certificate_file} --kp {key_file}

Registrare un dispositivo IoT usando una registrazione singola, l'ambito ID servizio Device Provisioning e i file di certificato e chiave specificati e la passphrase per il file di chiave. In questo modo verrà ignorato il recupero dell'ambito ID.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --cp {certificate_file} --kp {key_file} --pass {passphrase}

Registrare un dispositivo IoT usando una registrazione di gruppo, l'ambito ID servizio Device Provisioning e i file di certificato e chiave specificati. In questo modo verrà ignorato il recupero dell'ambito ID. Si noti che l'ID di registrazione del gruppo non è necessario per le attestazioni x509 e che l'oggetto del file di certificato è l'ID registrazione.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --cp {certificate_file} --kp {key_file}

Parametri necessari

--registration-id --rid

ID registrazione dispositivo o ID registrazione singola.

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 iothub-data-auth-type=<auth-type-value>.

Valori accettati: key, login

Valore predefinito: key

--certificate-file-path --cp

Percorso del file PEM del certificato. Obbligatorio per le registrazioni x509.

--ck --compute-key

Flag per indicare che la chiave simmetrica per la registrazione del dispositivo deve essere calcolata dalla chiave specificata con --symmetric-key.

Valore predefinito: False

--dps-name -n

Nome del servizio Device Provisioning hub IoT di Azure. Obbligatorio se non vengono specificati argomenti --login o authenticaton e --id-scope non vengono forniti.

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

ID gruppo di registrazione. Solo necessario per recuperare gli argomenti di autenticazione.

--host --provisioning-host

Endpoint che punta all'host di provisioning da usare.

Valore predefinito: global.azure-devices-provisioning.net

--id-scope --scope

Ambito ID del servizio Device Provisioning hub IoT di Azure. Se fornito con argomenti di autenticazione, eviterà l'accesso alla sessione.

--key --symmetric-key

Chiave di accesso condiviso simmetrica per la registrazione del dispositivo.

--key-file-path --kp

Percorso del file PEM della chiave. Obbligatorio per le registrazioni x509.

--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 vengono specificati argomenti --dps-name o authenticaton e --id-scope non vengono forniti.

--pass --passphrase

Passphrase per il certificato.

--payload

Payload di allocazione personalizzato come JSON. In particolare per l'uso con criteri di allocazione personalizzati tramite Funzioni di Azure.

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

Condividi tramite