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

--at --attestation-type

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
--eid --enrollment-id

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.

--acquire-policy-token

Získání tokenu Azure Policy automaticky pro tuto operaci prostředku

Vlastnost Hodnota
Skupina parametrů: Global Policy Arguments
--allocation-policy --ap

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
--api-version --av

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

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
--certificate-path --cp

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

Související referenční ID odkazu na změnu pro tuto operaci prostředku.

Vlastnost Hodnota
Skupina parametrů: Global Policy Arguments
--cpn --credential-policy-name

Název zásady přihlašovacích údajů oboru názvů ADR

Vlastnost Hodnota
Skupina parametrů: ADR Credential Policy Arguments
--device-id -d

ID zařízení zaregistrované v IoT Hub

--device-information --info

Volitelné informace o zařízení.

--dps-name -n

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
--edge-enabled --ee

Příznak označující povolení hraničních zařízení

Vlastnost Hodnota
Default value: False
Přípustné hodnoty: false, true
--ek --endorsement-key

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
--ih --iot-hubs

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
--initial-twin-properties --props

Počáteční vlastnosti dvojčete zařízení.

--initial-twin-tags --tags

Počáteční značky dvojčat zařízení

--login -l

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
--pk --primary-key

Primární symetrický sdílený přístupový klíč uložený ve formátu base64.

Vlastnost Hodnota
Skupina parametrů: Authentication Arguments
--provisioning-status --ps

Povolte nebo zakažte položku registrace.

Vlastnost Hodnota
Přípustné hodnoty: disabled, enabled
--reprovision-policy --rp

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
--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--scp --secondary-certificate-path

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
--secondary-key --sk

Sekundární symetrický sdílený přístupový klíč uložený ve formátu base64.

Vlastnost Hodnota
Skupina parametrů: Authentication Arguments
--webhook-url --wh

Adresa URL webhooku funkce Azure použitá pro vlastní žádosti o přidělení.

Vlastnost Hodnota
Skupina parametrů: Allocation Policy Arguments
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

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

--eid --enrollment-id

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.

--acquire-policy-token

Získání tokenu Azure Policy automaticky pro tuto operaci prostředku

Vlastnost Hodnota
Skupina parametrů: Global Policy Arguments
--auth-type

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

Související referenční ID odkazu na změnu pro tuto operaci prostředku.

Vlastnost Hodnota
Skupina parametrů: Global Policy Arguments
--dps-name -n

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

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

--login -l

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
--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

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.

--auth-type

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
--dps-name -n

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

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
--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--top

Maximální počet prvků, které se mají vrátit. Použijte -1 pro neomezenou dobu.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

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

--eid --enrollment-id

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.

--auth-type

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
--dps-name -n

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

Do výsledků registrace zahrňte klíče a informace o ověření identity.

Vlastnost Hodnota
Přípustné hodnoty: false, true
--login -l

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
--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

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

--eid --enrollment-id

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.

--acquire-policy-token

Získání tokenu Azure Policy automaticky pro tuto operaci prostředku

Vlastnost Hodnota
Skupina parametrů: Global Policy Arguments
--allocation-policy --ap

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
--api-version --av

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

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
--certificate-path --cp

Cesta k souboru obsahujícímu primární certifikát.

Vlastnost Hodnota
Skupina parametrů: Authentication Arguments
--change-reference

Související referenční ID odkazu na změnu pro tuto operaci prostředku.

Vlastnost Hodnota
Skupina parametrů: Global Policy Arguments
--cpn --credential-policy-name

Název zásady přihlašovacích údajů oboru názvů ADR

Vlastnost Hodnota
Skupina parametrů: ADR Credential Policy Arguments
--device-id -d

ID zařízení zaregistrované v IoT Hub

--device-information --info

Volitelné informace o zařízení.

--dps-name -n

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
--edge-enabled --ee

Příznak označující povolení hraničních zařízení

Vlastnost Hodnota
Přípustné hodnoty: false, true
--ek --endorsement-key

Ověřovací klíč TPM pro zařízení TPM

--etag -e

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

--ih --iot-hubs

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
--initial-twin-properties --props

Počáteční vlastnosti dvojčete zařízení.

--initial-twin-tags --tags

Počáteční značky dvojčat zařízení

--login -l

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
--pk --primary-key

Primární symetrický sdílený přístupový klíč uložený ve formátu base64.

Vlastnost Hodnota
Skupina parametrů: Authentication Arguments
--provisioning-status --ps

Povolte nebo zakažte položku registrace.

Vlastnost Hodnota
Přípustné hodnoty: disabled, enabled
--rc --remove-certificate

Příznak pro odebrání aktuálního primárního certifikátu

Vlastnost Hodnota
Skupina parametrů: Authentication Arguments
Přípustné hodnoty: false, true
--remove-secondary-certificate --rsc

Příznak pro odebrání aktuálního sekundárního certifikátu

Vlastnost Hodnota
Skupina parametrů: Authentication Arguments
Přípustné hodnoty: false, true
--reprovision-policy --rp

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
--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--scp --secondary-certificate-path

Cesta k souboru obsahujícímu sekundární certifikát.

Vlastnost Hodnota
Skupina parametrů: Authentication Arguments
--secondary-key --sk

Sekundární symetrický sdílený přístupový klíč uložený ve formátu base64.

Vlastnost Hodnota
Skupina parametrů: Authentication Arguments
--webhook-url --wh

Adresa URL webhooku funkce Azure použitá pro vlastní žádosti o přidělení.

Vlastnost Hodnota
Skupina parametrů: Allocation Policy Arguments
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False