az iot dps enrollment

Megjegyzés

Ez a hivatkozás az Azure CLI Azure-iot bővítményének része (2.30.0-s vagy újabb verzió). A bővítmény automatikusan telepíti az az iot dps regisztrációs parancs első futtatásakor. További információ a bővítményekről.

Egyéni eszközregisztrációk kezelése egy Azure IoT Hub Device Provisioning Service-ben.

Parancsok

az iot dps enrollment create

Egyéni eszközregisztráció létrehozása Azure IoT Hub Device Provisioning Service-ben.

az iot dps enrollment delete

Töröljön egy egyéni eszközregisztrációt egy Azure IoT Hub Device Provisioning Service-ben.

az iot dps enrollment list

Az egyes eszközregisztrációk listázása egy Azure IoT Hub Device Provisioning Service-ben.

az iot dps enrollment registration

Szolgáltatásoldali eszközregisztrációk kezelése egyéni regisztrációkhoz egy Azure IoT Hub Device Provisioning Service-ben.

az iot dps enrollment registration delete

Eszközregisztráció törlése egy Azure IoT Hub Device Provisioning Service-ben való egyéni regisztrációhoz.

az iot dps enrollment registration show

Eszközregisztráció kérése egyéni regisztrációhoz egy Azure IoT Hub Device Provisioning Service-ben.

az iot dps enrollment show

Egyéni eszközregisztráció részleteinek lekérése egy Azure IoT Hub Device Provisioning Service-ben.

az iot dps enrollment update

Egyéni eszközregisztráció frissítése egy Azure IoT Hub Device Provisioning Service-ben.

az iot dps enrollment create

Egyéni eszközregisztráció létrehozása Azure IoT Hub Device Provisioning Service-ben.

az iot dps enrollment create --at {symmetricKey, tpm, x509}
                             --eid
                             [--allocation-policy {custom, geoLatency, hashed, static}]
                             [--api-version]
                             [--auth-type {key, login}]
                             [--certificate-path]
                             [--device-id]
                             [--device-information]
                             [--dps-name]
                             [--edge-enabled {false, true}]
                             [--ek]
                             [--hn]
                             [--ih]
                             [--initial-twin-properties]
                             [--initial-twin-tags]
                             [--login]
                             [--pk]
                             [--provisioning-status {disabled, enabled}]
                             [--reprovision-policy {never, reprovisionandmigratedata, reprovisionandresetdata}]
                             [--resource-group]
                             [--scp]
                             [--secondary-key]
                             [--webhook-url]

Példák

Hozzon létre egy "{enrollment_id}" regisztrációt az "x509" igazolási típussal a(z) "{dps_name}" Azure IoT Device Provisioning Service-ben a(z) "{resource_group_name}" erőforráscsoportban, "disabled" kiépítési állapottal, eszközazonosító: "{device_id}", kezdeti ikertulajdonságok: "{"location":{"region":"US"}}", "{"version":"1"}" kezdeti ikercímkék, valamint a(z) "{"color":"red"}" eszközinformációk.

az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type x509 --certificate-path /certificates/Certificate.pem --provisioning-status disabled --initial-twin-properties "{'location':{'region':'US'}}" --initial-twin-tags "{'version':'1'}" --device-info "{'color':'red'}" --device-id {device_id}

Hozzon létre egy "MyEnrollment" regisztrációt "tpm" igazolási típussal a(z) "{dps_name}" Azure IoT Device Provisioning Service-ben a(z) "{resource_group_name}" erőforráscsoportban.

az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type tpm --endorsement-key 14963E8F3BA5B3984110B3C1CA8E8B89

Hozzon létre egy "Szimmetrikus kulcs" igazolástípusú "MyEnrollment" regisztrációt a(z) "{dps_name}" Azure IoT Device Provisioning Service-ben a(z) "{resource_group_name}" erőforráscsoportban.

az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type symmetrickey --primary-key {primary_key} --secondary-key {secondary_key}

Hozzon létre egy "MyEnrollment" regisztrációt a(z) "{resource_group_name}" erőforráscsoportban lévő "{dps_name}" Azure IoT Device Provisioning Service-ben.

az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type tpm --reprovision-policy {reprovision_type} --endorsement-key 14963E8F3BA5B3984110B3C1CA8E8B89

Hozzon létre egy "MyEnrollment" regisztrációt statikus foglalási szabályzattal a(z) "{dps_name}" Azure IoT Device Provisioning Service-ben a(z) "{resource_group_name}" erőforráscsoportban.

az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type tpm --allocation-policy static --endorsement-key 14963E8F3BA5B3984110B3C1CA8E8B89 --iot-hubs {iot_hub_host_name}

Hozzon létre egy "MyEnrollment" regisztrációt kivonatolt foglalási szabályzattal és több központtal a(z) "{dps_name}" Azure IoT Device Provisioning szolgáltatásban a(z) "{resource_group_name}" erőforráscsoportban.

az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type tpm --allocation-policy hashed --endorsement-key 14963E8F3BA5B3984110B3C1CA8E8B89 --iot-hubs "{iot_hub_host_name1} {iot_hub_host_name2}"

Hozzon létre egy "MyEnrollment" regisztrációt egyéni foglalási szabályzattal,

az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type symmetrickey --allocation-policy custom --webhook-url {webhook_url} --api-version {api_version}

Kötelező paraméterek

--at --attestation-type

A DPS-hitelesítéshez használt igazolási mechanizmus.

elfogadott értékek: symmetricKey, tpm, x509
--eid --enrollment-id

Egyéni eszközregisztrációs azonosító.

Opcionális paraméterek

--allocation-policy --ap

A foglalási szabályzat típusa annak meghatározásához, hogy az eszköz hogyan legyen hozzárendelve egy IoT Hub. Ha nincs megadva, a kiosztási szabályzat lesz a Device Provisioning Service-példány aktuális foglalási szabályzatának alapértelmezett beállítása.

elfogadott értékek: custom, geoLatency, hashed, static
--api-version --av

Az egyéni foglalási kérelemben elküldött kiépítési szolgáltatástípusok API-verziója. Minimális támogatott verzió: 2018-09-01-preview.

--auth-type

Azt jelzi, hogy a műveletnek automatikusan le kell-e származtatnia egy szabályzatkulcsot, vagy az aktuális Azure AD munkamenetet kell-e használnia. Az alapértelmezett beállításokat a következővel az configure --defaults iotdps-data-auth-type=<auth-type-value>konfigurálhatja: .

elfogadott értékek: key, login
alapértelmezett érték: key
--certificate-path --cp

Az elsődleges tanúsítványt tartalmazó fájl elérési útja. Az x509 igazolási típus kiválasztásakor szükséges, és a másodlagos tanúsítvány elérési útja nincs megadva.

--device-id -d

A IoT Hub regisztrált eszközazonosító.

--device-information --info

Nem kötelező eszközinformációk.

--dps-name -n

A Azure IoT Hub Device Provisioning Service neve. Kötelező, ha a --login nincs megadva.

--edge-enabled --ee

A peremhálózat engedélyezését jelző jelző.

elfogadott értékek: false, true
--ek --endorsement-key

TPM ellenőrzőkulcs egy TPM-eszközhöz. A tpm igazolási típusként való kiválasztásakor ellenőrzőkulcsra van szükség.

--hn --iot-hub-host-name

A cél IoT Hub állomásneve. A foglalási szabályzat alapértelmezés szerint statikus, ha ez a paraméter meg van adva.

--ih --iot-hubs

A foglalási szabályzathoz társított cél IoT Hub állomásneve. Több IoT Hubhoz használjon szóközzel elválasztott listát.

--initial-twin-properties --props

Az ikereszköz kezdeti tulajdonságai.

--initial-twin-tags --tags

Kezdeti ikereszköz-címkék.

--login -l

Ez a parancs támogatja a művelet végrehajtásához szükséges jogosultságokkal rendelkező entitásokat kapcsolati sztring. Az "az login" használatával elkerülheti a munkamenet-bejelentkezést. Ha egy entitás kapcsolati sztring és a név is meg van adva, a kapcsolati sztring elsőbbséget élvez. Akkor szükséges, ha a --dps-name nincs megadva.

--pk --primary-key

Az elsődleges szimmetrikus közös hozzáférési kulcs, amely base64 formátumban van tárolva.

--provisioning-status --ps

Regisztrációs bejegyzés engedélyezése vagy letiltása.

elfogadott értékek: disabled, enabled
--reprovision-policy --rp

Szabályzat annak meghatározásához, hogyan kell kezelni az eszközadatokat egy másik IoT Hub való újbóli üzembe helyezéssel.

elfogadott értékek: never, reprovisionandmigratedata, reprovisionandresetdata
--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a következővel az configure --defaults group=<name>konfigurálhatja: .

--scp --secondary-certificate-path

A másodlagos tanúsítványt tartalmazó fájl elérési útja. Az x509 igazolási típus kiválasztásakor szükséges, és az elsődleges tanúsítvány elérési útja nincs megadva.

--secondary-key --sk

A másodlagos szimmetrikus közös hozzáférési kulcs, amely base64 formátumban van tárolva.

--webhook-url --wh

Az egyéni foglalási kérelmekhez használt Azure-függvény webhook URL-címe.

az iot dps enrollment delete

Töröljön egy egyéni eszközregisztrációt egy Azure IoT Hub Device Provisioning Service-ben.

az iot dps enrollment delete --eid
                             [--auth-type {key, login}]
                             [--dps-name]
                             [--etag]
                             [--login]
                             [--resource-group]

Kötelező paraméterek

--eid --enrollment-id

Egyéni eszközregisztrációs azonosító.

Opcionális paraméterek

--auth-type

Azt jelzi, hogy a műveletnek automatikusan le kell-e származtatnia egy szabályzatkulcsot, vagy az aktuális Azure AD munkamenetet kell-e használnia. Az alapértelmezett beállításokat a következővel az configure --defaults iotdps-data-auth-type=<auth-type-value>konfigurálhatja: .

elfogadott értékek: key, login
alapértelmezett érték: key
--dps-name -n

A Azure IoT Hub Device Provisioning Service neve. Kötelező, ha a --login nincs megadva.

--etag -e

Az erőforrás utolsó állapotának megfelelő etag vagy entitáscímke. Ha nincs megadva etag, a rendszer a "*" értéket használja.

--login -l

Ez a parancs támogatja a művelet végrehajtásához szükséges jogosultságokkal rendelkező entitásokat kapcsolati sztring. Az "az login" használatával elkerülheti a munkamenet-bejelentkezést. Ha egy entitás kapcsolati sztring és a név is meg van adva, a kapcsolati sztring elsőbbséget élvez. Akkor szükséges, ha a --dps-name nincs megadva.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a következővel az configure --defaults group=<name>konfigurálhatja: .

az iot dps enrollment list

Az egyes eszközregisztrációk listázása egy Azure IoT Hub Device Provisioning Service-ben.

az iot dps enrollment list [--auth-type {key, login}]
                           [--dps-name]
                           [--login]
                           [--resource-group]
                           [--top]

Opcionális paraméterek

--auth-type

Azt jelzi, hogy a műveletnek automatikusan le kell-e származtatnia egy szabályzatkulcsot, vagy az aktuális Azure AD munkamenetet kell-e használnia. Az alapértelmezett beállításokat a következővel az configure --defaults iotdps-data-auth-type=<auth-type-value>konfigurálhatja: .

elfogadott értékek: key, login
alapértelmezett érték: key
--dps-name -n

A Azure IoT Hub Device Provisioning Service neve. Kötelező, ha a --login nincs megadva.

--login -l

Ez a parancs támogatja a művelet végrehajtásához szükséges jogosultságokkal rendelkező entitásokat kapcsolati sztring. Az "az login" használatával elkerülheti a munkamenet-bejelentkezést. Ha egy entitás kapcsolati sztring és a név is meg van adva, a kapcsolati sztring elsőbbséget élvez. Akkor szükséges, ha a --dps-name nincs megadva.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a következővel az configure --defaults group=<name>konfigurálhatja: .

--top

A visszaadandó elemek maximális száma. A -1-et korlátlanul használhatja.

az iot dps enrollment show

Egyéni eszközregisztráció részleteinek lekérése egy Azure IoT Hub Device Provisioning Service-ben.

az iot dps enrollment show --eid
                           [--auth-type {key, login}]
                           [--dps-name]
                           [--keys {false, true}]
                           [--login]
                           [--resource-group]

Példák

Alapvető használat

az iot dps enrollment show --dps-name {dps_name} -g {resource_group} --enrollment-id {enrollment_id}

Teljes igazolási adatok belefoglalása a szimmetrikus kulcsok regisztrálásának eredményeibe

az iot dps enrollment show --dps-name {dps_name} -g {resource_group} --enrollment-id {symmetric_key_enrollment_id} --show-keys

Kötelező paraméterek

--eid --enrollment-id

Egyéni eszközregisztrációs azonosító.

Opcionális paraméterek

--auth-type

Azt jelzi, hogy a műveletnek automatikusan le kell-e származtatnia egy szabályzatkulcsot, vagy az aktuális Azure AD munkamenetet kell-e használnia. Az alapértelmezett beállításokat a következővel az configure --defaults iotdps-data-auth-type=<auth-type-value>konfigurálhatja: .

elfogadott értékek: key, login
alapértelmezett érték: key
--dps-name -n

A Azure IoT Hub Device Provisioning Service neve. Kötelező, ha a --login nincs megadva.

--keys --show-keys

Adja meg az igazolási kulcsokat és az információkat a regisztrációs eredményekben.

elfogadott értékek: false, true
--login -l

Ez a parancs támogatja a művelet végrehajtásához szükséges jogosultságokkal rendelkező entitásokat kapcsolati sztring. Az "az login" használatával elkerülheti a munkamenet-bejelentkezést. Ha egy entitás kapcsolati sztring és a név is meg van adva, a kapcsolati sztring elsőbbséget élvez. Akkor szükséges, ha a --dps-name nincs megadva.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a használatával az configure --defaults group=<name>konfigurálhatja.

az iot dps enrollment update

Egyéni eszközregisztráció frissítése egy Azure IoT Hub Device Provisioning Service-ben.

az iot dps enrollment update --eid
                             [--allocation-policy {custom, geoLatency, hashed, static}]
                             [--api-version]
                             [--auth-type {key, login}]
                             [--certificate-path]
                             [--device-id]
                             [--device-information]
                             [--dps-name]
                             [--edge-enabled {false, true}]
                             [--ek]
                             [--etag]
                             [--hn]
                             [--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]
                             [--scp]
                             [--secondary-key]
                             [--webhook-url]

Példák

Frissítse a(z) "{enrollment_id}" regisztrációt egy új x509-tanúsítvánnyal a(z) "{resource_group_name}" erőforráscsoport "{dps_name}" Azure IoT Device Provisioning Service-ben.

az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --certificate-path /certificates/NewCertificate.pem --etag AAAAAAAAAAA=

Frissítse a(z) "{enrollment_id}" regisztrációt egy új ellenőrző kulccsal a(z) "{dps_name}" Azure IoT Device Provisioning Service-ben a(z) "{resource_group_name}" erőforráscsoportban.

az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --endorsement-key 14963E8F3BA5B3984110B3C1CA8E8B89 --etag AAAAAAAAAAA=

Frissítse a(z) "{enrollment_id}" regisztrációt egy új elsődleges kulccsal a(z) "{resource_group_name}" erőforráscsoport "{dps_name}" Azure IoT Device Provisioning Service-ben.

az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --primary-key {new_primary_key} --etag AAAAAAAAAAA=

Frissítse a(z) "{enrollment_id}" regisztrációt egy új újraépítési típussal a(z) "{dps_name}" Azure IoT Device Provisioning Service-ben a(z) "{resource_group_name}" erőforráscsoportban.

az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --reprovision-policy {reprovision_type} --etag AAAAAAAAAAA=

Frissítse a(z) "{enrollment_id}" regisztrációt egy új foglalási szabályzattal a(z) "{dps_name}" Azure IoT Device Provisioning Service-ben a(z) "{resource_group_name}" erőforráscsoportban.

az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --allocation-policy geolatency --etag AAAAAAAAAAA= --iot-hubs "{iot_hub_host_name1} {iot_hub_host_name2} {iot_hub_host_name3}"

Frissítse a(z) "{enrollment_id}" regisztrációt a(z) "{dps_name}" Azure IoT Device Provisioning Service-ben a(z) "{resource_group_name}" erőforráscsoportban a "{"location":{"region":"USA"}}" kezdeti ikerpéldány-tulajdonságokkal, a "{"version":"2"}" kezdeti ikercímkékkel és a "{"color":"red"}" eszközinformációkkal.

az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --initial-twin-properties "{'location':{'region':'USA'}}" --initial-twin-tags "{'version1':'2'}" --device-info "{'color':'red'}"

Kötelező paraméterek

--eid --enrollment-id

Egyéni eszközregisztrációs azonosító.

Opcionális paraméterek

--allocation-policy --ap

A foglalási szabályzat típusa annak meghatározásához, hogy az eszköz hogyan legyen hozzárendelve egy IoT Hub. Ha nincs megadva, a kiosztási szabályzat lesz a Device Provisioning Service-példány aktuális foglalási szabályzatának alapértelmezett beállítása.

elfogadott értékek: custom, geoLatency, hashed, static
--api-version --av

Az egyéni foglalási kérelemben elküldött kiépítési szolgáltatástípusok API-verziója. Minimális támogatott verzió: 2018-09-01-preview.

--auth-type

Azt jelzi, hogy a műveletnek automatikusan le kell-e származtatnia egy szabályzatkulcsot, vagy az aktuális Azure AD munkamenetet kell-e használnia. Az alapértelmezett beállításokat a használatával az configure --defaults iotdps-data-auth-type=<auth-type-value>konfigurálhatja.

elfogadott értékek: key, login
alapértelmezett érték: key
--certificate-path --cp

Az elsődleges tanúsítványt tartalmazó fájl elérési útja.

--device-id -d

A IoT Hub regisztrált eszközazonosító.

--device-information --info

Nem kötelező eszközinformációk.

--dps-name -n

A Azure IoT Hub Device Provisioning Service neve. Kötelező, ha a --login nincs megadva.

--edge-enabled --ee

Az él engedélyezését jelző jelző.

elfogadott értékek: false, true
--ek --endorsement-key

TPM ellenőrzőkulcs TPM-eszközhöz.

--etag -e

Az erőforrás utolsó állapotának megfelelő etag vagy entitáscímke. Ha nincs megadva etag, a rendszer a "*" értéket használja.

--hn --iot-hub-host-name

A cél IoT Hub állomásneve. A foglalási szabályzat alapértelmezés szerint statikus, ha ez a paraméter meg van adva.

--ih --iot-hubs

A foglalási szabályzathoz társított cél IoT Hub állomásneve. Több IoT Hubhoz használjon szóközzel elválasztott listát.

--initial-twin-properties --props

Kezdeti ikereszköz-tulajdonságok.

--initial-twin-tags --tags

Kezdeti ikereszköz-címkék.

--login -l

Ez a parancs olyan entitásokat támogat, kapcsolati sztring műveletek végrehajtásához szükséges jogosultságokkal. Az "az login" használatával történő munkamenet-bejelentkezés elkerülésére használható. Ha egy entitás kapcsolati sztring és név is meg van adva, a kapcsolati sztring prioritást élvez. Kötelező, ha a --dps-name nincs megadva.

--pk --primary-key

A base64 formátumban tárolt elsődleges szimmetrikus közös hozzáférési kulcs.

--provisioning-status --ps

A regisztrációs bejegyzés engedélyezése vagy letiltása.

elfogadott értékek: disabled, enabled
--rc --remove-certificate

Az aktuális elsődleges tanúsítvány eltávolításának jelzője.

elfogadott értékek: false, true
--remove-secondary-certificate --rsc

Az aktuális másodlagos tanúsítvány eltávolításának jelzője.

elfogadott értékek: false, true
--reprovision-policy --rp

Szabályzat annak meghatározásához, hogy az eszközadatok hogyan legyenek kezelve egy másik IoT Hub újrakiépítése után.

elfogadott értékek: never, reprovisionandmigratedata, reprovisionandresetdata
--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a használatával az configure --defaults group=<name>konfigurálhatja.

--scp --secondary-certificate-path

A másodlagos tanúsítványt tartalmazó fájl elérési útja.

--secondary-key --sk

A base64 formátumban tárolt másodlagos szimmetrikus közös hozzáférési kulcs.

--webhook-url --wh

Az egyéni foglalási kérésekhez használt Azure-függvény webhook URL-címe.