Megosztás a következőn keresztül:

az iot du update

  • Referencia

Feljegyzés

Ez a hivatkozás az Azure CLI azure-iot bővítményének része (2.46.0-s vagy újabb verzió). A bővítmény automatikusan telepíti az az iot du update parancs első futtatásakor. További információ a bővítményekről.

Eszközfrissítések frissítésének kezelése.

Parancsok

Name Description Típus Állapot
az iot du update calculate-hash

Egy fájl alap64 kivonatolt ábrázolásának kiszámítása.

 Mellék FE
az iot du update delete

Adott frissítési verzió törlése.

 Mellék FE
az iot du update file

Fájlműveletek frissítése.

 Mellék FE
az iot du update file list

A frissítési fájlazonosítók listázása a frissítésszolgáltató, a név és a verzió tekintetében.

 Mellék FE
az iot du update file show

Egy adott frissítési fájl részleteinek megjelenítése a frissítésszolgáltatóra, a névre és a verzióra vonatkozóan.

 Mellék FE
az iot du update import

Importáljon egy új frissítési verziót az Eszközfrissítés példányba.

 Mellék FE
az iot du update init

Segédprogram az importálási jegyzék inicializálásához.

 Mellék Előnézet
az iot du update init v5

Inicializáljon egy v5-ös importálási jegyzékfájlt a kívánt állapottal.

 Mellék Előnézet
az iot du update list

Listázhatja az eszközfrissítési példányba importált frissítéseket.

 Mellék FE
az iot du update show

Adott frissítési verzió megjelenítése.

 Mellék FE
az iot du update stage

Frissítés előkészítése egy célpéldányba való importáláshoz.

 Mellék Előnézet

az iot du update calculate-hash

Egy fájl alap64 kivonatolt ábrázolásának kiszámítása.

az iot du update calculate-hash --file-path
                                [--hash-algo {sha256}]

Példák

Kiszámíthatja egy célfrissítési fájl sha256-kivonatának alap64-ábrázolását.

az iot du update calculate-hash --file-path /path/to/file

Kiszámíthatja egy sha256-kivonat alap64-ábrázolását több célfrissítési fájlhoz.

az iot du update calculate-hash --file-path /path/to/file1 --file-path /path/to/file2 --file-path /path/to/file3

Kötelező paraméterek

--file-path -f

A kivonatszámítás célfájljának helyi elérési útja. A --file-path 1 vagy több alkalommal használható.

Opcionális paraméterek

--hash-algo

Kivonatoláshoz használandó titkosítási algoritmus.

Elfogadott értékek: sha256
Alapértelmezett érték: sha256
Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
Alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot du update delete

Adott frissítési verzió törlése.

az iot du update delete --account
                        --instance
                        --un
                        --up
                        --update-version
                        [--no-wait]
                        [--resource-group]
                        [--yes {false, true}]

Példák

Törölje a célfrissítést a frissítésszolgáltató, a név és a verzió tekintetében.

az iot du update delete -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name} --update-version {update_version}

Kötelező paraméterek

--account -n

Eszközfrissítési fiók neve. Az alapértelmezett fióknevet a következővel az config set defaults.adu_account=<name>konfigurálhatja: .

--instance -i

Eszközfrissítési példány neve. Az alapértelmezett példánynevet a következővel az config set defaults.adu_instance=<name>konfigurálhatja: .

--un --update-name

A frissítés neve.

--up --update-provider

A frissítésszolgáltató.

--update-version --uv

A frissítés verziója.

Opcionális paraméterek

--no-wait

Ne várja meg, amíg a hosszú ideig futó művelet befejeződik.

Alapértelmezett érték: False
--resource-group -g

Eszközfrissítési fiók erőforráscsoportjának neve. Az alapértelmezett csoportot konfigurálhatja a következővel az config set defaults.adu_group=<name>: .

--yes -y

Felhasználói kérések kihagyása. A művelet elfogadását jelzi. Elsősorban automatizálási forgatókönyvekhez használatos. Alapértelmezett érték: false (hamis).

Elfogadott értékek: false, true
Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
Alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot du update import

Importáljon egy új frissítési verziót az Eszközfrissítés példányba.

Ez a parancs támogatja a képességet --defer . Használat esetén a parancs egy helyi gyorsítótárban tárolja az Azure-ba küldendő hasznos adatokat. A parancs következő használata nélkül --defer az új kérés hasznos adatai a gyorsítótárazott objektumokkal együtt lesznek elküldve.

Sikeresség esetén a megfelelő helyi gyorsítótár-bejegyzés törlődik. Ha hiba történik, a gyorsítótárazott tartalom nem lesz eltávolítva. Parancsokkal az cache egymástól függetlenül kezelheti a helyi gyorsítótár bejegyzéseit.

A halasztási támogatás elsősorban a több referencialépéssel rendelkező frissítésekre vonatkozik, így a szülő- és gyermekfrissítések együttesen is beküldhetők.

az iot du update import --account
                        --instance
                        --url
                        [--defer]
                        [--file]
                        [--friendly-name]
                        [--hashes]
                        [--no-wait]
                        [--resource-group]
                        [--size]

Példák

Importálja a frissítést két kapcsolódó fájllal, hivatkozási lépések nélkül, és explicit módon adja meg a jegyzékkivonat értékét és a jegyzék méretét bájtban.

az iot du update import -n {account_name} -i {instance_name} --hashes sha256={hash_value} --size {size_in_bytes} --url {manifest_location} --file filename={file1_name} url={file1_url} --file filename={file2_name} url={file2_url}

Importáljon egy frissítést két kapcsolódó fájllal és hivatkozási lépések nélkül, így a parancssori felület kiszámíthatja az importálási jegyzékkivonat értékét és méretét bájtokban.

az iot du update import -n {account_name} -i {instance_name} --url {manifest_location} --file filename={file1_name} url={file1_url} --file filename={file2_name} url={file2_url}

Szülőfrissítés importálása két gyermekfrissítési referencialépéssel, ahol mindhárom importálási jegyzék egy kapcsolódó fájllal rendelkezik. Hagyja, hogy a parancssori felület kiszámolja a kivonat értékét és méretét bájtban. Ez a művelet a "--halasztás" képességre támaszkodik.

az iot du update import -n {account_name} -i {instance_name} --url {parent_manifest_location} --file filename={parent_file_name} url={parent_file_url} --defer

az iot du update import -n {account_name} -i {instance_name} --url {child1_manifest_location} --file filename={child1_file_name} url={child1_file_url} --defer

az iot du update import -n {account_name} -i {instance_name} --url {child2_manifest_location} --file filename={child2_file_name} url={child2_file_url}

Kötelező paraméterek

--account -n

Eszközfrissítési fiók neve. Az alapértelmezett fióknevet a következővel az config set defaults.adu_account=<name>konfigurálhatja: .

--instance -i

Eszközfrissítési példány neve. Az alapértelmezett példánynevet a következővel az config set defaults.adu_instance=<name>konfigurálhatja: .

--url

Elérhető hely, ahonnan az importálási jegyzék letölthető az IoT Hub eszközfrissítésével. Ez általában egy írásvédett SAS által védett blob URL-cím, amelynek lejárati ideje legalább 3 óra.

Opcionális paraméterek

--defer

Ideiglenesen tárolja az objektumot a helyi gyorsítótárban az Azure-ba való küldés helyett. Parancsok használatával az cache megtekintheti vagy törölheti a nézetet.

--file

Szóközzel elválasztott kulcs=értékpárok, amelyek a metaadatfájl tulajdonságainak importálásához felelnek meg. A szükséges kulcsok közé tartozik a fájlnév és az URL-cím. A --fájl 1 vagy több alkalommal használható.

--friendly-name

A frissítésdefinícióhoz társított rövid név.

--hashes

Szóközzel elválasztott kulcs=értékpárok, ahol a kulcs a használt kivonatoló algoritmus, az érték pedig a base64 kódolású importálási jegyzékfájl kivonata. Legalább sha256 bejegyzésre van szükség. Ha nincs megadva, a megadott URL-cím alapján lesz kiszámítva.

--no-wait

Ne várja meg, amíg a hosszú ideig futó művelet befejeződik.

Alapértelmezett érték: False
--resource-group -g

Eszközfrissítési fiók erőforráscsoportjának neve. Az alapértelmezett csoportot konfigurálhatja a következővel az config set defaults.adu_group=<name>: .

--size

Fájlméret bájtszámban. Ha nincs megadva, a megadott URL-cím alapján lesz kiszámítva.

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
Alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot du update list

Listázhatja az eszközfrissítési példányba importált frissítéseket.

A frissítésszolgáltatók listázásakor csak a --by-provider jelzőt kell megadni a gyakori példányok keresési argumentumai mellett. A frissítési nevek listázásakor meg kell adni a frissítésszolgáltatót. A frissítési verziók listázásakor meg kell adni a frissítésszolgáltatót és a frissítés nevét.

az iot du update list --account
                      --instance
                      [--by-provider {false, true}]
                      [--filter]
                      [--resource-group]
                      [--search]
                      [--un]
                      [--up]

Példák

Az összes frissítés listázása.

az iot du update list -n {account_name} -i {instance_name}

Az ingyenes szöveges keresési feltételeknek megfelelő frissítések listája, ebben az esetben a Contoso frissítésszolgáltatója.

az iot du update list -n {account_name} -i {instance_name} --search 'Contoso'

Sorolja fel az odata-szűrőnek megfelelő összes frissítést, ebben az esetben a nem üzembe helyezhető frissítések szűrését.

az iot du update list -n {account_name} -i {instance_name} --filter 'isDeployable eq false'

Az összes frissítésszolgáltató listázása.

az iot du update list -n {account_name} -i {instance_name} --by-provider

Az összes frissítési név listázása frissítésszolgáltató szerint.

az iot du update list -n {account_name} -i {instance_name} --update-provider {provider_name}

Az összes frissítési verzió listázása a frissítésszolgáltató és a frissítés neve szerint.

az iot du update list -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name}

Kötelező paraméterek

--account -n

Eszközfrissítési fiók neve. Az alapértelmezett fióknevet a következővel az config set defaults.adu_account=<name>konfigurálhatja: .

--instance -i

Eszközfrissítési példány neve. Az alapértelmezett példánynevet a következővel az config set defaults.adu_instance=<name>konfigurálhatja: .

Opcionális paraméterek

--by-provider

Az eredményhalmazt jelző jelzőt a szolgáltatók frissítésére kell korlátozni.

Elfogadott értékek: false, true
--filter

Korlátozza a tulajdonságértékek által visszaadott frissítések készletét. Támogatott, ha korlátozások nélküli frissítéseket listáz, vagy verzió szerint listáz.

--resource-group -g

Eszközfrissítési fiók erőforráscsoportjának neve. Az alapértelmezett csoportot konfigurálhatja a következővel az config set defaults.adu_group=<name>: .

--search

Ingyenes szöveges keresési kifejezésnek megfelelő frissítések kérése. A korlátozások nélküli frissítések listázása esetén támogatott.

--un --update-name

A frissítés neve.

--up --update-provider

A frissítésszolgáltató.

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
Alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot du update show

Adott frissítési verzió megjelenítése.

az iot du update show --account
                      --instance
                      --un
                      --up
                      --update-version
                      [--resource-group]

Példák

Adott frissítés megjelenítése a frissítésszolgáltató, a név és a verzió tekintetében.

az iot du update show -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name} --update-version {update_version}

Kötelező paraméterek

--account -n

Eszközfrissítési fiók neve. Az alapértelmezett fióknevet a következővel az config set defaults.adu_account=<name>konfigurálhatja: .

--instance -i

Eszközfrissítési példány neve. Az alapértelmezett példánynevet a következővel az config set defaults.adu_instance=<name>konfigurálhatja: .

--un --update-name

A frissítés neve.

--up --update-provider

A frissítésszolgáltató.

--update-version --uv

A frissítés verziója.

Opcionális paraméterek

--resource-group -g

Eszközfrissítési fiók erőforráscsoportjának neve. Az alapértelmezett csoportot konfigurálhatja a következővel az config set defaults.adu_group=<name>: .

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
Alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot du update stage

Előnézet

Ez a parancs előzetes verzióban és fejlesztés alatt áll. Referencia- és támogatási szintek: https://aka.ms/CLI_refstatus

Frissítés előkészítése egy célpéldányba való importáláshoz.

A frissítés átmeneti beállítása a frissítés célpéldányba való importálásának előfeltételeinek felgyorsítását jelenti. Egy adott importálási jegyzék esetében a folyamat meghatározza a releváns fájlokat, leküldi őket egy kívánt tárolóba, SAS URI-kat hoz létre, és lefedi a sikeres importálás egyéb előkészítési lépéseit.

Ez a parancs a frissítési fájlok konvencióalapú szervezetétől függ. A céljegyzék összes frissítési fájljának ugyanabban a könyvtárban kell lennie, amelyben az importálási jegyzékfájl található.

A kulcsalapú hozzáférés blobösszetevők feltöltésére és 3 órás időtartamú SAS URI-k olvasási hozzáféréssel történő létrehozására szolgál.

Ha --then-import a jelölő meg van adva, a parancs importálja a szakaszos frissítést. Ellenkező esetben ennek a műveletnek az eredménye egy importálási parancs, amely egy későbbi időpontban ugyanahhoz az eredményhez fog futni.

Ez a parancs törli és frissíti a célpéldány helyi gyorsítótár-bejegyzését.

az iot du update stage --account
                       --instance
                       --manifest-path
                       --storage-account
                       --storage-container
                       [--friendly-name]
                       [--overwrite {false, true}]
                       [--resource-group]
                       [--storage-subscription]
                       [--then-import {false, true}]

Példák

Önálló frissítés előkészítése. A frissítési fájlok várhatóan ugyanabban a könyvtárban lesznek, mint a jegyzékfájl. Az eredményül kapott importálási parancs később végrehajtható, hogy az SAS-jogkivonat lejárata előtt elindítsa a szakaszos frissítés importálását.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --manifest-path /path/to/manifest.json

Önálló frissítés előkészítése. Az előkészítés után importálja a frissítést a példányba egy kívánt rövid névvel.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --manifest-path /path/to/manifest.json --then-import --friendly-name myAptUpdate

Többhivatkozásos frissítés előkészítése. A frissítési fájlok a frissítési fiók egy másik előfizetésében található tárolóblobtárolóba lesznek feltöltve.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --storage-subscription {storage_account_subscription} --manifest-path /path/to/parent/parent.manifest.json --manifest-path /path/to/leaf1/leaf1.manifest.json --manifest-path /path/to/leaf2/leaf2.manifest.json

Többhivatkozásos frissítés szakasza, amely felülírja a meglévő blobokat, ha léteznek. Az előkészítés után importálja a frissítést a példányba.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --manifest-path /path/to/parent/parent.manifest.json --manifest-path /path/to/leaf1/leaf1.manifest.json --manifest-path /path/to/leaf2/leaf2.manifest.json --then-import --overwrite

Kötelező paraméterek

--account -n

Eszközfrissítési fiók neve. Az alapértelmezett fióknevet a következővel az config set defaults.adu_account=<name>konfigurálhatja: .

--instance -i

Eszközfrissítési példány neve. Az alapértelmezett példánynevet a következővel az config set defaults.adu_instance=<name>konfigurálhatja: .

--manifest-path

Az importáló jegyzék helyi fájlútvonala, amelyet meg kell szakaszosíteni. 1 vagy több alkalommal használható.

--storage-account

A tárfiók kívánt neve az importálási jegyzékelemek szakaszához.

--storage-container

A tároló kívánt neve az importálási jegyzékelemek szakaszához.

Opcionális paraméterek

--friendly-name

A frissítésdefinícióhoz társított rövid név.

--overwrite

A meglévő blobok felülírását jelző jelző, ha ütközés áll fenn.

Elfogadott értékek: false, true
Alapértelmezett érték: False
--resource-group -g

Eszközfrissítési fiók erőforráscsoportjának neve. Az alapértelmezett csoportot konfigurálhatja a következővel az config set defaults.adu_group=<name>: .

--storage-subscription

A kívánt tárfiók-előfizetés az importálási jegyzékelemek szakaszához. Akkor alkalmazható, ha a tár- és eszközfrissítési fiókok különböző előfizetésekben találhatók.

--then-import

Jelző, amely jelzi, hogy a frissítést az előkészítés után kell-e importálni.

Elfogadott értékek: false, true
Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
Alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.