Freigeben über


az iot device registration

Hinweis

Diese Referenz ist Teil der Azure-iot-Erweiterung für die Azure CLI (Version 2.46.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen Az iot-Geräteregistrierungsbefehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Diese Befehlsgruppe befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Verwalten Von IoT-Geräteregistrierungen für den IoT-Gerätebereitstellungsdienst.

Dient az iot dps enrollment registration zum az iot dps enrollment-group registration Anzeigen und Löschen von Registrierungen.

Befehle

Name Beschreibung Typ Status
az iot device registration create

Registrieren Sie ein IoT-Gerät beim IoT-Gerätebereitstellungsdienst.

Erweiterung Vorschau

az iot device registration create

Vorschau

Die Befehlsgruppe "iot-Geräteregistrierung" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Registrieren Sie ein IoT-Gerät beim IoT-Gerätebereitstellungsdienst.

Die folgenden Nachweismechanismen werden unterstützt:

  • Symmetrischer Schlüssel
  • x509-Zertifikat Bei Verwendung von x509-Authentifizierungsmethoden müssen die Zertifikat- und Schlüsseldateien (und passphrase bei Bedarf) bereitgestellt werden.
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]

Beispiele

Registrieren Sie ein IoT-Gerät mithilfe einer individuellen Registrierung.

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

Registrieren Sie ein IoT-Gerät mithilfe einer Gruppenregistrierung.

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

Registrieren Sie ein IoT-Gerät mithilfe einer einzelnen Registrierung, des Gerätebereitstellungsdienst-ID-Bereichs und eines symmetrischen Schlüssels. Dadurch wird das Abrufen des ID-Bereichs und des individalen Registrierungssymmetrischen Schlüssels umgangen.

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

Registrieren Sie ein IoT-Gerät mithilfe einer Gruppenregistrierung, des Gerätebereitstellungsdienst-ID-Bereichs und eines symmetrischen Registrierungsgruppenschlüssels. Dadurch wird das Abrufen des ID-Bereichs und des symmetrischen Registrierungsgruppenschlüssels umgangen. Der symmetrische Schlüssel, der für die Geräteregistrierung verwendet wird, wird aus dem angegebenen symmetrischen Schlüssel berechnet.

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

Registrieren Sie ein IoT-Gerät mithilfe einer Gruppenregistrierung, des Gerätebereitstellungsdienst-ID-Bereichs und eines symmetrischen Schlüssels. Dadurch wird das Abrufen des ID-Bereichs umgangen. Beachten Sie, dass die Registrierungsgruppen-ID nicht erforderlich ist, da der symmetrische Schlüssel der berechnete Geräteschlüssel sein sollte.

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

Registrieren Sie ein IoT-Gerät mithilfe einer individuellen Registrierung, des Gerätebereitstellungsdienst-ID-Bereichs und der angegebenen Zertifikat- und Schlüsseldateien. Dadurch wird das Abrufen des ID-Bereichs umgangen.

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

Registrieren Sie ein IoT-Gerät mithilfe einer individuellen Registrierung, des Gerätebereitstellungsdienst-ID-Bereichs und der angegebenen Zertifikat- und Schlüsseldateien und Passphrase für die Schlüsseldatei. Dadurch wird das Abrufen des ID-Bereichs umgangen.

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

Registrieren Sie ein IoT-Gerät mithilfe einer Gruppenregistrierung, des Gerätebereitstellungsdienst-ID-Bereichs und der angegebenen Zertifikat- und Schlüsseldateien. Dadurch wird das Abrufen des ID-Bereichs umgangen. Beachten Sie, dass die Gruppenregistrierungs-ID für x509-Nachweise nicht erforderlich ist und der Betreff der Zertifikatdatei die Registrierungs-ID ist.

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

Erforderliche Parameter

--registration-id --rid

Geräteregistrierungs-ID oder einzelne Registrierungs-ID.

Optionale Parameter

--auth-type

Gibt an, ob der Vorgang einen Richtlinienschlüssel automatisch ableiten oder die aktuelle Azure AD-Sitzung verwenden soll. Wenn der Authentifizierungstyp login ist und der Ressourcenhost bereitgestellt wird, wird die Ressourcensuche übersprungen, es sei denn, dies ist erforderlich. Sie können die Standardeinstellung mithilfe von az configure --defaults iothub-data-auth-type=<auth-type-value>.

Zulässige Werte: key, login
Standardwert: key
--certificate-file-path --cp

Pfad zur PEM-Zertifikatdatei. Erforderlich für x509-Registrierungen.

--ck --compute-key

Kennzeichnen Sie, um anzugeben, dass der symmetrische Schlüssel für die Geräteregistrierung aus dem angegebenen Schlüssel mit --symmetrischem Schlüssel berechnet werden soll.

Standardwert: False
--dps-name -n

Name des Azure IoT Hub-Gerätebereitstellungsdiensts. Erforderlich, wenn --login nicht angegeben oder authenticaton-Argumente und --id-scope nicht bereitgestellt werden.

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

Registrierungsgruppen-ID. Nur zum Abrufen von Authentifizierungsargumenten erforderlich.

--host --provisioning-host

Endpunkt, der auf den zu verwendenden Bereitstellungshost zeigt.

Standardwert: global.azure-devices-provisioning.net
--id-scope --scope

ID-Bereich des Azure IoT Hub-Gerätebereitstellungsdiensts. Wenn sie mit Authentifizierungsargumenten bereitgestellt werden, wird die Sitzungsanmeldung vermieden.

--key --symmetric-key

Der symmetrische gemeinsam genutzte Zugriffsschlüssel für die Geräteregistrierung.

--key-file-path --kp

Pfad zur PEM-Schlüsseldatei. Erforderlich für x509-Registrierungen.

--login -l

Dieser Befehl unterstützt eine Entität Verbindungszeichenfolge mit Rechten zum Ausführen von Aktionen. Wird verwendet, um die Sitzungsanmeldung über "az login" zu vermeiden. Wenn sowohl eine Entität Verbindungszeichenfolge als auch ein Name angegeben werden, hat die Verbindungszeichenfolge Vorrang. Erforderlich, wenn --dps-name nicht angegeben oder authenticaton-Argumente und --id-scope nicht bereitgestellt werden.

--pass --passphrase

Passphrase für das Zertifikat.

--payload

Benutzerdefinierte Zuordnungsnutzlast als JSON. Speziell für die Verwendung mit benutzerdefinierten Zuordnungsrichtlinien mithilfe von Azure Functions.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.