az iot device registration

  • Förhandsgranskning
  • Referens

Kommentar

Den här referensen är en del av azure-iot-tillägget för Azure CLI (version 2.37.0 eller senare). Tillägget installeras automatiskt första gången du kör ett az iot-enhetsregistreringskommando . Läs mer om tillägg.

Den här kommandogruppen är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Hantera IoT-enhetsregistreringar för IoT Device Provisioning Service.

Använd az iot dps enrollment registration eller az iot dps enrollment-group registration för att visa och ta bort registreringar.

Kommandon

Name Description Typ Status
az iot device registration create

Registrera en IoT-enhet med IoT Device Provisioning Service.

 Anknytning Förhandsgranska

az iot device registration create

Förhandsgranskning

Kommandogruppen "iot device registration" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Registrera en IoT-enhet med IoT Device Provisioning Service.

Följande attesteringsmekanismer stöds:

  • Symmetrisk nyckel
  • x509-certifikat Om du använder x509-autentiseringsmetoder måste certifikatet och nyckelfilerna (och lösenfrasen om det behövs) anges.
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]

Exempel

Registrera en IoT-enhet med hjälp av en enskild registrering.

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

Registrera en IoT-enhet med hjälp av en gruppregistrering.

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

Registrera en IoT-enhet med hjälp av en enskild registrering, ID-omfånget för enhetsetableringstjänsten och angiven symmetrisk nyckel. Detta kringgår hämtningen av ID-omfånget och den individuella registreringssymmetriska nyckeln.

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

Registrera en IoT-enhet med hjälp av en gruppregistrering, ID-omfånget för enhetsetableringstjänsten och angiven symmetrisk nyckel för registreringsgrupper. Detta kringgår hämtningen av ID-omfånget och symmetrisk nyckel för registreringsgrupper. Den symmetriska nyckel som används för enhetsregistreringen beräknas från den angivna symmetriska nyckeln.

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

Registrera en IoT-enhet med hjälp av en gruppregistrering, ID-omfånget för Enhetsetableringstjänsten och angiven symmetrisk nyckel. Detta kringgår hämtningen av ID-omfånget. Observera att eftersom den symmetriska nyckeln ska vara den beräknade enhetsnyckeln behövs inte registreringsgruppens ID.

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

Registrera en IoT-enhet med hjälp av en enskild registrering, ID-omfånget för enhetsetableringstjänsten och angivna certifikat- och nyckelfiler. Detta kringgår hämtningen av ID-omfånget.

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

Registrera en IoT-enhet med hjälp av en enskild registrering, ID-omfånget för enhetsetableringstjänsten och angivna certifikat- och nyckelfiler samt lösenfras för nyckelfilen. Detta kringgår hämtningen av ID-omfånget.

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

Registrera en IoT-enhet med hjälp av en gruppregistrering, ID-omfånget för enhetsetableringstjänsten och angivna certifikat- och nyckelfiler. Detta kringgår hämtningen av ID-omfånget. Observera att gruppregistrerings-ID:t inte behövs för x509-attesteringar och certifikatfilens ämne är registrerings-ID: t.

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

Obligatoriska parametrar

--registration-id --rid

Enhetsregistrerings-ID eller individuellt registrerings-ID.

Valfria parametrar

--auth-type

Anger om åtgärden ska automatiskt härleda en principnyckel eller använda den aktuella Azure AD-sessionen. Om autentiseringstypen är inloggning och resursens värdnamn anges hoppas resurssökningen över om det inte behövs. Du kan konfigurera standardinställningen med .az configure --defaults iothub-data-auth-type=<auth-type-value>

accepterade värden: key, login
standardvärde: key
--certificate-file-path --cp

Sökväg till PEM-certifikatfilen. Krävs för x509-registreringar.

--ck --compute-key

Flagga som anger att den symmetriska nyckeln för enhetsregistreringen ska beräknas från den angivna nyckeln med --symmetrisk-nyckel.

standardvärde: False
--dps-name -n

Namnet på Azure IoT Hub Device Provisioning Service. Krävs om --login inte tillhandahålls eller autentiseringsargument och --id-scope inte anges.

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

Registreringsgrupp-ID. Behövs bara för att hämta autentiseringsargument.

--host --provisioning-host

Slutpunkt som pekar på etableringsvärden som ska användas.

standardvärde: global.azure-devices-provisioning.net
--id-scope --scope

Id-omfång för Azure IoT Hub Device Provisioning Service. Om den tillhandahålls med autentiseringsargument undviker du sessionsinloggning.

--key --symmetric-key

Den symmetriska delade åtkomstnyckeln för enhetsregistreringen.

--key-file-path --kp

Sökväg till pem-nyckelfil. Krävs för x509-registreringar.

--login -l

Det här kommandot stöder en entitet anslutningssträng med behörighet att utföra åtgärder. Använd för att undvika sessionsinloggning via "az login". Om både en entitet anslutningssträng och namn anges prioriteras anslutningssträng. Krävs om --dps-name inte har angetts eller om authenticaton-argument och --id-scope inte anges.

--pass --passphrase

Lösenfras för certifikatet.

--payload

Anpassad allokeringsnyttolast som JSON. Specifikt för användning med anpassade allokeringsprinciper med hjälp av Azure Functions.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.