az iot central enrollment-group

Feljegyzés

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

Az IoT Central regisztrációs csoport kezelése és konfigurálása.

Parancsok

Name	Description	Típus	Állapot
az iot central enrollment-group create	Hozzon létre egy regisztrációs csoportot.	Mellék	FE
az iot central enrollment-group delete	Regisztrációs csoport törlése azonosító alapján.	Mellék	FE
az iot central enrollment-group generate-verification-code	Hozzon létre egy ellenőrző kódot egy regisztrációs csoport elsődleges vagy másodlagos x509-tanúsítványához.	Mellék	FE
az iot central enrollment-group list	Az alkalmazás regisztrációs csoportjainak listájának lekérése.	Mellék	FE
az iot central enrollment-group show	A regisztrációs csoport adatainak lekérése azonosító alapján.	Mellék	FE
az iot central enrollment-group update	Regisztrációs csoport frissítése.	Mellék	FE
az iot central enrollment-group verify-certificate	Ellenőrizze egy regisztrációs csoport elsődleges vagy másodlagos x509-tanúsítványát.	Mellék	FE

az iot central enrollment-group create

Hozzon létre egy regisztrációs csoportot.

az iot central enrollment-group create --app-id
                                       --at {symmetricKey, x509}
                                       --display-name
                                       --group-id
                                       --type
                                       [--api-version {2022-06-30-preview, 2022-07-31}]
                                       [--central-api-uri]
                                       [--certificate-path]
                                       [--etag]
                                       [--pk]
                                       [--provisioning-status {disabled, enabled}]
                                       [--scp]
                                       [--secondary-key]
                                       [--token]

Példák

Regisztrációs csoport létrehozása

az iot central enrollment-group create --app-id {appid} --id {enrollmentGroupId} --at {attestation} --display-name {displayName} --type {type}

Regisztrációs csoport létrehozása x509 elsődleges tanúsítvánnyal

az iot central enrollment-group create --app-id {appid} --id {enrollmentGroupId} --at 'x509' --display-name {displayName} --type {type} --cp {primayCertPath}

Regisztrációs csoport létrehozása adott szimmetrikus kulcstanúsítványsal

az iot central enrollment-group create --app-id {appid} --id {enrollmentGroupId} --at 'symmetricKey' --display-name {displayName} --type {type} --pk {primaryKey} --sk {secondaryKey}

Kötelező paraméterek

--app-id -n

A kezelni kívánt IoT Central-alkalmazás alkalmazásazonosítója. Az alkalmazás azonosítóját az alkalmazás "Névjegy" lapján találja a súgómenüben.

--at --attestation-type

A regisztrációs csoport igazolási mechanizmusa. Csak az "x509" vagy a "szimmetrikus Kulcs" engedélyezett. Alapértelmezés szerint a "symmetricKey" lesz használva az igazoláshoz.

Elfogadott értékek: symmetricKey, x509

Alapértelmezett érték: symmetricKey

--display-name

A regisztrációs csoport megjelenítendő neve.

--group-id --id

A regisztrációs csoport egyedi azonosítója.

--type

A csoporton keresztül csatlakozó eszközök típusa.

Opcionális paraméterek

--api-version --av

Elavult

Az "api_version" argumentum elavult, és egy későbbi kiadásban el lesz távolítva.

Ez a parancsparaméter elavult, és figyelmen kívül lesz hagyva. A jövőbeni kiadásban csak a legújabb GA-verziójú IoT Central API-kat támogatjuk. Ha egy API még nem érhető el, a legújabb előzetes verziót hívjuk meg.

Elfogadott értékek: 2022-06-30-preview, 2022-07-31

Alapértelmezett érték: 2022-07-31

--central-api-uri --central-dns-suffix

Az alkalmazáshoz társított IoT Central DNS-utótag.

Alapértelmezett érték: azureiotcentral.com

--certificate-path --cp

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

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

--pk --primary-key

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

--provisioning-status --ps

Azt jelzi, hogy a csoportot használó eszközök csatlakozhatnak-e az IoT Centralhoz. Igaz vagy hamis?

Elfogadott értékek: disabled, enabled

Alapértelmezett érték: enabled

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

--token

Ha a kérést az Azure CLI hitelesítése nélkül szeretné elküldeni, megadhat egy érvényes felhasználói jogkivonatot a kérés hitelesítéséhez. A kérés részeként meg kell adnia a kulcs típusát. További információ: https://aka.ms/iotcentraldocsapi.

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc

Alapértelmezett érték: json

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot central enrollment-group delete

Regisztrációs csoport törlése azonosító alapján.

az iot central enrollment-group delete --app-id
                                       --group-id
                                       [--api-version {2022-06-30-preview, 2022-07-31}]
                                       [--central-api-uri]
                                       [--token]

Példák

Regisztrációs csoport törlése azonosító szerint

az iot central enrollment-group delete --app-id {appid} --id {enrollmentGroupId}

Kötelező paraméterek

--app-id -n

A kezelni kívánt IoT Central-alkalmazás alkalmazásazonosítója. Az alkalmazás azonosítóját az alkalmazás "Névjegy" lapján találja a súgómenüben.

--group-id --id

A regisztrációs csoport egyedi azonosítója.

Opcionális paraméterek

--api-version --av

Elavult

Az "api_version" argumentum elavult, és egy későbbi kiadásban el lesz távolítva.

Ez a parancsparaméter elavult, és figyelmen kívül lesz hagyva. A jövőbeni kiadásban csak a legújabb GA-verziójú IoT Central API-kat támogatjuk. Ha egy API még nem érhető el, a legújabb előzetes verziót hívjuk meg.

Elfogadott értékek: 2022-06-30-preview, 2022-07-31

Alapértelmezett érték: 2022-07-31

--central-api-uri --central-dns-suffix

Az alkalmazáshoz társított IoT Central DNS-utótag.

Alapértelmezett érték: azureiotcentral.com

--token

Ha a kérést az Azure CLI hitelesítése nélkül szeretné elküldeni, megadhat egy érvényes felhasználói jogkivonatot a kérés hitelesítéséhez. A kérés részeként meg kell adnia a kulcs típusát. További információ: https://aka.ms/iotcentraldocsapi.

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc

Alapértelmezett érték: json

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot central enrollment-group generate-verification-code

Hozzon létre egy ellenőrző kódot egy regisztrációs csoport elsődleges vagy másodlagos x509-tanúsítványához.

az iot central enrollment-group generate-verification-code --app-id
                                                           --group-id
                                                           [--api-version {2022-06-30-preview, 2022-07-31}]
                                                           [--central-api-uri]
                                                           [--certificate-entry {primary, secondary}]
                                                           [--token]

Példák

Ellenőrző kód létrehozása egy regisztrációs csoport elsődleges x509-tanúsítványához

az iot central enrollment-group generate-verification-code --app-id {appid} --id {enrollmentGroupId} --entry 'primary'

Kötelező paraméterek

--app-id -n

A kezelni kívánt IoT Central-alkalmazás alkalmazásazonosítója. Az alkalmazás azonosítóját az alkalmazás "Névjegy" lapján találja a súgómenüben.

--group-id --id

A regisztrációs csoport egyedi azonosítója.

Opcionális paraméterek

--api-version --av

Elavult

Az "api_version" argumentum elavult, és egy későbbi kiadásban el lesz távolítva.

Ez a parancsparaméter elavult, és figyelmen kívül lesz hagyva. A jövőbeni kiadásban csak a legújabb GA-verziójú IoT Central API-kat támogatjuk. Ha egy API még nem érhető el, a legújabb előzetes verziót hívjuk meg.

Elfogadott értékek: 2022-06-30-preview, 2022-07-31

Alapértelmezett érték: 2022-07-31

--central-api-uri --central-dns-suffix

Az alkalmazáshoz társított IoT Central DNS-utótag.

Alapértelmezett érték: azureiotcentral.com

--certificate-entry --entry

Az x509-tanúsítvány bejegyzéstípusa, amely csak az "elsődleges" és a "másodlagos" tanúsítványt engedélyezi.

Elfogadott értékek: primary, secondary

--token

Ha a kérést az Azure CLI hitelesítése nélkül szeretné elküldeni, megadhat egy érvényes felhasználói jogkivonatot a kérés hitelesítéséhez. A kérés részeként meg kell adnia a kulcs típusát. További információ: https://aka.ms/iotcentraldocsapi.

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc

Alapértelmezett érték: json

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot central enrollment-group list

Az alkalmazás regisztrációs csoportjainak listájának lekérése.

az iot central enrollment-group list --app-id
                                     [--api-version {2022-06-30-preview, 2022-07-31}]
                                     [--central-api-uri]
                                     [--token]

Példák

Regisztrációs csoportok listájának lekérése egy alkalmazásban

az iot central enrollment-group list --app-id {appid}

Kötelező paraméterek

--app-id -n

A kezelni kívánt IoT Central-alkalmazás alkalmazásazonosítója. Az alkalmazás azonosítóját az alkalmazás "Névjegy" lapján találja a súgómenüben.

Opcionális paraméterek

--api-version --av

Elavult

Az "api_version" argumentum elavult, és egy későbbi kiadásban el lesz távolítva.

Ez a parancsparaméter elavult, és figyelmen kívül lesz hagyva. A jövőbeni kiadásban csak a legújabb GA-verziójú IoT Central API-kat támogatjuk. Ha egy API még nem érhető el, a legújabb előzetes verziót hívjuk meg.

Elfogadott értékek: 2022-06-30-preview, 2022-07-31

Alapértelmezett érték: 2022-07-31

--central-api-uri --central-dns-suffix

Az alkalmazáshoz társított IoT Central DNS-utótag.

Alapértelmezett érték: azureiotcentral.com

--token

Ha a kérést az Azure CLI hitelesítése nélkül szeretné elküldeni, megadhat egy érvényes felhasználói jogkivonatot a kérés hitelesítéséhez. A kérés részeként meg kell adnia a kulcs típusát. További információ: https://aka.ms/iotcentraldocsapi.

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc

Alapértelmezett érték: json

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot central enrollment-group show

A regisztrációs csoport adatainak lekérése azonosító alapján.

az iot central enrollment-group show --app-id
                                     --group-id
                                     [--api-version {2022-06-30-preview, 2022-07-31}]
                                     [--central-api-uri]
                                     [--certificate-entry {primary, secondary}]
                                     [--token]

Példák

Regisztrációs csoport adatainak lekérése azonosító szerint

az iot central enrollment-group show --app-id {appid} --id {enrollmentGroupId}

Kötelező paraméterek

--app-id -n

A kezelni kívánt IoT Central-alkalmazás alkalmazásazonosítója. Az alkalmazás azonosítóját az alkalmazás "Névjegy" lapján találja a súgómenüben.

--group-id --id

A regisztrációs csoport egyedi azonosítója.

Opcionális paraméterek

--api-version --av

Elavult

Az "api_version" argumentum elavult, és egy későbbi kiadásban el lesz távolítva.

Ez a parancsparaméter elavult, és figyelmen kívül lesz hagyva. A jövőbeni kiadásban csak a legújabb GA-verziójú IoT Central API-kat támogatjuk. Ha egy API még nem érhető el, a legújabb előzetes verziót hívjuk meg.

Elfogadott értékek: 2022-06-30-preview, 2022-07-31

Alapértelmezett érték: 2022-07-31

--central-api-uri --central-dns-suffix

Az alkalmazáshoz társított IoT Central DNS-utótag.

Alapértelmezett érték: azureiotcentral.com

--certificate-entry --entry

Az x509-tanúsítvány bejegyzéstípusa, amely csak az "elsődleges" és a "másodlagos" tanúsítványt engedélyezi.

Elfogadott értékek: primary, secondary

--token

Ha a kérést az Azure CLI hitelesítése nélkül szeretné elküldeni, megadhat egy érvényes felhasználói jogkivonatot a kérés hitelesítéséhez. A kérés részeként meg kell adnia a kulcs típusát. További információ: https://aka.ms/iotcentraldocsapi.

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc

Alapértelmezett érték: json

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot central enrollment-group update

Regisztrációs csoport frissítése.

az iot central enrollment-group update --app-id
                                       --group-id
                                       [--api-version {2022-06-30-preview, 2022-07-31}]
                                       [--central-api-uri]
                                       [--certificate-entry {primary, secondary}]
                                       [--certificate-path]
                                       [--display-name]
                                       [--etag]
                                       [--provisioning-status {disabled, enabled}]
                                       [--remove-x509 {false, true}]
                                       [--scp]
                                       [--token]
                                       [--type]

Példák

Regisztrációs csoport frissítése

az iot central enrollment-group update --app-id {appid} --id {enrollmentGroupId} --display-name {displayName} --type {type} --ps {enabled}

X509 elsődleges tanúsítvány eltávolítása egy regisztrációs csoportból

az iot central enrollment-group update --app-id {appid} --id {enrollmentGroupId} --remove-x509 'true' --entry 'primary'

Kötelező paraméterek

--app-id -n

A kezelni kívánt IoT Central-alkalmazás alkalmazásazonosítója. Az alkalmazás azonosítóját az alkalmazás "Névjegy" lapján találja a súgómenüben.

--group-id --id

A regisztrációs csoport egyedi azonosítója.

Opcionális paraméterek

--api-version --av

Elavult

Az "api_version" argumentum elavult, és egy későbbi kiadásban el lesz távolítva.

Ez a parancsparaméter elavult, és figyelmen kívül lesz hagyva. A jövőbeni kiadásban csak a legújabb GA-verziójú IoT Central API-kat támogatjuk. Ha egy API még nem érhető el, a legújabb előzetes verziót hívjuk meg.

Elfogadott értékek: 2022-06-30-preview, 2022-07-31

Alapértelmezett érték: 2022-07-31

--central-api-uri --central-dns-suffix

Az alkalmazáshoz társított IoT Central DNS-utótag.

Alapértelmezett érték: azureiotcentral.com

--certificate-entry --entry

Az x509-tanúsítvány bejegyzéstípusa, amely csak az "elsődleges" és a "másodlagos" tanúsítványt engedélyezi.

Elfogadott értékek: primary, secondary

--certificate-path --cp

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

--display-name

A regisztrációs csoport megjelenítendő neve.

--etag

A regisztrációs csoport frissítéseiben előforduló ütközések megelőzésére szolgáló ETag.

--provisioning-status --ps

Azt jelzi, hogy a csoportot használó eszközök csatlakozhatnak-e az IoT Centralhoz. Igaz vagy hamis?

Elfogadott értékek: disabled, enabled

Alapértelmezett érték: enabled

--remove-x509

Azt jelzi, hogy az x509-tanúsítványt el kell-e távolítani a csoportból. Igaz vagy hamis?

Elfogadott értékek: false, true

--scp --secondary-certificate-path

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

--token

Ha a kérést az Azure CLI hitelesítése nélkül szeretné elküldeni, megadhat egy érvényes felhasználói jogkivonatot a kérés hitelesítéséhez. A kérés részeként meg kell adnia a kulcs típusát. További információ: https://aka.ms/iotcentraldocsapi.

--type

A csoporton keresztül csatlakozó eszközök típusa.

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc

Alapértelmezett érték: json

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot central enrollment-group verify-certificate

Ellenőrizze egy regisztrációs csoport elsődleges vagy másodlagos x509-tanúsítványát.

Ellenőrizze egy regisztrációs csoport elsődleges vagy másodlagos x509-tanúsítványát egy aláírt ellenőrző kóddal rendelkező tanúsítvány megadásával.

Vegye figyelembe, hogy ha egy regisztrációs csoportot nem ellenőrzött x509-tanúsítvánnyal hoztak létre, a parancs használata előtt létre kell hoznia egy ellenőrző tanúsítványt a nem ellenőrzött x509-tanúsítvánnyal és egy ellenőrző kóddal. Az ellenőrző kód a parancssori felületen hozható létre a "enrollment-group generate-verification-code" paranccsal. További információ arról, hogyan hozhat létre ellenőrző tanúsítványokat ellenőrző kóddal a következő helyen https://learn.microsoft.com/en-us/azure/iot-central/core/how-to-connect-devices-x509: .

az iot central enrollment-group verify-certificate --app-id
                                                   --group-id
                                                   [--api-version {2022-06-30-preview, 2022-07-31}]
                                                   [--central-api-uri]
                                                   [--certificate-path]
                                                   [--scp]
                                                   [--token]

Példák

Egy regisztrációs csoport elsődleges x509-tanúsítványának ellenőrzése

az iot central enrollment-group verify-certificate --app-id {appid} --id {enrollmentGroupId} --cp {primayCertPath}

Kötelező paraméterek

--app-id -n

A kezelni kívánt IoT Central-alkalmazás alkalmazásazonosítója. Az alkalmazás azonosítóját az alkalmazás "Névjegy" lapján találja a súgómenüben.

--group-id --id

A regisztrációs csoport egyedi azonosítója.

Opcionális paraméterek

--api-version --av

Elavult

Az "api_version" argumentum elavult, és egy későbbi kiadásban el lesz távolítva.

Ez a parancsparaméter elavult, és figyelmen kívül lesz hagyva. A jövőbeni kiadásban csak a legújabb GA-verziójú IoT Central API-kat támogatjuk. Ha egy API még nem érhető el, a legújabb előzetes verziót hívjuk meg.

Elfogadott értékek: 2022-06-30-preview, 2022-07-31

Alapértelmezett érték: 2022-07-31

--central-api-uri --central-dns-suffix

Az alkalmazáshoz társított IoT Central DNS-utótag.

Alapértelmezett érték: azureiotcentral.com

--certificate-path --cp

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

--scp --secondary-certificate-path

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

--token

Ha a kérést az Azure CLI hitelesítése nélkül szeretné elküldeni, megadhat egy érvényes felhasználói jogkivonatot a kérés hitelesítéséhez. A kérés részeként meg kell adnia a kulcs típusát. További információ: https://aka.ms/iotcentraldocsapi.

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc

Alapértelmezett érték: json

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.