az iot dps enrollment-group
Note
Tento odkaz je součástí rozšíření azure-iot pro Azure CLI (verze 2.67.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. |
Extension | GA |
| az iot dps enrollment-group create |
Vytvořte skupinu registrací ve službě Azure IoT Hub Device Provisioning. |
Extension | GA |
| az iot dps enrollment-group delete |
Odstraňte skupinu registrací ve službě Azure IoT Hub Device Provisioning. |
Extension | GA |
| az iot dps enrollment-group list |
Zobrazí seznam skupin registrací ve službě Azure IoT Hub Device Provisioning. |
Extension | 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 |
Extension | GA |
| az iot dps enrollment-group registration delete |
Odstraňte registraci zařízení pro skupinu registrací ve službě Azure IoT Hub Device Provisioning. |
Extension | GA |
| az iot dps enrollment-group registration list |
Výpis registrací zařízení pro skupinu registrací ve službě Azure IoT Hub Device Provisioning. |
Extension | GA |
| az iot dps enrollment-group registration show |
Získejte registraci zařízení pro skupinu registrací ve službě Azure IoT Hub Device Provisioning. |
Extension | GA |
| az iot dps enrollment-group show |
Získejte podrobnosti o skupině registrací ve službě Azure IoT Hub Device Provisioning. |
Extension | GA |
| az iot dps enrollment-group update |
Aktualizujte skupinu registrací ve službě Azure IoT Hub Device Provisioning. |
Extension | 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 --rid
[--acquire-policy-token]
[--auth-type {key, login}]
[--change-reference]
[--dps-name]
[--eid --enrollment-id --gid --group-id]
[--key --symmetric-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
Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.
Získání tokenu Azure Policy automaticky pro tuto operaci prostředku
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Global Policy Arguments |
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}.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Access Control Arguments |
| Default value: | key |
| Přípustné hodnoty: | key, login |
Související referenční ID odkazu na změnu pro tuto operaci prostředku.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Global Policy Arguments |
Název nebo název hostitele služby Azure IoT Hub Device Provisioning. Vyžaduje se, pokud není zadané --login.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Device Provisioning Service Identifier Arguments |
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 connection string 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 je connection string i název entity zadané connection string prioritu. Vyžaduje se, pokud není zadaný název --dps-name.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Device Provisioning Service Identifier Arguments |
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í.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Ř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.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
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 --enrollment-id --gid --group-id
[--acquire-policy-token]
[--allocation-policy --ap {custom, geoLatency, hashed, static}]
[--api-version --av]
[--auth-type {key, login}]
[--ca-name --cn --root-ca-name]
[--certificate-path --cp]
[--change-reference]
[--cpn --credential-policy-name]
[--dps-name]
[--edge-enabled --ee {false, true}]
[--ih --iot-hubs]
[--initial-twin-properties --props]
[--initial-twin-tags --tags]
[--login]
[--pk --primary-key]
[--provisioning-status --ps {disabled, enabled}]
[--reprovision-policy --rp {never, reprovisionandmigratedata, reprovisionandresetdata}]
[--resource-group]
[--scn --secondary-ca-name --secondary-root-ca-name]
[--scp --secondary-certificate-path]
[--secondary-key --sk]
[--webhook-url --wh]
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}
Ve službě Azure IoT zřizování MyDps ve skupině prostředků {resource_group_name} vytvořte skupinu registrací {enrollment_id}, počáteční vlastnosti dvojčete {"location":{"region":"US"}} a počáteční značky 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}
Vytvořte skupinu registrací se zadanými vlastními zásadami přihlašovacích údajů oboru názvů registru zařízení.
az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --allocation-policy hashed --credential-policy-name {policy_name}
Povinné parametry
ID skupiny registrací
Volitelné parametry
Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.
Získání tokenu Azure Policy automaticky pro tuto operaci prostředku
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Global Policy Arguments |
Typ zásady přidělování, které určují, jak je zařízení přiřazeno k 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.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Allocation Policy Arguments |
| Přípustné hodnoty: | custom, geoLatency, hashed, static |
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.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Allocation Policy Arguments |
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}.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Access Control Arguments |
| Default value: | key |
| Přípustné hodnoty: | key, login |
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.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Authentication Arguments |
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.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Authentication Arguments |
Související referenční ID odkazu na změnu pro tuto operaci prostředku.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Global Policy Arguments |
Název zásady přihlašovacích údajů oboru názvů ADR
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | ADR Credential Policy Arguments |
Název nebo název hostitele služby Azure IoT Hub Device Provisioning. Vyžaduje se, pokud není zadané --login.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Device Provisioning Service Identifier Arguments |
Příznak označující povolení hraničních zařízení
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
| Přípustné hodnoty: | false, true |
Název hostitele cílového IoT Hub přidružené k zásadám přidělení. Pro více ioT Hubů použijte seznam oddělený mezerami.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Allocation Policy Arguments |
Počáteční vlastnosti dvojčete zařízení.
Počáteční značky dvojčat zařízení
Tento příkaz podporuje entitu connection string 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 je connection string i název entity zadané connection string prioritu. Vyžaduje se, pokud není zadaný název --dps-name.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Device Provisioning Service Identifier Arguments |
Primární symetrický sdílený přístupový klíč uložený ve formátu base64.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Authentication Arguments |
Povolte nebo zakažte položku registrace.
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | disabled, enabled |
Zásady pro určení způsobu zpracování dat zařízení při opětovném zřízení pro jinou IoT Hub
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | never, reprovisionandmigratedata, reprovisionandresetdata |
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.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Authentication Arguments |
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.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Authentication Arguments |
Sekundární symetrický sdílený přístupový klíč uložený ve formátu base64.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Authentication Arguments |
Adresa URL webhooku funkce Azure použitá pro vlastní žádosti o přidělení.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Allocation Policy Arguments |
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Ř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.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
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 --enrollment-id --gid --group-id
[--acquire-policy-token]
[--auth-type {key, login}]
[--change-reference]
[--dps-name]
[--etag]
[--login]
[--resource-group]
Povinné parametry
ID skupiny registrací
Volitelné parametry
Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.
Získání tokenu Azure Policy automaticky pro tuto operaci prostředku
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Global Policy Arguments |
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}.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Access Control Arguments |
| Default value: | key |
| Přípustné hodnoty: | key, login |
Související referenční ID odkazu na změnu pro tuto operaci prostředku.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Global Policy Arguments |
Název nebo název hostitele služby Azure IoT Hub Device Provisioning. Vyžaduje se, pokud není zadané --login.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Device Provisioning Service Identifier Arguments |
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 connection string 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 je connection string i název entity zadané connection string prioritu. Vyžaduje se, pokud není zadaný název --dps-name.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Device Provisioning Service Identifier Arguments |
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í.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Ř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.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
az iot dps enrollment-group list
Zobrazí seznam 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
Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.
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}.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Access Control Arguments |
| Default value: | key |
| Přípustné hodnoty: | key, login |
Název nebo název hostitele služby Azure IoT Hub Device Provisioning. Vyžaduje se, pokud není zadané --login.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Device Provisioning Service Identifier Arguments |
Tento příkaz podporuje entitu connection string 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 je connection string i název entity zadané connection string prioritu. Vyžaduje se, pokud není zadaný název --dps-name.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Device Provisioning Service Identifier Arguments |
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í.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Ř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.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
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 --enrollment-id --gid --group-id
[--auth-type {key, login}]
[--dps-name]
[--keys --show-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
Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.
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}.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Access Control Arguments |
| Default value: | key |
| Přípustné hodnoty: | key, login |
Název nebo název hostitele služby Azure IoT Hub Device Provisioning. Vyžaduje se, pokud není zadané --login.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Device Provisioning Service Identifier Arguments |
Do výsledků skupiny registrací zahrňte klíče a informace o ověření identity.
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | false, true |
Tento příkaz podporuje entitu connection string 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 je connection string i název entity zadané connection string prioritu. Vyžaduje se, pokud není zadaný název --dps-name.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Device Provisioning Service Identifier Arguments |
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í.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Ř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.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
az iot dps enrollment-group update
Aktualizujte 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 update --eid --enrollment-id --gid --group-id
[--acquire-policy-token]
[--allocation-policy --ap {custom, geoLatency, hashed, static}]
[--api-version --av]
[--auth-type {key, login}]
[--ca-name --cn --root-ca-name]
[--certificate-path --cp]
[--change-reference]
[--cpn --credential-policy-name]
[--dps-name]
[--edge-enabled --ee {false, true}]
[--etag]
[--ih --iot-hubs]
[--initial-twin-properties --props]
[--initial-twin-tags --tags]
[--login]
[--pk --primary-key]
[--provisioning-status --ps {disabled, enabled}]
[--rc --remove-certificate {false, true}]
[--remove-secondary-certificate --rsc {false, true}]
[--reprovision-policy --rp {never, reprovisionandmigratedata, reprovisionandresetdata}]
[--resource-group]
[--scn --secondary-ca-name --secondary-root-ca-name]
[--scp --secondary-certificate-path]
[--secondary-key --sk]
[--webhook-url --wh]
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=
Aktualizujte skupinu registrací {enrollment_id} ve službě Azure IoT Device Provisioning {dps_name}, aby používala vlastní zásady pověření oboru názvů ADR.
az iot dps enrollment-group update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --credential-policy-name {my_policy}
Povinné parametry
ID skupiny registrací
Volitelné parametry
Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.
Získání tokenu Azure Policy automaticky pro tuto operaci prostředku
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Global Policy Arguments |
Typ zásady přidělování, které určují, jak je zařízení přiřazeno k 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.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Allocation Policy Arguments |
| Přípustné hodnoty: | custom, geoLatency, hashed, static |
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.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Allocation Policy Arguments |
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}.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Access Control Arguments |
| Default value: | key |
| Přípustné hodnoty: | key, login |
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.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Authentication Arguments |
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.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Authentication Arguments |
Související referenční ID odkazu na změnu pro tuto operaci prostředku.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Global Policy Arguments |
Název zásady přihlašovacích údajů oboru názvů ADR
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | ADR Credential Policy Arguments |
Název nebo název hostitele služby Azure IoT Hub Device Provisioning. Vyžaduje se, pokud není zadané --login.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Device Provisioning Service Identifier Arguments |
Příznak označující povolení hraničních zařízení
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | false, true |
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 Hub přidružené k zásadám přidělení. Pro více ioT Hubů použijte seznam oddělený mezerami.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Allocation Policy Arguments |
Počáteční vlastnosti dvojčete zařízení.
Počáteční značky dvojčat zařízení
Tento příkaz podporuje entitu connection string 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 je connection string i název entity zadané connection string prioritu. Vyžaduje se, pokud není zadaný název --dps-name.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Device Provisioning Service Identifier Arguments |
Primární symetrický sdílený přístupový klíč uložený ve formátu base64.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Authentication Arguments |
Povolte nebo zakažte položku registrace.
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | disabled, enabled |
Příznak pro odebrání aktuálního primárního certifikátu
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Authentication Arguments |
| Přípustné hodnoty: | false, true |
Příznak pro odebrání aktuálního sekundárního certifikátu
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Authentication Arguments |
| Přípustné hodnoty: | false, true |
Zásady pro určení způsobu zpracování dat zařízení při opětovném zřízení pro jinou IoT Hub
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | never, reprovisionandmigratedata, reprovisionandresetdata |
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.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Authentication Arguments |
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.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Authentication Arguments |
Sekundární symetrický sdílený přístupový klíč uložený ve formátu base64.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Authentication Arguments |
Adresa URL webhooku funkce Azure použitá pro vlastní žádosti o přidělení.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Allocation Policy Arguments |
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Ř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.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |