Visszajelzés

az iot dps enrollment-group

  • Referencia

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 enrollment-group parancs első futtatásakor. További információ a bővítményekről.

Regisztrációs csoportok kezelése egy Azure IoT Hub Device Provisioning Service-ben.

Parancsok

az iot dps enrollment-group compute-device-key

Származtatott eszköz SAS-kulcs létrehozása egy regisztrációs csoporthoz egy Azure IoT Hub Device Provisioning Service-ben.
az iot dps enrollment-group create

Hozzon létre egy regisztrációs csoportot egy Azure IoT Hub Device Provisioning Service-ben.
az iot dps enrollment-group delete

Regisztrációs csoport törlése egy Azure IoT Hub Device Provisioning Service-ben.
az iot dps enrollment-group list

Regisztrációs csoportok listázása egy Azure IoT Hub Device Provisioning Service-ben.
az iot dps enrollment-group registration

Szolgáltatásoldali eszközregisztrációk kezelése egy regisztrációs csoporthoz egy Azure IoT Hub Device Provisioning Service-ben.
az iot dps enrollment-group registration delete

Eszközregisztráció törlése egy regisztrációs csoporthoz egy Azure IoT Hub Device Provisioning Service-ben.
az iot dps enrollment-group registration list

Egy Azure IoT Hub Device Provisioning Service-ben lévő regisztrációs csoport eszközregisztrációinak listázása.
az iot dps enrollment-group registration show

Eszközregisztráció lekérése egy regisztrációs csoporthoz egy Azure IoT Hub Device Provisioning Service-ben.
az iot dps enrollment-group show

Lekérheti egy regisztrációs csoport adatait egy Azure IoT Hub Device Provisioning Service-ben.
az iot dps enrollment-group update

Frissítsen egy regisztrációs csoportot egy Azure IoT Hub Device Provisioning Service-ben.

az iot dps enrollment-group compute-device-key

Származtatott eszköz SAS-kulcs létrehozása egy regisztrációs csoporthoz egy Azure IoT Hub Device Provisioning Service-ben.

az iot dps enrollment-group compute-device-key --registration-id
                                               [--auth-type {key, login}]
                                               [--dps-name]
                                               [--eid]
                                               [--key]
                                               [--login]
                                               [--resource-group]

Példák

Számítsa ki az eszközkulcsot a megadott szimmetrikus kulccsal.

az iot dps enrollment-group compute-device-key --key {enrollement_group_symmetric_key} --registration-id {registration_id}

Számítsa ki az eszközkulcsot a megadott regisztrációs csoporttal.

az iot dps enrollment-group compute-device-key -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --registration-id {registration_id}

Kötelező paraméterek

--registration-id --rid

Az eszközregisztráció azonosítója.

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.

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

Regisztrációs csoport azonosítója.

--key --symmetric-key

A regisztrációs csoport szimmetrikus közös hozzáférési kulcsa. Ez átadja a Device Provisioning Service beállításjegyzékét, és további ellenőrzés nélkül közvetlenül a megadott szimmetrikus kulcsból hozza létre az SAS-jogkivonatot. A rendszer a regisztrációs azonosítón kívül minden más parancsparamétert figyelmen kívül hagy.

--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-group create

Hozzon létre egy regisztrációs csoportot egy Azure IoT Hub Device Provisioning Service-ben.

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

Példák

Hozzon létre egy {enrollment_id} regisztrációs csoportot a(z) "{dps_name}" Azure IoT kiépítési szolgáltatásban a(z) "{resource_group_name} erőforráscsoportban egy köztes tanúsítvány elsődleges tanúsítványként" használatával.

az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --certificate-path /certificates/Certificate.pem

Hozzon létre egy "{enrollment_id}" regisztrációs csoportot a(z) "{dps_name}" Azure IoT kiépítési szolgáltatásban a(z) "{resource_group_name} erőforráscsoportban egy {certificate_name} hitelesítésszolgáltatói tanúsítvány használatával másodlagos tanúsítványként".

az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --secondary-ca-name {certificate_name}

Hozzon létre egy "{enrollment_id}" regisztrációs csoportot az Azure IoT "MyDps" kiépítési szolgáltatásában a(z) "{resource_group_name}" erőforráscsoportban az "enabled" kiépítési állapottal, a "{"location":{"region":"US"}} kezdeti ikertulajdonságokkal és a {"version_dps":"1"}" kezdeti ikercímkékkel egy köztes tanúsítvány elsődleges tanúsítványként való használatával.

az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --certificate-path /certificates/Certificate.pem --provisioning-status enabled --initial-twin-properties "{'location':{'region':'US'}}" --initial-twin-tags "{'version_dps':'1'}"

Hozzon létre egy "{enrollment_id}" regisztrációs csoportot a(z) "{dps_name}" Azure IoT kiépítési szolgáltatásban a(z) "{resource_group_name}" erőforráscsoportban a "symmetrickey" igazolási típussal.

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

Hozzon létre egy regisztrációs csoportot ({enrollment_id}) egyéni foglalási szabályzattal,

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

Kötelező paraméterek

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

Regisztrációs csoport azonosítója.

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
--ca-name --cn --root-ca-name

Az elsődleges legfelső szintű hitelesítésszolgáltatói tanúsítvány neve. Ha a hitelesítésszolgáltató főtanúsítvánnyal való igazolása szükséges, meg kell adni egy legfelső szintű hitelesítésszolgáltató nevét.

--certificate-path --cp

Az elsődleges tanúsítványt tartalmazó fájl elérési útja. Ha köztes tanúsítvánnyal történő igazolásra van szükség, meg kell adni a tanúsítvány elérési útját.

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

--scn --secondary-ca-name --secondary-root-ca-name

A másodlagos legfelső szintű hitelesítésszolgáltatói tanúsítvány neve. Ha a hitelesítésszolgáltató főtanúsítvánnyal való igazolása szükséges, meg kell adni egy legfelső szintű hitelesítésszolgáltató nevét.

--scp --secondary-certificate-path

A másodlagos tanúsítványt tartalmazó fájl elérési útja. Ha köztes tanúsítvánnyal történő igazolásra van szükség, meg kell adni a tanúsítvány elérési útját.

--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-group delete

Regisztrációs csoport törlése egy Azure IoT Hub Device Provisioning Service-ben.

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

Kötelező paraméterek

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

Regisztrációs csoport azonosítója.

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-group list

Regisztrációs csoportok listázása egy Azure IoT Hub Device Provisioning Service-ben.

az iot dps enrollment-group 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-group show

Lekérheti egy regisztrációs csoport adatait egy Azure IoT Hub Device Provisioning Service-ben.

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

Példák

Alapvető használat

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

Teljes igazolási adatok belefoglalása egy szimmetrikus kulcsregisztrációs csoport eredményeibe

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

Kötelező paraméterek

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

Regisztrációs csoport azonosítója.

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 csoport eredményei között.

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 következővel az configure --defaults group=<name>konfigurálhatja: .

az iot dps enrollment-group update

Frissítsen egy regisztrációs csoportot egy Azure IoT Hub Device Provisioning Service-ben.

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

Példák

Frissítse a(z) "{enrollment_id}" regisztrációs csoportot a(z) "{dps_name}" Azure IoT kiépítési szolgáltatásban a(z) "{resource_group_name}" erőforráscsoportban kezdeti ikertulajdonságokkal és kezdeti ikercímkékkel.

az iot dps enrollment-group update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --initial-twin-properties "{'location':{'region':'USA'}}" --initial-twin-tags "{'version_dps':'2'}" --etag AAAAAAAAAAA=

Frissítse a(z) "{enrollment_id}" regisztrációs csoportot a(z) "{dps_name}" Azure IoT kiépítési szolgáltatásban a(z) "{resource_group_name}" erőforráscsoportban új elsődleges köztes tanúsítvánnyal, és távolítsa el a meglévő másodlagos köztes tanúsítványt.

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

Frissítse a(z) "{enrollment_id}" regisztrációs csoportot a(z) "{dps_name}" Azure IoT kiépítési szolgáltatásban a(z) "{resource_group_name}" erőforráscsoportban új másodlagos hitelesítésszolgáltatói tanúsítvánnyal ({certificate_name}), és távolítsa el a meglévő elsődleges hitelesítésszolgáltatói tanúsítványt.

az iot dps enrollment-group update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --secondary-ca-name {certificate_name} --remove-certificate --etag AAAAAAAAAAA=

Frissítse a(z) "{enrollment_id}" regisztrációs csoportot a(z) "{dps_name}" Azure IoT kiépítési szolgáltatásban a(z) "{resource_group_name}" erőforráscsoportban új elsődleges kulccsal.

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

Kötelező paraméterek

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

Regisztrációs csoport azonosítója.

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
--ca-name --cn --root-ca-name

Az elsődleges legfelső szintű hitelesítésszolgáltatói tanúsítvány neve. Ha a hitelesítésszolgáltató főtanúsítvánnyal való igazolása szükséges, meg kell adni egy legfelső szintű hitelesítésszolgáltató nevét.

--certificate-path --cp

Az elsődleges tanúsítványt tartalmazó fájl elérési útja. Ha köztes tanúsítvánnyal történő igazolásra van szükség, meg kell adni a tanúsítvány elérési útját.

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

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
--rc --remove-certificate

Jelölő az aktuális elsődleges tanúsítvány eltávolításához.

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

Az aktuális másodlagos tanúsítvány eltávolítására jelölő.

elfogadott értékek: false, true
--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: .

--scn --secondary-ca-name --secondary-root-ca-name

A másodlagos legfelső szintű hitelesítésszolgáltatói tanúsítvány neve. Ha a hitelesítésszolgáltató főtanúsítvánnyal való igazolása szükséges, meg kell adni egy legfelső szintű hitelesítésszolgáltató nevét.

--scp --secondary-certificate-path

A másodlagos tanúsítványt tartalmazó fájl elérési útja. Ha köztes tanúsítvánnyal történő igazolásra van szükség, meg kell adni a tanúsítvány elérési útját.

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