az iot du device deployment

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 eszköztelepítési parancs első futtatásakor. További információ a bővítményekről.

Eszköztelepítés kezelése.

Az üzembe helyezések egy kívánt kompatibilis frissítést fognak alkalmazni egy céleszközcsoportra, amely a frissítést a csoport eszközosztályai között terjeszti. A felhőalapú visszaállítási szabályzat opcionálisan konfigurálható.

Parancsok

Name	Description	Típus	Állapot
az iot du device deployment cancel	Eszközosztály-alcsoport üzembe helyezésének megszakítása.	Mellék	FE
az iot du device deployment create	Központi telepítés létrehozása eszközcsoporthoz. Az üzembe helyezés a célcsoporton belüli összes eszközosztály-alcsoportra több öntött lesz.	Mellék	FE
az iot du device deployment delete	Központi telepítés törlése eszközcsoport vagy eszközosztály alcsoport szerint.	Mellék	FE
az iot du device deployment list	Az eszközcsoport vagy az eszközosztály alcsoport üzemelő példányainak listázása.	Mellék	FE
az iot du device deployment list-devices	Az eszközosztály-alcsoport központi telepítésében lévő eszközök listázása az állapotukkal együtt. A sikertelen eszközök listájának lekéréséhez hasznos.	Mellék	FE
az iot du device deployment retry	Próbálkozzon újra egy eszközosztály-alcsoport üzembe helyezésével.	Mellék	FE
az iot du device deployment show	Eszközcsoport vagy eszközosztály alcsoport üzembe helyezésének megjelenítése, beleértve az állapotot, amely részletezi, hogy hány eszköz van folyamatban, fejeződött be vagy meghiúsult.	Mellék	FE

az iot du device deployment cancel

Eszközosztály-alcsoport üzembe helyezésének megszakítása.

az iot du device deployment cancel --account
                                   --cid
                                   --deployment-id
                                   --gid
                                   --instance
                                   [--resource-group]

Példák

A céleszközosztály alcsoport üzembe helyezésének megszakítása.

az iot du device deployment cancel -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id} --class-id {device_class_id}

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

--cid --class-id

Eszközosztály azonosítója. Ez a modellazonosítóból és az eszközfrissítési ügynök által jelentett kompatibilitási tulajdonságokból jön létre az IoT Hub eszközfrissítési PnP-felületén. Ez egy hexán kódolt SHA1 kivonat.

--deployment-id --did

A hívó által megadott üzembehelyezési azonosító. Ez nem lehet hosszabb 73 karakternél, csak kisbetűs lehet, és nem tartalmazhat "&", "^", "", "", "", "{", "}", "|",< "", "", "">, előre perjel, fordított perjel vagy kettős idézőjelet.

--gid --group-id

Eszközcsoport azonosítója. Ez az ADUGroup címke értékéből jön létre a csatlakoztatott IoT Hub ikereszközén/moduljában vagy $default címkével nem rendelkező eszközök esetében.

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

--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 device deployment create

Központi telepítés létrehozása eszközcsoporthoz. Az üzembe helyezés a célcsoporton belüli összes eszközosztály-alcsoportra több öntött lesz.

az iot du device deployment create --account
                                   --deployment-id
                                   --gid
                                   --instance
                                   --un
                                   --up
                                   --update-version
                                   [--failed-count]
                                   [--failed-percentage]
                                   [--rbun]
                                   [--rbup]
                                   [--rbuv]
                                   [--resource-group]
                                   [--start-time]

Példák

Hozzon létre egy eszközcsoport azonnali indítására ütemezett üzembe helyezést (az UTC-időpontra vonatkozóan).

az iot du device deployment create -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --update-name {update_name} --update-provider {update_provider} --update-version {update_version}

Hozzon létre egy eszközcsoport üzembe helyezését úgy, hogy a kívánt iso-8601-kompatibilis dátumidőn induljon el.

az iot du device deployment create -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --update-name {update_name} --update-provider {update_provider} --update-version {update_version} --start-time "2022-12-20T01:00:00"

Hozzon létre egy olyan eszközcsoport üzembe helyezését, amely egy meghatározott, felhő által kezdeményezett visszaállítási szabályzattal azonnal elindul. A felhőbeli visszaállítás akkor indul el, ha a sikertelen darabszám vagy a sikertelen százalékos célok teljesülnek.

az iot du device deployment create -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --update-name {update_name} --update-provider {update_provider} --update-version {update_version} --failed-count 10 --failed-percentage 5 --rollback-update-name {rollback_update_name} --rollback-update-provider {rollback_update_provider} --rollback-update-version {rollback_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: .

--deployment-id --did

A hívó által megadott üzembehelyezési azonosító. Ez nem lehet hosszabb 73 karakternél, csak kisbetűs lehet, és nem tartalmazhat "&", "^", "", "", "", "{", "}", "|",< "", "", "">, előre perjel, fordított perjel vagy kettős idézőjelet.

--gid --group-id

Eszközcsoport azonosítója. Ez az ADUGroup címke értékéből jön létre a csatlakoztatott IoT Hub ikereszközén/moduljában vagy $default címkével nem rendelkező eszközök esetében.

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

--failed-count --fc

Az üzembe helyezés sikertelen eszközeinek számát jelölő egész szám a felhőbeli initated rollback előtt. A visszaállítási szabályzat meghatározásakor kötelező.

--failed-percentage --fp

Egy üzembe helyezés sikertelen eszközeinek százalékos arányát jelző egész szám a felhőbeli initated rollback előtt. A visszaállítási szabályzat meghatározásakor kötelező.

--rbun --rollback-update-name

A visszaállítási frissítés neve.

--rbup --rollback-update-provider

A visszaállítási frissítés szolgáltatója.

--rbuv --rollback-update-version

A visszaállítási frissítés verziója.

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

--start-time

Az iso-8601 szabványnak megfelelő indítási idő az üzembe helyezéshez. Ha nincs megadva érték, a rendszer az UTC "now" megfelelő értékét használja.

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 device deployment delete

Központi telepítés törlése eszközcsoport vagy eszközosztály alcsoport szerint.

az iot du device deployment delete --account
                                   --deployment-id
                                   --gid
                                   --instance
                                   [--cid]
                                   [--resource-group]
                                   [--yes {false, true}]

Példák

Törölje a céleszközcsoport üzembe helyezését.

az iot du device deployment delete -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id}

Törölje a céleszközosztály alcsoportjának üzembe helyezését.

az iot du device deployment delete -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id} --class-id {device_class_id}

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

--deployment-id --did

A hívó által megadott üzembehelyezési azonosító. Ez nem lehet hosszabb 73 karakternél, csak kisbetűs lehet, és nem tartalmazhat "&", "^", "", "", "", "{", "}", "|",< "", "", "">, előre perjel, fordított perjel vagy kettős idézőjelet.

--gid --group-id

Eszközcsoport azonosítója. Ez az ADUGroup címke értékéből jön létre a csatlakoztatott IoT Hub ikereszközén/moduljában vagy $default címkével nem rendelkező eszközök esetében.

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

--cid --class-id

Eszközosztály azonosítója. Ez a modellazonosítóból és az eszközfrissítési ügynök által jelentett kompatibilitási tulajdonságokból jön létre az IoT Hub eszközfrissítési PnP-felületén. Ez egy hexán kódolt SHA1 kivonat.

--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 device deployment list

Az eszközcsoport vagy az eszközosztály alcsoport üzemelő példányainak listázása.

az iot du device deployment list --account
                                 --gid
                                 --instance
                                 [--cid]
                                 [--order-by]
                                 [--resource-group]

Példák

Egy eszközcsoport központi telepítéseinek listázása.

az iot du device deployment list -n {account_name} -i {instance_name} --group-id {device_group_id}

A startDateTime csökkenő sorrendbe állításával listázhatók az eszközcsoport-rendezési eredmények üzembe helyezései.

az iot du device deployment list -n {account_name} -i {instance_name} --group-id {device_group_id} --order-by "startDateTime desc"

Az eszközosztály alcsoport üzemelő példányainak listázása.

az iot du device deployment list -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id}

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

--gid --group-id

Eszközcsoport azonosítója. Ez az ADUGroup címke értékéből jön létre a csatlakoztatott IoT Hub ikereszközén/moduljában vagy $default címkével nem rendelkező eszközök esetében.

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

--cid --class-id

Eszközosztály azonosítója. Ez a modellazonosítóból és az eszközfrissítési ügynök által jelentett kompatibilitási tulajdonságokból jön létre az IoT Hub eszközfrissítési PnP-felületén. Ez egy hexán kódolt SHA1 kivonat.

--order-by

A visszaadott üzemelő példányok készletét rendeli el. A következővel rendelhet: startDateTime [desc/asc].

--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 device deployment list-devices

Az eszközosztály-alcsoport központi telepítésében lévő eszközök listázása az állapotukkal együtt. A sikertelen eszközök listájának lekéréséhez hasznos.

az iot du device deployment list-devices --account
                                         --cid
                                         --deployment-id
                                         --gid
                                         --instance
                                         [--filter]
                                         [--resource-group]

Példák

Eszközök listázása egy eszközosztály-alcsoport üzemelő példányában.

az iot du device deployment list-devices -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id} --deployment-id {deployment_id}

Eszközök listázása eszközosztály-alcsoport üzembe helyezési szűrése deviceId és deviceState szerint.

az iot du device deployment list-devices -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id} --deployment-id {deployment_id} --filter "deviceId eq 'd0' and deviceState eq 'InProgress'"

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

--cid --class-id

Eszközosztály azonosítója. Ez a modellazonosítóból és az eszközfrissítési ügynök által jelentett kompatibilitási tulajdonságokból jön létre az IoT Hub eszközfrissítési PnP-felületén. Ez egy hexán kódolt SHA1 kivonat.

--deployment-id --did

A hívó által megadott üzembehelyezési azonosító. Ez nem lehet hosszabb 73 karakternél, csak kisbetűs lehet, és nem tartalmazhat "&", "^", "", "", "", "{", "}", "|",< "", "", "">, előre perjel, fordított perjel vagy kettős idézőjelet.

--gid --group-id

Eszközcsoport azonosítója. Ez az ADUGroup címke értékéből jön létre a csatlakoztatott IoT Hub ikereszközén/moduljában vagy $default címkével nem rendelkező eszközök esetében.

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

--filter

A visszaadott üzembehelyezési eszközállapotok halmazát korlátozza. Szűrhet a deviceId és moduleId és/vagy deviceState adatokra.

--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 device deployment retry

Próbálkozzon újra egy eszközosztály-alcsoport üzembe helyezésével.

az iot du device deployment retry --account
                                  --cid
                                  --deployment-id
                                  --gid
                                  --instance
                                  [--resource-group]

Példák

Próbálkozzon újra a céleszközosztály alcsoport üzembe helyezésének újrapróbálkozása.

az iot du device deployment retry -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id} --class-id {device_class_id}

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

--cid --class-id

Eszközosztály azonosítója. Ez a modellazonosítóból és az eszközfrissítési ügynök által jelentett kompatibilitási tulajdonságokból jön létre az IoT Hub eszközfrissítési PnP-felületén. Ez egy hexán kódolt SHA1 kivonat.

--deployment-id --did

A hívó által megadott üzembehelyezési azonosító. Ez nem lehet hosszabb 73 karakternél, csak kisbetűs lehet, és nem tartalmazhat "&", "^", "", "", "", "{", "}", "|",< "", "", "">, előre perjel, fordított perjel vagy kettős idézőjelet.

--gid --group-id

Eszközcsoport azonosítója. Ez az ADUGroup címke értékéből jön létre a csatlakoztatott IoT Hub ikereszközén/moduljában vagy $default címkével nem rendelkező eszközök esetében.

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

--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 device deployment show

Eszközcsoport vagy eszközosztály alcsoport üzembe helyezésének megjelenítése, beleértve az állapotot, amely részletezi, hogy hány eszköz van folyamatban, fejeződött be vagy meghiúsult.

az iot du device deployment show --account
                                 --deployment-id
                                 --gid
                                 --instance
                                 [--cid]
                                 [--resource-group]
                                 [--status {false, true}]

Példák

Eszközcsoport üzembe helyezésének megjelenítése.

az iot du device deployment show -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id}

Eszközcsoport üzembe helyezésének állapotának megjelenítése.

az iot du device deployment show -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --status

Eszközosztály-alcsoport üzembe helyezésének megjelenítése.

az iot du device deployment show -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id} --deployment-id {deployment_id}

Eszközosztály-alcsoport üzembe helyezésének állapotának megjelenítése.

az iot du device deployment show -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id} --deployment-id {deployment_id} --status

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

--deployment-id --did

A hívó által megadott üzembehelyezési azonosító. Ez nem lehet hosszabb 73 karakternél, csak kisbetűs lehet, és nem tartalmazhat "&", "^", "", "", "", "{", "}", "|",< "", "", "">, előre perjel, fordított perjel vagy kettős idézőjelet.

--gid --group-id

Eszközcsoport azonosítója. Ez az ADUGroup címke értékéből jön létre a csatlakoztatott IoT Hub ikereszközén/moduljában vagy $default címkével nem rendelkező eszközök esetében.

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

--cid --class-id

Eszközosztály azonosítója. Ez a modellazonosítóból és az eszközfrissítési ügynök által jelentett kompatibilitási tulajdonságokból jön létre az IoT Hub eszközfrissítési PnP-felületén. Ez egy hexán kódolt SHA1 kivonat.

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

--status

Lekérdezi az üzembe helyezés állapotát, beleértve annak lebontását, hogy hány eszköz van folyamatban, fejeződött be vagy sikertelen.

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.