az iot hub device-identity

Poznámka:

Tento odkaz je součástí rozšíření azure-iot pro Azure CLI (verze 2.37.0 nebo vyšší). Rozšíření se automaticky nainstaluje při prvním spuštění příkazu az iot hub device-identity . Přečtěte si další informace o rozšířeních.

Správa zařízení IoT

Příkazy

Name	Description	Typ	Stav
az iot hub device-identity children	Správa vztahů podřízených zařízení pro hraniční zařízení IoT	Rozšíření	GA
az iot hub device-identity children add	Přidejte zařízení jako podřízená zařízení do cílového hraničního zařízení.	Rozšíření	GA
az iot hub device-identity children list	Vypíše kolekci přiřazených podřízených zařízení.	Rozšíření	GA
az iot hub device-identity children remove	Odeberte podřízená zařízení z cílového hraničního zařízení.	Rozšíření	GA
az iot hub device-identity connection-string	Správa připojovací řetězec zařízení IoT	Rozšíření	GA
az iot hub device-identity connection-string show	Zobrazí danou připojovací řetězec zařízení IoT Hubu.	Rozšíření	GA
az iot hub device-identity create	Vytvořte zařízení ve službě IoT Hub.	Rozšíření	GA
az iot hub device-identity delete	Odstraňte zařízení IoT Hubu.	Rozšíření	GA
az iot hub device-identity export	Exportujte všechny identity zařízení ze služby IoT Hub do kontejneru objektů blob služby Azure Storage.	Rozšíření	GA
az iot hub device-identity import	Importujte identity zařízení do IoT Hubu z objektu blob kontejneru úložiště.	Rozšíření	GA
az iot hub device-identity list	Zobrazení seznamu zařízení ve službě IoT Hub	Rozšíření	GA
az iot hub device-identity parent	Správa vztahů nadřazených zařízení pro zařízení IoT	Rozšíření	GA
az iot hub device-identity parent set	Nastavte nadřazené zařízení cílového zařízení.	Rozšíření	GA
az iot hub device-identity parent show	Získejte nadřazené zařízení cílového zařízení.	Rozšíření	GA
az iot hub device-identity renew-key	Obnovte cílové klíče zařízení IoT Hubu s ověřováním SAS.	Rozšíření	GA
az iot hub device-identity show	Získejte podrobnosti o zařízení IoT Hubu.	Rozšíření	GA
az iot hub device-identity update	Aktualizujte zařízení IoT Hubu.	Rozšíření	GA

az iot hub device-identity create

Vytvořte zařízení ve službě IoT Hub.

Při použití metody ověřování shared_private_key (označované také jako symetrické klíče), pokud nejsou k dispozici žádné vlastní klíče, služba je pro zařízení vygeneruje.

Pokud je pro hraniční zařízení zadaný obor zařízení, hodnota se automaticky převede na nadřazený obor.

az iot hub device-identity create --device-id
                                  [--am {shared_private_key, x509_ca, x509_thumbprint}]
                                  [--auth-type {key, login}]
                                  [--device-scope]
                                  [--edge-enabled {false, true}]
                                  [--hub-name]
                                  [--login]
                                  [--od]
                                  [--pk]
                                  [--primary-thumbprint]
                                  [--resource-group]
                                  [--secondary-key]
                                  [--secondary-thumbprint]
                                  [--sta {disabled, enabled}]
                                  [--star]
                                  [--valid-days]

Příklady

Vytvoření hraničního zařízení s povolenou službou IoT s výchozí autorizací (sdílený privátní klíč)

az iot hub device-identity create -n {iothub_name} -d {device_id} --ee

Vytvořte zařízení IoT s autorizací certifikátu podepsaného svým držitelem, vygenerujte certifikát platný po dobu 10 dnů a pak použijte kryptografický otisk.

az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_thumbprint --valid-days 10

Vytvořte zařízení IoT s autorizací certifikátu podepsaného svým držitelem, vygenerujte certifikát výchozího vypršení platnosti (365 dnů) a výstup do cílového adresáře.

az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_thumbprint --output-dir /path/to/output

Vytvořte zařízení IoT s autorizací certifikátu podepsaného svým držitelem a explicitně poskytněte primární a sekundární kryptografické otisky.

az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_thumbprint --ptp {thumbprint_1} --stp {thumbprint_2}

Vytvořte zařízení IoT s autorizací kořenové certifikační autority se zakázaným stavem a důvodem.

az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_ca --status disabled --status-reason 'for reasons'

Vytvořte zařízení IoT s oborem zařízení.

az iot hub device-identity create -n {iothub_name} -d {device_id} --device-scope 'ms-azure-iot-edge://edge0-123456789123456789'

Povinné parametry

--device-id -d

ID cílového zařízení.

Volitelné parametry

--am --auth-method

Metoda autorizace, se kterou se entita vytvoří.

přijímané hodnoty: shared_private_key, x509_ca, x509_thumbprint

výchozí hodnota: shared_private_key

--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 iothub-data-auth-type=<auth-type-value>.

přijímané hodnoty: key, login

výchozí hodnota: key

--device-scope

Rozsah zařízení. U hraničních zařízení je to automaticky generované a neměnné. U zařízení typu list nastavte tuto možnost tak, aby se vytvořila podřízená nebo nadřazená relace.

--edge-enabled --ee

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

přijímané hodnoty: false, true

výchozí hodnota: False

--hub-name -n

Název nebo název hostitele služby IoT Hub Vyžaduje se, pokud není zadané --login.

--login -l

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

--od --output-dir

Vygenerujte certifikát podepsaný svým držitelem a použijte jeho kryptografický otisk. Výstup do zadaného cílového adresáře

--pk --primary-key

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

--primary-thumbprint --ptp

Kryptografický otisk certifikátu podepsaný svým držitelem, který se má použít pro primární kryptografický otisk.

--resource-group -g

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

--secondary-key --sk

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

--secondary-thumbprint --stp

Kryptografický otisk certifikátu podepsaný svým držitelem, který se má použít pro sekundární kryptografický otisk.

--sta --status

Po vytvoření nastavte stav zařízení.

přijímané hodnoty: disabled, enabled

výchozí hodnota: enabled

--star --status-reason

Popis stavu zařízení

--valid-days --vd

Vygenerujte certifikát podepsaný svým držitelem a použijte jeho kryptografický otisk. Platné pro zadaný počet dní. Výchozí hodnota: 365.

Globální parametry

--debug

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

--help -h

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

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

výchozí hodnota: json

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

az iot hub device-identity delete

Odstraňte zařízení IoT Hubu.

az iot hub device-identity delete --device-id
                                  [--auth-type {key, login}]
                                  [--etag]
                                  [--hub-name]
                                  [--login]
                                  [--resource-group]

Povinné parametry

--device-id -d

ID cílového zařízení.

Volitelné parametry

--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 iothub-data-auth-type=<auth-type-value>.

přijímané hodnoty: key, login

výchozí hodnota: key

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

--hub-name -n

Název nebo název hostitele služby IoT Hub Vyžaduje se, pokud není zadané --login.

--login -l

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

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

--help -h

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

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

výchozí hodnota: json

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

az iot hub device-identity export

Exportujte všechny identity zařízení ze služby IoT Hub do kontejneru objektů blob služby Azure Storage.

Výstupní objekt blob obsahující identity zařízení je textový soubor s názvem "devices.txt".

Požadovaná oprávnění – Buď zásady sdíleného přístupu služby IoT Hub podporující čtení registru a zápis registru, nebo objekt zabezpečení s rolí Přispěvatel dat služby IoT Hub ve službě IoT Hub.

Název účtu úložiště a parametry názvu kontejneru objektů blob je možné použít pouze v případech, kdy je účet úložiště ve stejném předplatném jako vstupní IoT Hub. Pro vstup identifikátoru URI SAS vloženého kontejneru objektů blob si projděte vstupní pravidla vašeho prostředí.

Další informace najdete na webu https://aka.ms/iothub-device-exportimport.

az iot hub device-identity export [--auth-type {key, login}]
                                  [--bc]
                                  [--bcu]
                                  [--hub-name]
                                  [--identity]
                                  [--ik {false, true}]
                                  [--login]
                                  [--resource-group]
                                  [--sa]

Příklady

Exportujte všechny identity zařízení do nakonfigurovaného kontejneru objektů blob a zahrňte klíče zařízení. Název kontejneru objektů blob a název účtu úložiště se zadají jako parametry příkazu.

az iot hub device-identity export -n {iothub_name} --ik --bc {blob_container_name} --sa {storage_account_name}

Exportujte všechny identity zařízení do nakonfigurovaného kontejneru objektů blob a zahrňte klíče zařízení. Používá příklad vloženého identifikátoru URI SAS.

az iot hub device-identity export -n {iothub_name} --ik --bcu 'https://mystorageaccount.blob.core.windows.net/devices?sv=2019-02-02&st=2020-08-23T22%3A35%3A00Z&se=2020-08-24T22%3A35%3A00Z&sr=c&sp=rwd&sig=VrmJ5sQtW3kLzYg10VqmALGCp4vtYKSLNjZDDJBSh9s%3D'

Exportujte všechny identity zařízení do nakonfigurovaného kontejneru objektů blob pomocí cesty k souboru, který obsahuje identifikátor URI SAS.

az iot hub device-identity export -n {iothub_name} --bcu {sas_uri_filepath}

Exportujte všechny identity zařízení do nakonfigurovaného kontejneru objektů blob a zahrňte klíče zařízení. Používá identitu přiřazenou systémem, která má pro účet úložiště role Přispěvatel dat objektů blob služby Storage. Název kontejneru objektů blob a název účtu úložiště se zadají jako parametry příkazu.

az iot hub device-identity export -n {iothub_name} --ik --bc {blob_container_name} --sa {storage_account_name} --identity [system]

Exportujte všechny identity zařízení do nakonfigurovaného kontejneru objektů blob a zahrňte klíče zařízení. Používá identitu přiřazenou systémem, která má pro účet úložiště role Přispěvatel dat objektů blob služby Storage. Identifikátor URI kontejneru objektů blob nepotřebuje token SAS objektu blob.

az iot hub device-identity export -n {iothub_name} --ik --bcu 'https://mystorageaccount.blob.core.windows.net/devices' --identity [system]

Exportujte všechny identity zařízení do nakonfigurovaného kontejneru objektů blob a zahrňte klíče zařízení. Používá spravovanou identitu přiřazenou uživatelem, která má pro účet úložiště roli Přispěvatel dat objektů blob služby Storage. Název kontejneru objektů blob a název účtu úložiště se zadají jako parametry příkazu.

az iot hub device-identity export -n {iothub_name} --ik --bc {blob_container_name} --sa {storage_account_name} --identity {managed_identity_resource_id}

Exportujte všechny identity zařízení do nakonfigurovaného kontejneru objektů blob a zahrňte klíče zařízení. Používá spravovanou identitu přiřazenou uživatelem, která má pro účet úložiště roli Přispěvatel dat objektů blob služby Storage. Identifikátor URI kontejneru objektů blob nepotřebuje token SAS objektu blob.

az iot hub device-identity export -n {iothub_name} --ik --bcu 'https://mystorageaccount.blob.core.windows.net/devices' --identity {managed_identity_resource_id}

Volitelné parametry

--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 iothub-data-auth-type=<auth-type-value>.

přijímané hodnoty: key, login

výchozí hodnota: key

--bc --blob-container

Tento kontejner objektů blob slouží k výstupu stavu úlohy importu identity zařízení a výsledků. Parametr se při zadání blob_container_uri ignoruje. Pro tento kontejner objektů blob se vyžaduje přístup pro zápis, čtení a odstranění.

--bcu --blob-container-uri

Identifikátor URI sdíleného přístupového podpisu objektu blob se zápisem, čtením a odstraněním přístupu ke kontejneru objektů blob Slouží k výstupu stavu úlohy a výsledků. Poznámka: Při použití ověřování na základě identity se stále vyžaduje identifikátor URI https:// , ale není nutný žádný token SAS. Vstup pro tento argument může být vložený nebo z cesty k souboru.

--hub-name -n

Název nebo název hostitele služby IoT Hub Vyžaduje se, pokud není zadané --login.

--identity

Typ spravované identity k určení, jestli se používá spravovaná identita přiřazená systémem nebo spravovaná identita přiřazená uživatelem. Pro spravovanou identitu přiřazenou systémem použijte [systém]. Pro spravovanou identitu přiřazenou uživatelem zadejte ID prostředku spravované identity přiřazené uživatelem. Tato identita vyžaduje pro účet úložiště role Přispěvatel dat objektů blob úložiště.

--ik --include-keys

Pokud je tato sada nastavená, klíče se exportují normálně. V opačném případě jsou klíče ve výstupu exportu nastaveny na hodnotu null.

přijímané hodnoty: false, true

výchozí hodnota: False

--login -l

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

--resource-group -g

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

--sa --storage-account

Název účtu Azure Storage obsahujícího výstupní kontejner objektů blob. Parametr se při zadání blob_container_uri ignoruje. Vyžaduje se zápis, čtení a odstranění přístupu.

Globální parametry

--debug

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

--help -h

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

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

výchozí hodnota: json

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

az iot hub device-identity import

Importujte identity zařízení do IoT Hubu z objektu blob kontejneru úložiště.

Očekávaný vstupní soubor obsahující identity zařízení by měl mít název "devices.txt". Výstupní soubor protokolu importErrors.log je prázdný, pokud je import úspěšný a obsahuje protokoly chyb v případě selhání importu.

Požadovaná oprávnění – Buď zásady sdíleného přístupu služby IoT Hub podporující čtení registru a zápis registru, nebo objekt zabezpečení s rolí Přispěvatel dat služby IoT Hub ve službě IoT Hub.

Název účtu úložiště a parametry názvu kontejneru objektů blob je možné použít pouze v případech, kdy je účet úložiště ve stejném předplatném jako vstupní IoT Hub. Pro vstup identifikátoru URI SAS vloženého kontejneru objektů blob si projděte vstupní pravidla vašeho prostředí.

Další informace najdete na webu https://aka.ms/iothub-device-exportimport.

az iot hub device-identity import [--auth-type {key, login}]
                                  [--hub-name]
                                  [--ibc]
                                  [--ibcu]
                                  [--identity]
                                  [--input-storage-account]
                                  [--login]
                                  [--obc]
                                  [--obcu]
                                  [--osa]
                                  [--resource-group]

Příklady

Importujte všechny identity zařízení z objektu blob tak, že zadáte parametry příkazů pro vstupní kontejner objektů blob a účet úložiště a také výstupní kontejner objektů blob a účet úložiště.

az iot hub device-identity import -n {iothub_name} --ibc {input_blob_container_name} --isa {input_storage_account_name} --obc {output_blob_container_name} --osa {output_storage_account_name}

Importujte všechny identity zařízení z objektu blob pomocí vloženého identifikátoru URI SAS.

az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri} --obcu {output_sas_uri}

Importujte všechny identity zařízení z objektu blob pomocí cesty k souboru, která obsahuje identifikátor URI SAS.

az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri_filepath} --obcu {output_sas_uri_filepath}

Importujte všechny identity zařízení z objektu blob pomocí identity přiřazené systémem, která má pro oba účty úložiště role Přispěvatel dat objektů blob služby Storage. Vstupní kontejner objektů blob a účet úložiště i výstupní kontejner objektů blob a účet úložiště jsou k dispozici jako parametry příkazu.

az iot hub device-identity import -n {iothub_name} --ibc {input_blob_container_name} --isa {input_storage_account_name} --obc {output_blob_container_name} --osa {output_storage_account_name} --identity [system]

Importujte všechny identity zařízení z objektu blob pomocí identity přiřazené systémem, která má pro oba účty úložiště role Přispěvatel dat objektů blob služby Storage. Identifikátor URI kontejneru objektů blob nepotřebuje token SAS objektu blob.

az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri} --obcu {output_sas_uri} --identity [system]

Importujte všechny identity zařízení z objektu blob pomocí spravované identity přiřazené uživatelem, která má role Přispěvatel dat objektů blob služby Storage pro oba účty úložiště. Vstupní kontejner objektů blob a účet úložiště i výstupní kontejner objektů blob a účet úložiště jsou k dispozici jako parametry příkazu.

az iot hub device-identity import -n {iothub_name} --ibc {input_blob_container_name} --isa {input_storage_account_name} --obc {output_blob_container_name} --osa {output_storage_account_name} --identity {managed_identity_resource_id}

Importujte všechny identity zařízení z objektu blob pomocí spravované identity přiřazené uživatelem, která má role Přispěvatel dat objektů blob služby Storage pro oba účty úložiště. Identifikátor URI kontejneru objektů blob nepotřebuje token SAS objektu blob.

az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri} --obcu {output_sas_uri} --identity {managed_identity_resource_id}

Volitelné parametry

--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 iothub-data-auth-type=<auth-type-value>.

přijímané hodnoty: key, login

výchozí hodnota: key

--hub-name -n

Název nebo název hostitele služby IoT Hub Vyžaduje se, pokud není zadané --login.

--ibc --input-blob-container

Tento kontejner objektů blob ukládá soubor, který definuje operace, které se mají provádět v registru identit. Parametr se při zadání input_blob_container_uri ignoruje. Pro tento kontejner objektů blob se vyžaduje přístup pro čtení.

--ibcu --input-blob-container-uri

Identifikátor URI sdíleného přístupového podpisu objektu blob s přístupem pro čtení ke kontejneru objektů blob Tento objekt blob obsahuje operace, které se mají provést v registru identit. Poznámka: Při použití ověřování na základě identity se stále vyžaduje identifikátor URI https:// , ale není nutný žádný token SAS. Vstup pro tento argument může být vložený nebo z cesty k souboru.

--identity

Typ spravované identity k určení, jestli se používá spravovaná identita přiřazená systémem nebo spravovaná identita přiřazená uživatelem. Pro spravovanou identitu přiřazenou systémem použijte [systém]. Pro spravovanou identitu přiřazenou uživatelem zadejte ID prostředku spravované identity přiřazené uživatelem. Tato identita vyžaduje roli Přispěvatel dat objektů blob úložiště pro cílovou roli účtu úložiště a přispěvatele pro IoT Hub.

--input-storage-account --isa

Název účtu Azure Storage obsahujícího vstupní kontejner objektů blob Vyžaduje se pouze v případě, že není zadaný input_blob_container_uri. Vyžaduje se přístup pro čtení.

--login -l

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

--obc --output-blob-container

Tento kontejner objektů blob slouží k výstupu stavu úlohy importu identity zařízení a výsledků. Vyžaduje se pouze v případě, že není zadaný input_blob_container_uri. Pro tento kontejner objektů blob se vyžaduje přístup k zápisu.

--obcu --output-blob-container-uri

Identifikátor URI sdíleného přístupového podpisu objektu blob s přístupem k zápisu do kontejneru objektů blob Slouží k výstupu stavu úlohy a výsledků. Poznámka: Při použití ověřování na základě identity se stále vyžaduje identifikátor URI https:// bez tokenu SAS. Vstup pro tento argument může být vložený nebo z cesty k souboru.

--osa --output-storage-account

Název účtu Azure Storage obsahujícího výstupní kontejner objektů blob. Parametr se při zadání output_blob_container_uri ignoruje. Vyžaduje se přístup k zápisu.

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

--help -h

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

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

výchozí hodnota: json

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

az iot hub device-identity list

Zobrazení seznamu zařízení ve službě IoT Hub

Tento příkaz je alias pro az iot hub device-twin list, který se důrazně doporučuje pro tento příkaz. V budoucnu může být tento az iot hub device-identity list příkaz změněn nebo zastaralý.

az iot hub device-identity list [--auth-type {key, login}]
                                [--edge-enabled {false, true}]
                                [--hub-name]
                                [--login]
                                [--resource-group]
                                [--top]

Volitelné parametry

--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 iothub-data-auth-type=<auth-type-value>.

přijímané hodnoty: key, login

výchozí hodnota: key

--edge-enabled --ee

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

přijímané hodnoty: false, true

výchozí hodnota: False

--hub-name -n

Název nebo název hostitele služby IoT Hub Vyžaduje se, pokud není zadané --login.

--login -l

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

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

výchozí hodnota: 1000

Globální parametry

--debug

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

--help -h

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

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

výchozí hodnota: json

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

az iot hub device-identity renew-key

Obnovte cílové klíče zařízení IoT Hubu s ověřováním SAS.

az iot hub device-identity renew-key --device-id
                                     --hub-name
                                     --key-type {primary, secondary, swap}
                                     [--auth-type {key, login}]
                                     [--etag]
                                     [--login]
                                     [--resource-group]

Příklady

Obnovte primární klíč.

az iot hub device-identity renew-key -d {device_id} -n {iothub_name} --kt primary

Prohození primárních a sekundárních klíčů

az iot hub device-identity renew-key -d {device_id} -n {iothub_name} --kt swap

Povinné parametry

--device-id -d

ID cílového zařízení.

--hub-name -n

Název nebo název hostitele služby IoT Hub Vyžaduje se, pokud není zadané --login.

--key-type --kt

Cílový typ klíče, který se má znovu vygenerovat.

přijímané hodnoty: primary, secondary, swap

Volitelné parametry

--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 iothub-data-auth-type=<auth-type-value>.

přijímané hodnoty: key, login

výchozí hodnota: key

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

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

--help -h

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

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

výchozí hodnota: json

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

az iot hub device-identity show

Získejte podrobnosti o zařízení IoT Hubu.

az iot hub device-identity show --device-id
                                [--auth-type {key, login}]
                                [--hub-name]
                                [--login]
                                [--resource-group]

Povinné parametry

--device-id -d

ID cílového zařízení.

Volitelné parametry

--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 iothub-data-auth-type=<auth-type-value>.

přijímané hodnoty: key, login

výchozí hodnota: key

--hub-name -n

Název nebo název hostitele služby IoT Hub Vyžaduje se, pokud není zadané --login.

--login -l

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

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

--help -h

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

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

výchozí hodnota: json

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

az iot hub device-identity update

Aktualizujte zařízení IoT Hubu.

K aktualizaci zařízení použijte parametr --set následovaný přiřazením vlastností. Využijte parametry vrácené ze služby Iot Hub device-identity show.

az iot hub device-identity update --device-id
                                  [--add]
                                  [--am {shared_private_key, x509_ca, x509_thumbprint}]
                                  [--auth-type {key, login}]
                                  [--edge-enabled {false, true}]
                                  [--etag]
                                  [--force-string]
                                  [--hub-name]
                                  [--login]
                                  [--pk]
                                  [--primary-thumbprint]
                                  [--remove]
                                  [--resource-group]
                                  [--secondary-key]
                                  [--secondary-thumbprint]
                                  [--set]
                                  [--sta {disabled, enabled}]
                                  [--star]

Příklady

Zapnutí možností edge pro zařízení

az iot hub device-identity update -d {device_id} -n {iothub_name} --set capabilities.iotEdge=true

Zapněte možnosti edge pro zařízení pomocí argumentu pohodlí.

az iot hub device-identity update -d {device_id} -n {iothub_name} --ee

Zakázání stavu zařízení

az iot hub device-identity update -d {device_id} -n {iothub_name} --set status=disabled

Zakažte stav zařízení pomocí argumentu pohodlí.

az iot hub device-identity update -d {device_id} -n {iothub_name} --status disabled

V jednom příkazu

az iot hub device-identity update -d {device_id} -n {iothub_name} --set status=disabled capabilities.iotEdge=true

Povinné parametry

--device-id -d

ID cílového zařízení.

Volitelné parametry

--add

Přidejte objekt do seznamu objektů zadáním párů cest a klíč-hodnota. Příklad: --add property.listProperty <key=value, string or JSON string>.

výchozí hodnota: []

--am --auth-method

Metoda autorizace, se kterou se entita vytvoří.

přijímané hodnoty: shared_private_key, x509_ca, x509_thumbprint

--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 iothub-data-auth-type=<auth-type-value>.

přijímané hodnoty: key, login

výchozí hodnota: key

--edge-enabled --ee

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

přijímané hodnoty: false, true

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

--force-string

Při použití set nebo add zachovávejte řetězcové literály místo pokusu o převod na JSON.

výchozí hodnota: False

--hub-name -n

Název nebo název hostitele služby IoT Hub Vyžaduje se, pokud není zadané --login.

--login -l

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

--pk --primary-key

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

--primary-thumbprint --ptp

Kryptografický otisk certifikátu podepsaný svým držitelem, který se má použít pro primární kryptografický otisk.

--remove

Odeberte vlastnost nebo prvek ze seznamu. Příklad: --remove property.list <indexToRemove> OR --remove propertyToRemove.

výchozí hodnota: []

--resource-group -g

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

--secondary-key --sk

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

--secondary-thumbprint --stp

Kryptografický otisk certifikátu podepsaný svým držitelem, který se má použít pro sekundární kryptografický otisk.

--set

Aktualizujte objekt zadáním cesty vlastnosti a hodnoty, která se má nastavit. Příklad: --set property1.property2=<value>.

výchozí hodnota: []

--sta --status

Po vytvoření nastavte stav zařízení.

přijímané hodnoty: disabled, enabled

--star --status-reason

Popis stavu zařízení

Globální parametry

--debug

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

--help -h

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

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

výchozí hodnota: json

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