az iot dps enrollment
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. Přečtěte si další informace o rozšířeních.
Správa jednotlivých registrací zařízení ve službě Azure IoT Hub Device Provisioning
Příkazy
| Name | Description | Typ | Stav |
|---|---|---|---|
| az iot dps enrollment create |
Vytvořte registraci jednotlivých zařízení ve službě Azure IoT Hub Device Provisioning. |
Extension | GA |
| az iot dps enrollment delete |
Odstraňte registraci jednotlivých zařízení ve službě Azure IoT Hub Device Provisioning. |
Extension | GA |
| az iot dps enrollment list |
Výpis jednotlivých registrací zařízení ve službě Azure IoT Hub Device Provisioning |
Extension | GA |
| az iot dps enrollment registration |
Správa registrace zařízení na straně služby pro jednotlivou registraci ve službě Azure IoT Hub Device Provisioning |
Extension | GA |
| az iot dps enrollment registration delete |
Odstraňte registraci zařízení pro jednotlivou registraci ve službě Azure IoT Hub Device Provisioning. |
Extension | GA |
| az iot dps enrollment registration show |
Získejte registraci zařízení pro jednotlivé registrace ve službě Azure IoT Hub Device Provisioning. |
Extension | GA |
| az iot dps enrollment show |
Získejte podrobnosti o registraci jednotlivých zařízení ve službě Azure IoT Hub Device Provisioning. |
Extension | GA |
| az iot dps enrollment update |
Aktualizace registrace jednotlivých zařízení ve službě Azure IoT Hub Device Provisioning |
Extension | GA |
az iot dps enrollment create
Vytvořte registraci jednotlivých zařízení 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 create --at --attestation-type {symmetricKey, tpm, x509}
--eid --enrollment-id
[--acquire-policy-token]
[--allocation-policy --ap {custom, geoLatency, hashed, static}]
[--api-version --av]
[--auth-type {key, login}]
[--certificate-path --cp]
[--change-reference]
[--cpn --credential-policy-name]
[--device-id]
[--device-information --info]
[--dps-name]
[--edge-enabled --ee {false, true}]
[--ek --endorsement-key]
[--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]
[--scp --secondary-certificate-path]
[--secondary-key --sk]
[--webhook-url --wh]
Příklady
Vytvořte registraci {enrollment_id} s typem ověření identity x509 ve službě Azure IoT Device Provisioning {dps_name} ve skupině prostředků {resource_group_name} se stavem zřizování Zakázáno, ID zařízení {device_id}, počátečními vlastnostmi dvojčete {"location":{"region":"US"}}" počáteční značky dvojčete {"version":"1"} a informace o zařízení {"color":"red"}".
az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type x509 --certificate-path /certificates/Certificate.pem --provisioning-status disabled --initial-twin-properties "{'location':{'region':'US'}}" --initial-twin-tags "{'version':'1'}" --device-information "{'color':'red'}" --device-id {device_id}
Vytvořte registraci MyEnrollment s typem ověření identity tpm ve službě Azure IoT Device Provisioning {dps_name} ve skupině prostředků {resource_group_name}.
az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type tpm --endorsement-key 14963E8F3BA5B3984110B3C1CA8E8B89
Vytvořte registraci MyEnrollment s typem ověření identity symetrický klíč ve službě Azure IoT Device Provisioning {dps_name} ve skupině prostředků {resource_group_name}.
az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type symmetrickey --primary-key {primary_key} --secondary-key {secondary_key}
Vytvořte registraci MyEnrollment s opětovným zřízením ve službě Azure IoT Device Provisioning {dps_name} ve skupině prostředků {resource_group_name}.
az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type tpm --reprovision-policy {reprovision_type} --endorsement-key 14963E8F3BA5B3984110B3C1CA8E8B89
Vytvořte registraci MyEnrollment se statickými zásadami přidělování ve službě Azure IoT Device Provisioning {dps_name} ve skupině prostředků {resource_group_name}.
az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type tpm --allocation-policy static --endorsement-key 14963E8F3BA5B3984110B3C1CA8E8B89 --iot-hubs {iot_hub_host_name}
Vytvořte registraci MyEnrollment se zásadami přidělování hodnot hash a několika rozbočovači ve službě Azure IoT Device Provisioning {dps_name} ve skupině prostředků {resource_group_name}.
az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type tpm --allocation-policy hashed --endorsement-key 14963E8F3BA5B3984110B3C1CA8E8B89 --iot-hubs {iot_hub_host_name1} {iot_hub_host_name2}
Vytvoření registrace MyEnrollment se zásadami vlastního přidělení
az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type symmetrickey --allocation-policy custom --webhook-url {webhook_url} --api-version {api_version}
Vytvořte registraci se zadanými vlastními zásadami přihlašovacích údajů oboru názvů ADR.
az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type symmetrickey --credential-policy-name {policy_name}
Povinné parametry
Mechanismus ověření identity, který se používá k ověřování v DPS.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Authentication Arguments |
| Přípustné hodnoty: | symmetricKey, tpm, x509 |
ID registrace jednotlivých 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 |
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 |
Cesta k souboru obsahujícímu primární certifikát. Vyžaduje se při výběru typu ověření x509 a není zadána cesta k sekundárnímu 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 |
ID zařízení zaregistrované v IoT Hub
Volitelné informace o zařízení.
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 |
Ověřovací klíč TPM pro zařízení TPM Při výběru tpm jako typu ověření identity se vyžaduje ověřovací klíč.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Authentication Arguments |
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>.
Cesta k souboru obsahujícímu sekundární certifikát. Vyžaduje se při výběru typu ověření identity x509 a není zadána cesta k primárnímu 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 delete
Odstraňte registraci jednotlivých zařízení ve službě Azure IoT Hub Device Provisioning.
az iot dps enrollment delete --eid --enrollment-id
[--acquire-policy-token]
[--auth-type {key, login}]
[--change-reference]
[--dps-name]
[--etag]
[--login]
[--resource-group]
Povinné parametry
ID registrace jednotlivých 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 |
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 list
Výpis jednotlivých registrací zařízení ve službě Azure IoT Hub Device Provisioning
az iot dps enrollment 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 show
Získejte podrobnosti o registraci jednotlivých zařízení ve službě Azure IoT Hub Device Provisioning.
az iot dps enrollment show --eid --enrollment-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 show --dps-name {dps_name} -g {resource_group} --enrollment-id {enrollment_id}
Zahrnutí úplných informací o ověření identity do výsledků pro registraci symetrického klíče
az iot dps enrollment show --dps-name {dps_name} -g {resource_group} --enrollment-id {symmetric_key_enrollment_id} --show-keys
Povinné parametry
ID registrace jednotlivých 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.
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ů registrace 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 update
Aktualizace registrace jednotlivých zařízení 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 update --eid --enrollment-id
[--acquire-policy-token]
[--allocation-policy --ap {custom, geoLatency, hashed, static}]
[--api-version --av]
[--auth-type {key, login}]
[--certificate-path --cp]
[--change-reference]
[--cpn --credential-policy-name]
[--device-id]
[--device-information --info]
[--dps-name]
[--edge-enabled --ee {false, true}]
[--ek --endorsement-key]
[--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]
[--scp --secondary-certificate-path]
[--secondary-key --sk]
[--webhook-url --wh]
Příklady
Aktualizujte registraci {enrollment_id} novým certifikátem x509 ve službě Azure IoT Device Provisioning {dps_name} ve skupině prostředků {resource_group_name}.
az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --certificate-path /certificates/NewCertificate.pem --etag AAAAAAAAAAA=
Aktualizujte registraci {enrollment_id} novým ověřovacím klíčem ve službě Azure IoT Device Provisioning {dps_name} ve skupině prostředků {resource_group_name}.
az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --endorsement-key 14963E8F3BA5B3984110B3C1CA8E8B89 --etag AAAAAAAAAAA=
Aktualizujte registraci {enrollment_id} novým primárním klíčem ve službě Azure IoT Device Provisioning {dps_name} ve skupině prostředků {resource_group_name}.
az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --primary-key {new_primary_key} --etag AAAAAAAAAAA=
Aktualizujte registraci {enrollment_id} novým typem opětovného zřízení ve službě Azure IoT Device Provisioning {dps_name} ve skupině prostředků {resource_group_name}.
az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --reprovision-policy {reprovision_type} --etag AAAAAAAAAAA=
Aktualizujte registraci {enrollment_id} novou zásadou přidělování ve službě Azure IoT Device Provisioning {dps_name} ve skupině prostředků {resource_group_name}.
az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --allocation-policy geolatency --etag AAAAAAAAAAA= --iot-hubs {iot_hub_host_name1} {iot_hub_host_name2} {iot_hub_host_name3}
Aktualizujte registraci {enrollment_id} ve službě Azure IoT Device Provisioning {dps_name} ve skupině prostředků {resource_group_name} s počátečními vlastnostmi dvojčete {"location":{"region":"USA"}}", počáteční značky dvojčat {"version":"2"} a informace o zařízení {"color": "červená"}".
az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --initial-twin-properties "{'location':{'region':'USA'}}" --initial-twin-tags "{'version1':'2'}" --device-information "{'color':'red'}"
Aktualizujte registraci {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 update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --credential-policy-name {my_policy}
Povinné parametry
ID registrace jednotlivých 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 |
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 |
Cesta k souboru obsahujícímu primární certifikát.
| 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 |
ID zařízení zaregistrované v IoT Hub
Volitelné informace o zařízení.
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 |
Ověřovací klíč TPM pro zařízení TPM
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>.
Cesta k souboru obsahujícímu sekundární certifikát.
| 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 |