az iot dps enrollment-group
Poznámka:
Tento odkaz je součástí rozšíření azure-iot pro Azure CLI (verze 2.46.0 nebo vyšší). Rozšíření se automaticky nainstaluje při prvním spuštění příkazu az iot dps enrollment-group . Přečtěte si další informace o rozšířeních.
Správa skupin registrací ve službě Azure IoT Hub Device Provisioning
Příkazy
Name | Description | Typ | Stav |
---|---|---|---|
az iot dps enrollment-group compute-device-key |
Vygenerujte odvozený klíč SAS zařízení pro skupinu registrací ve službě Azure IoT Hub Device Provisioning. |
Rozšíření | GA |
az iot dps enrollment-group create |
Vytvořte skupinu registrací ve službě Azure IoT Hub Device Provisioning. |
Rozšíření | GA |
az iot dps enrollment-group delete |
Odstraňte skupinu registrací ve službě Azure IoT Hub Device Provisioning. |
Rozšíření | GA |
az iot dps enrollment-group list |
Výpis skupin registrací ve službě Azure IoT Hub Device Provisioning |
Rozšíření | GA |
az iot dps enrollment-group registration |
Správa registrací zařízení na straně služby pro skupinu registrací ve službě Azure IoT Hub Device Provisioning |
Rozšíření | GA |
az iot dps enrollment-group registration delete |
Odstraňte registraci zařízení pro skupinu registrací ve službě Azure IoT Hub Device Provisioning. |
Rozšíření | GA |
az iot dps enrollment-group registration list |
Výpis registrací zařízení pro skupinu registrací ve službě Azure IoT Hub Device Provisioning |
Rozšíření | GA |
az iot dps enrollment-group registration show |
Získejte registraci zařízení pro skupinu registrací ve službě Azure IoT Hub Device Provisioning. |
Rozšíření | GA |
az iot dps enrollment-group show |
Získejte podrobnosti o skupině registrací ve službě Azure IoT Hub Device Provisioning. |
Rozšíření | GA |
az iot dps enrollment-group update |
Aktualizace skupiny registrací ve službě Azure IoT Hub Device Provisioning |
Rozšíření | GA |
az iot dps enrollment-group compute-device-key
Vygenerujte odvozený klíč SAS zařízení pro skupinu registrací ve službě Azure IoT Hub Device Provisioning.
az iot dps enrollment-group compute-device-key --registration-id
[--auth-type {key, login}]
[--dps-name]
[--eid]
[--key]
[--login]
[--resource-group]
Příklady
Vypočítá klíč zařízení s daným symetrickým klíčem.
az iot dps enrollment-group compute-device-key --key {enrollement_group_symmetric_key} --registration-id {registration_id}
Vypočítá klíč zařízení s danou skupinou registrací.
az iot dps enrollment-group compute-device-key -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --registration-id {registration_id}
Povinné parametry
ID registrace zařízení.
Volitelné parametry
Určuje, jestli má operace automaticky odvodit klíč zásady, nebo použít aktuální relaci Azure AD. Pokud je typ ověřování přihlášení a zadá se název hostitele prostředku, bude vyhledávání prostředků vynecháno, pokud není potřeba. Výchozí nastavení můžete nakonfigurovat pomocí az configure --defaults iotdps-data-auth-type=<auth-type-value>
.
Název nebo název hostitele služby Azure IoT Hub Device Provisioning Vyžaduje se, pokud není zadané --login.
ID skupiny registrací
Symetrický sdílený přístupový klíč pro skupinu registrací. Tento postup obchází registr služby Device Provisioning a vygeneruje token SAS přímo ze zadaného symetrického klíče bez dalšího ověření. Všechny ostatní parametry příkazu kromě ID registrace budou ignorovány.
Tento příkaz podporuje entitu připojovací řetězec s právy k provedení akce. Použijte k tomu, abyste se vyhnuli přihlášení k relaci prostřednictvím příkazu az login. Pokud jsou připojovací řetězec i název entity zadané připojovací řetězec prioritu. Vyžaduje se, pokud není zadaný název --dps-name.
Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>
.
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazují se pouze chyby, potlačení upozornění.
Výstupní formát
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID
.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
az iot dps enrollment-group create
Vytvořte skupinu registrací ve službě Azure IoT Hub Device Provisioning.
Zadejte formát certifikátu pomocí kódování Base64 ASCII a certifikát by měl mít odpovídající segmenty BEGIN a END, například: začněte řetězcem "-----BEGIN CERTIFICATE-----" a končí na "-----END CERTIFICATE-----".
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}]
[--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říklady
Vytvořte skupinu registrací {enrollment_id} ve službě zřizování Azure IoT {dps_name} ve skupině prostředků {resource_group_name} pomocí zprostředkujícího certifikátu jako primárního certifikátu.
az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --certificate-path /certificates/Certificate.pem
Vytvořte skupinu registrací {enrollment_id} ve službě zřizování Azure IoT {dps_name} ve skupině prostředků {resource_group_name} pomocí certifikátu certifikační autority {certificate_name} jako sekundárního certifikátu.
az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --secondary-ca-name {certificate_name}
Vytvořte skupinu registrací {enrollment_id} ve službě zřizování Azure IoT MyDps ve skupině prostředků {resource_group_name} se stavem zřizování povoleno, počátečními vlastnostmi dvojčete {"location":{"region":"US"}} a počátečními značkami dvojčat {"version_dps":"1"}" pomocí zprostředkujícího certifikátu jako primárního certifikátu.
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'}"
Vytvořte skupinu registrací {enrollment_id} ve službě zřizování Azure IoT {dps_name} ve skupině prostředků {resource_group_name} s typem ověření identity symetrický klíč.
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}
Vytvoření skupiny registrací {enrollment_id} pomocí vlastních zásad přidělování
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}
Povinné parametry
ID skupiny registrací
Volitelné parametry
Typ zásady přidělování, které určují, jak se zařízení přiřadí ke službě IoT Hub. Pokud není k dispozici, zásada přidělení bude výchozí aktuální zásadou přidělování nastavenou pro instanci služby Device Provisioning.
Verze rozhraní API typů služby zřizování odesílaných v požadavku na vlastní přidělení. Minimální podporovaná verze: 2018-09-01-preview.
Určuje, jestli má operace automaticky odvodit klíč zásady, nebo použít aktuální relaci Azure AD. Pokud je typ ověřování přihlášení a zadá se název hostitele prostředku, bude vyhledávání prostředků vynecháno, pokud není potřeba. Výchozí nastavení můžete nakonfigurovat pomocí az configure --defaults iotdps-data-auth-type=<auth-type-value>
.
Název primárního kořenového certifikátu certifikační autority. Pokud se vyžaduje ověření identity pomocí kořenového certifikátu certifikační autority, je nutné zadat název kořenové certifikační autority.
Cesta k souboru obsahujícímu primární certifikát. Pokud se vyžaduje ověření pomocí zprostředkujícího certifikátu, musí být zadána cesta k certifikátu.
Název nebo název hostitele služby Azure IoT Hub Device Provisioning Vyžaduje se, pokud není zadané --login.
Příznak označující povolení hraničních zařízení
Název hostitele cílového ioT Hubu přidruženého k zásadám přidělování Pro více ioT Hubů použijte seznam oddělený mezerami.
Počáteční vlastnosti dvojčete zařízení.
Počáteční značky dvojčat zařízení
Tento příkaz podporuje entitu připojovací řetězec s právy k provedení akce. Použijte k tomu, abyste se vyhnuli přihlášení k relaci prostřednictvím příkazu az login. Pokud jsou připojovací řetězec i název entity zadané připojovací řetězec prioritu. Vyžaduje se, pokud není zadaný název --dps-name.
Primární symetrický sdílený přístupový klíč uložený ve formátu base64.
Povolte nebo zakažte položku registrace.
Zásady, které určují, jak se mají data zařízení zpracovávat při opětovném zřízení jiné služby IoT Hub.
Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>
.
Název sekundárního kořenového certifikátu certifikační autority. Pokud se vyžaduje ověření identity pomocí kořenového certifikátu certifikační autority, je nutné zadat název kořenové certifikační autority.
Cesta k souboru obsahujícímu sekundární certifikát. Pokud se vyžaduje ověření pomocí zprostředkujícího certifikátu, musí být zadána cesta k certifikátu.
Sekundární symetrický sdílený přístupový klíč uložený ve formátu base64.
Adresa URL webhooku funkce Azure Functions používaná pro vlastní žádosti o přidělení.
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazují se pouze chyby, potlačení upozornění.
Výstupní formát
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID
.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
az iot dps enrollment-group delete
Odstraňte skupinu registrací ve službě Azure IoT Hub Device Provisioning.
az iot dps enrollment-group delete --eid
[--auth-type {key, login}]
[--dps-name]
[--etag]
[--login]
[--resource-group]
Povinné parametry
ID skupiny registrací
Volitelné parametry
Určuje, jestli má operace automaticky odvodit klíč zásady, nebo použít aktuální relaci Azure AD. Pokud je typ ověřování přihlášení a zadá se název hostitele prostředku, bude vyhledávání prostředků vynecháno, pokud není potřeba. Výchozí nastavení můžete nakonfigurovat pomocí az configure --defaults iotdps-data-auth-type=<auth-type-value>
.
Název nebo název hostitele služby Azure IoT Hub Device Provisioning Vyžaduje se, pokud není zadané --login.
Značka Etag nebo značka entity odpovídající poslednímu stavu prostředku. Pokud není k dispozici žádná značka etag, použije se hodnota *.
Tento příkaz podporuje entitu připojovací řetězec s právy k provedení akce. Použijte k tomu, abyste se vyhnuli přihlášení k relaci prostřednictvím příkazu az login. Pokud jsou připojovací řetězec i název entity zadané připojovací řetězec prioritu. Vyžaduje se, pokud není zadaný název --dps-name.
Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>
.
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazují se pouze chyby, potlačení upozornění.
Výstupní formát
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID
.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
az iot dps enrollment-group list
Výpis skupin registrací ve službě Azure IoT Hub Device Provisioning
az iot dps enrollment-group list [--auth-type {key, login}]
[--dps-name]
[--login]
[--resource-group]
[--top]
Volitelné parametry
Určuje, jestli má operace automaticky odvodit klíč zásady, nebo použít aktuální relaci Azure AD. Pokud je typ ověřování přihlášení a zadá se název hostitele prostředku, bude vyhledávání prostředků vynecháno, pokud není potřeba. Výchozí nastavení můžete nakonfigurovat pomocí az configure --defaults iotdps-data-auth-type=<auth-type-value>
.
Název nebo název hostitele služby Azure IoT Hub Device Provisioning Vyžaduje se, pokud není zadané --login.
Tento příkaz podporuje entitu připojovací řetězec s právy k provedení akce. Použijte k tomu, abyste se vyhnuli přihlášení k relaci prostřednictvím příkazu az login. Pokud jsou připojovací řetězec i název entity zadané připojovací řetězec prioritu. Vyžaduje se, pokud není zadaný název --dps-name.
Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>
.
Maximální počet prvků, které se mají vrátit. Použijte -1 pro neomezenou dobu.
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazují se pouze chyby, potlačení upozornění.
Výstupní formát
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID
.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
az iot dps enrollment-group show
Získejte podrobnosti o skupině registrací ve službě Azure IoT Hub Device Provisioning.
az iot dps enrollment-group show --eid
[--auth-type {key, login}]
[--dps-name]
[--keys {false, true}]
[--login]
[--resource-group]
Příklady
Základní použití
az iot dps enrollment-group show --dps-name {dps_name} -g {resource_group} --enrollment-id {enrollment_id}
Zahrnutí úplných informací o ověření identity do výsledků pro skupinu registrace symetrického klíče
az iot dps enrollment-group show --dps-name {dps_name} -g {resource_group} --enrollment-id {symmetric_key_enrollment_id} --show-keys
Povinné parametry
ID skupiny registrací
Volitelné parametry
Určuje, jestli má operace automaticky odvodit klíč zásady, nebo použít aktuální relaci Azure AD. Pokud je typ ověřování přihlášení a zadá se název hostitele prostředku, bude vyhledávání prostředků vynecháno, pokud není potřeba. Výchozí nastavení můžete nakonfigurovat pomocí az configure --defaults iotdps-data-auth-type=<auth-type-value>
.
Název nebo název hostitele služby Azure IoT Hub Device Provisioning Vyžaduje se, pokud není zadané --login.
Do výsledků skupiny registrací zahrňte klíče a informace o ověření identity.
Tento příkaz podporuje entitu připojovací řetězec s právy k provedení akce. Použijte k tomu, abyste se vyhnuli přihlášení k relaci prostřednictvím příkazu az login. Pokud jsou připojovací řetězec i název entity zadané připojovací řetězec prioritu. Vyžaduje se, pokud není zadaný název --dps-name.
Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>
.
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazují se pouze chyby, potlačení upozornění.
Výstupní formát
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID
.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
az iot dps enrollment-group update
Aktualizace skupiny registrací ve službě Azure IoT Hub Device Provisioning
Zadejte formát certifikátu pomocí kódování Base64 ASCII a certifikát by měl mít odpovídající segmenty BEGIN a END, například: začněte řetězcem "-----BEGIN CERTIFICATE-----" a končí na "-----END CERTIFICATE-----".
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]
[--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říklady
Aktualizujte skupinu registrací {enrollment_id} ve službě zřizování Azure IoT {dps_name} ve skupině prostředků {resource_group_name} s počátečními vlastnostmi dvojčete a počátečními značkami dvojčete.
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=
Aktualizujte skupinu registrací {enrollment_id} ve službě zřizování Azure IoT {dps_name} ve skupině prostředků {resource_group_name} s novým primárním zprostředkujícím certifikátem a odeberte stávající sekundární zprostředkující certifikát.
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=
Aktualizujte skupinu registrací {enrollment_id} ve službě zřizování Azure IoT {dps_name} ve skupině prostředků {resource_group_name} s novým sekundárním certifikátem certifikační autority {certificate_name} a odeberte stávající primární certifikát certifikační autority.
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=
Aktualizujte skupinu registrací {enrollment_id} ve službě zřizování Azure IoT {dps_name} ve skupině prostředků {resource_group_name} s novým primárním klíčem.
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=
Povinné parametry
ID skupiny registrací
Volitelné parametry
Typ zásady přidělování, které určují, jak se zařízení přiřadí ke službě IoT Hub. Pokud není k dispozici, zásada přidělení bude výchozí aktuální zásadou přidělování nastavenou pro instanci služby Device Provisioning.
Verze rozhraní API typů služby zřizování odesílaných v požadavku na vlastní přidělení. Minimální podporovaná verze: 2018-09-01-preview.
Určuje, jestli má operace automaticky odvodit klíč zásady, nebo použít aktuální relaci Azure AD. Pokud je typ ověřování přihlášení a zadá se název hostitele prostředku, bude vyhledávání prostředků vynecháno, pokud není potřeba. Výchozí nastavení můžete nakonfigurovat pomocí az configure --defaults iotdps-data-auth-type=<auth-type-value>
.
Název primárního kořenového certifikátu certifikační autority. Pokud se vyžaduje ověření identity pomocí kořenového certifikátu certifikační autority, je nutné zadat název kořenové certifikační autority.
Cesta k souboru obsahujícímu primární certifikát. Pokud se vyžaduje ověření pomocí zprostředkujícího certifikátu, musí být zadána cesta k certifikátu.
Název nebo název hostitele služby Azure IoT Hub Device Provisioning Vyžaduje se, pokud není zadané --login.
Příznak označující povolení hraničních zařízení
Značka Etag nebo značka entity odpovídající poslednímu stavu prostředku. Pokud není k dispozici žádná značka etag, použije se hodnota *.
Název hostitele cílového ioT Hubu přidruženého k zásadám přidělování Pro více ioT Hubů použijte seznam oddělený mezerami.
Počáteční vlastnosti dvojčete zařízení.
Počáteční značky dvojčat zařízení
Tento příkaz podporuje entitu připojovací řetězec s právy k provedení akce. Použijte k tomu, abyste se vyhnuli přihlášení k relaci prostřednictvím příkazu az login. Pokud jsou připojovací řetězec i název entity zadané připojovací řetězec prioritu. Vyžaduje se, pokud není zadaný název --dps-name.
Primární symetrický sdílený přístupový klíč uložený ve formátu base64.
Povolte nebo zakažte položku registrace.
Příznak pro odebrání aktuálního primárního certifikátu
Příznak pro odebrání aktuálního sekundárního certifikátu
Zásady, které určují, jak se mají data zařízení zpracovávat při opětovném zřízení jiné služby IoT Hub.
Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>
.
Název sekundárního kořenového certifikátu certifikační autority. Pokud se vyžaduje ověření identity pomocí kořenového certifikátu certifikační autority, je nutné zadat název kořenové certifikační autority.
Cesta k souboru obsahujícímu sekundární certifikát. Pokud se vyžaduje ověření pomocí zprostředkujícího certifikátu, musí být zadána cesta k certifikátu.
Sekundární symetrický sdílený přístupový klíč uložený ve formátu base64.
Adresa URL webhooku funkce Azure Functions používaná pro vlastní žádosti o přidělení.
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazují se pouze chyby, potlačení upozornění.
Výstupní formát
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID
.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.