az iot device registration

Preview
Referentie

Notitie

Deze verwijzing maakt deel uit van de Azure-iot-extensie voor de Azure CLI (versie 2.46.0 of hoger). De extensie installeert automatisch de eerste keer dat u een az iot device registration command uitvoert. Meer informatie over extensies.

Deze opdrachtgroep is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

IoT-apparaatregistraties beheren voor de IoT Device Provisioning Service.

Gebruik az iot dps enrollment registration of az iot dps enrollment-group registration verwijder registraties.

Opdracht

Name	Description	Type	Status
az iot device registration create	Registreer een IoT-apparaat bij de IoT Device Provisioning Service.	Toestel	Preview uitvoeren

az iot device registration create

Preview

De opdrachtgroep 'iot-apparaatregistratie' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Registreer een IoT-apparaat bij de IoT Device Provisioning Service.

De volgende attestation-mechanismen worden ondersteund:

Symmetrische sleutel
x509-certificaat Als u x509-verificatiemethoden gebruikt, moeten het certificaat- en sleutelbestanden (en de wachtwoordzin indien nodig) worden opgegeven.

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]

Voorbeelden

Registreer een IoT-apparaat met behulp van een afzonderlijke inschrijving.

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

Registreer een IoT-apparaat met behulp van een groepsinschrijving.

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

Registreer een IoT-apparaat met behulp van een afzonderlijke inschrijving, het Device Provisioning Service ID Scope en de opgegeven symmetrische sleutel. Hiermee wordt het ophalen van het id-bereik en de symmetrische sleutel voor inschrijvingen overgeslagen.

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

Registreer een IoT-apparaat met behulp van een groepsinschrijving, het Device Provisioning Service ID Scope en de opgegeven symmetrische sleutel voor de inschrijvingsgroep. Hierdoor wordt het ophalen van het id-bereik en de symmetrische sleutel van de inschrijvingsgroep overgeslagen. De symmetrische sleutel die wordt gebruikt voor de apparaatregistratie, wordt berekend op basis van de opgegeven symmetrische sleutel.

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

Registreer een IoT-apparaat met behulp van een groepsinschrijving, het Device Provisioning Service-id-bereik en de opgegeven symmetrische sleutel. Hiermee wordt het id-bereik niet opgehaald. Aangezien de symmetrische sleutel de berekende apparaatsleutel moet zijn, is de registratiegroep-id niet nodig.

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

Registreer een IoT-apparaat met behulp van een afzonderlijke inschrijving, het Device Provisioning Service-id-bereik en opgegeven certificaat- en sleutelbestanden. Hiermee wordt het id-bereik niet opgehaald.

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

Registreer een IoT-apparaat met behulp van een afzonderlijke inschrijving, het Device Provisioning Service ID Scope en de opgegeven certificaat- en sleutelbestanden en wachtwoordzin voor het sleutelbestand. Hiermee wordt het id-bereik niet opgehaald.

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

Registreer een IoT-apparaat met behulp van een groepsinschrijving, het Device Provisioning Service-id-bereik en de opgegeven certificaat- en sleutelbestanden. Hiermee wordt het id-bereik niet opgehaald. De groepsinschrijvings-id is niet nodig voor x509-attestations en het onderwerp van het certificaatbestand is de registratie-id.

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

Vereiste parameters

--registration-id --rid

Apparaatregistratie-id of afzonderlijke inschrijvings-id.

Optionele parameters

--auth-type

Hiermee wordt aangegeven of de bewerking automatisch een beleidssleutel moet afleiden of de huidige Azure AD-sessie moet gebruiken. Als het verificatietype aanmelding is en de hostnaam van de resource wordt opgegeven, wordt het opzoeken van resources overgeslagen, tenzij dat nodig is. U kunt de standaardinstelling configureren met behulp van az configure --defaults iothub-data-auth-type=<auth-type-value>.

Geaccepteerde waarden: key, login

Default value: key

--certificate-file-path --cp

Pad naar pem-certificaatbestand. Vereist voor x509-registraties.

--ck --compute-key

Vlag om aan te geven dat de symmetrische sleutel voor de apparaatregistratie moet worden berekend op basis van de opgegeven sleutel met --symmetric-key.

Default value: False

--dps-name -n

Naam van de Azure IoT Hub Device Provisioning Service. Vereist als --login niet is opgegeven of authenticaton-argumenten en --id-scope niet zijn opgegeven.

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

Id van inschrijvingsgroep. Alleen nodig om verificatieargumenten op te halen.

--host --provisioning-host

Eindpunt dat verwijst naar de inrichtingshost die moet worden gebruikt.

Default value: global.azure-devices-provisioning.net

--id-scope --scope

Id-bereik van de Azure IoT Hub Device Provisioning Service. Als er verificatieargumenten worden opgegeven, voorkomt u sessieaanmelding.

--key --symmetric-key

De symmetrische gedeelde toegangssleutel voor de apparaatregistratie.

--key-file-path --kp

Pad naar het PEM-sleutelbestand. Vereist voor x509-registraties.

--login -l

Deze opdracht ondersteunt een entiteit verbindingsreeks met rechten om actie uit te voeren. Gebruik dit om sessieaanmelding te voorkomen via 'az login'. Als zowel een entiteit verbindingsreeks als de naam wordt opgegeven, heeft de verbindingsreeks prioriteit. Vereist als --dps-name niet is opgegeven of authenticaton-argumenten en --id-scope niet is opgegeven.

--pass --passphrase

Wachtwoordzin voor het certificaat.

--payload

Aangepaste nettolading voor toewijzing als JSON. Specifiek voor gebruik met aangepast toewijzingsbeleid met behulp van Azure Functions.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Delen via