az iot edge deployment

Megjegyzés

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

Nagy léptékű IoT Edge üzemelő példányok kezelése.

Parancsok

az iot edge deployment create	Hozzon létre egy IoT Edge üzembe helyezést egy cél IoT Hub.
az iot edge deployment delete	Töröljön egy IoT Edge üzemelő példányt.
az iot edge deployment list	IoT Edge üzemelő példányok listázása egy IoT Hub.
az iot edge deployment show	Egy IoT Edge üzemelő példány részleteinek lekérése.
az iot edge deployment show-metric	Egy IoT Edge üzemelő példányban meghatározott célrendszermetrika kiértékelése.
az iot edge deployment update	Egy IoT Edge üzemelő példány megadott tulajdonságainak frissítése. A --set és a tulajdonság-hozzárendelések használatával frissítheti az üzemelő példányokat. Megjegyzés: IoT Edge üzembehelyezési tartalom nem módosítható. A frissíthető üzembehelyezési tulajdonságok a következők: "címkék", "metrikák", "prioritás" és "targetCondition".

az iot edge deployment create

Hozzon létre egy IoT Edge üzembe helyezést egy cél IoT Hub.

Az üzembe helyezés tartalma json, és {"modulesContent":{...}} vagy {"content":{"modulesContent":{...}}}.

A rendszermodulok alapértelmezett tulajdonságai $edgeAgent és $edgeHub az IoT-bővítménnyel telepített sémákon vannak érvényesítve. Ez a --no-validation kapcsolóval tiltható le.

Peremhálózati üzemelő példányok felhasználói metrikákkal hozhatók létre igény szerinti kiértékeléshez. A felhasználói metrikák json típusúak, és {"lekérdezések":{...}} vagy {"metrics":{"queries":{...}}}.

az iot edge deployment create --content
                              --deployment-id
                              [--auth-type {key, login}]
                              [--hub-name]
                              [--lab]
                              [--layered {false, true}]
                              [--login]
                              [--metrics]
                              [--no-validation {false, true}]
                              [--pri]
                              [--resource-group]
                              [--target-condition]

Példák

Hozzon létre egy üzembe helyezést címkékkel (bash szintaxis példa), amely a 9. épületben lévő eszközökre vonatkozik, és a környezet "teszt".

az iot edge deployment create -d {deployment_name} -n {iothub_name} --content modules_content.json --labels '{"key0":"value0", "key1":"value1"}' --target-condition "tags.building=9 and tags.environment='test'" --priority 3

Hozzon létre egy üzembe helyezést címkékkel (példa PowerShell-szintaxissal), amely a "dev" környezettel címkézett eszközökre vonatkozik.

az iot edge deployment create -d {deployment_name} -n {iothub_name} --content modules_content.json --labels "{'key':'value'}" --target-condition "tags.environment='dev'"

Hozzon létre egy rétegzett üzembe helyezést, amely a "dev" környezettel címkézett eszközökre vonatkozik. Beágyazottan definiált felhasználói metrikák és modulok tartalma (példa PowerShell-szintaxisra).

az iot edge deployment create -d {deployment_name} -n {iothub_name} --content "{'modulesContent':{'`$edgeAgent':{'properties.desired.modules.mymodule0':{ }},'`$edgeHub':{'properties.desired.routes.myroute0':'FROM /messages/* INTO `$upstream'}}}" --target-condition "tags.environment='dev'" --priority 10 --metrics "{'queries':{'mymetrik':'SELECT deviceId from devices where properties.reported.lastDesiredStatus.code = 200'}}" --layered

Hozzon létre egy rétegzett üzembe helyezést, amely a "9. épületben" lévő eszközökre és a környezet "teszt" környezetére vonatkozik. Beágyazottan definiált felhasználói metrikák és modulok tartalma (példa bash szintaxisra).

az iot edge deployment create -d {deployment_name} -n {iothub_name} --content '{"modulesContent":{"$edgeAgent":{"properties.desired.modules.mymodule0":{ }},"$edgeHub":{"properties.desired.routes.myroute0":"FROM /messages/* INTO $upstream"}}}' --target-condition "tags.building=9 and tags.environment='test'" --metrics '{"queries":{"mymetrik":"SELECT deviceId from devices where properties.reported.lastDesiredStatus.code = 200"}}' --layered

Hozzon létre egy rétegzett üzembe helyezést, amely a "9. épületben" lévő eszközökre és a környezet "teszt" környezetére vonatkozik. A fájlból definiált felhasználói metrikák és modulok tartalma is.

az iot edge deployment create -d {deployment_name} -n {iothub_name} --content layered_modules_content.json --target-condition "tags.building=9 and tags.environment='test'" --metrics metrics_content.json --layered

Kötelező paraméterek

--content -k

IoT Edge üzembe helyezési tartalmat. Adja meg a fájl elérési útját vagy a nyers json-t.

--deployment-id -d

Cél üzembe helyezési neve.

Opcionális paraméterek

--auth-type

Azt jelzi, hogy a műveletnek automatikusan le kell-e származtatnia egy szabályzatkulcsot, vagy az aktuális Azure AD munkamenetet kell-e használnia. Az alapértelmezett beállításokat a következővel az configure --defaults iothub-data-auth-type=<auth-type-value>konfigurálhatja: .

elfogadott értékek: key, login

alapértelmezett érték: key

--hub-name -n

IoT Hub nevet. Kötelező, ha a --login nincs megadva.

--lab --labels

A céltelepítésre alkalmazni kívánt címkék térképe. Használja a következő formátumot: "{"key0":"value0", "key1":"value1"}.

--layered

A rétegzett üzemelő példányok lehetővé teszik a kívánt tulajdonságok meghatározását $edgeAgent, $edgeHub és felhasználói modulokban, amelyek az alaptelepítésen alapulnak. A rétegzett üzemelő példányban megadott útvonalak például egyesülnek az alaptelepítés útvonalaival. Az azonos nevű útvonalak felül lesznek írva az üzembe helyezési prioritás alapján.

elfogadott értékek: false, true

--login -l

Ez a parancs támogatja a művelet végrehajtásához szükséges jogosultságokkal rendelkező entitásokat kapcsolati sztring. Az "az login" használatával elkerülheti a munkamenet-bejelentkezést. Ha egy entitás kapcsolati sztring és a név is meg van adva, a kapcsolati sztring elsőbbséget élvez. Akkor szükséges, ha a --hub-name nincs megadva.

--metrics -m

IoT Edge üzembehelyezési metrikák definícióit. Adja meg a fájl elérési útját vagy a nyers json-t.

--no-validation

Letiltja az ügyféloldali sémaérvényesítést a peremhálózati üzembe helyezés létrehozásához.

elfogadott értékek: false, true

--pri --priority

Az üzembe helyezés súlya versengő szabályok esetén (a legmagasabb győzelem).

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a következővel az configure --defaults group=<name>konfigurálhatja: .

--target-condition --tc -t

Célfeltétel, amelyre egy peremhálózati telepítés vonatkozik. A célfeltétel nélküli üzemelő példányok nem céloznak eszközt.

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.

--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 a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot edge deployment delete

Töröljön egy IoT Edge üzemelő példányt.

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

Kötelező paraméterek

--deployment-id -d

Cél üzembe helyezési neve.

Opcionális paraméterek

--auth-type

Azt jelzi, hogy a műveletnek automatikusan le kell-e származtatnia egy szabályzatkulcsot, vagy az aktuális Azure AD munkamenetet kell-e használnia. Az alapértelmezett beállításokat a következővel az configure --defaults iothub-data-auth-type=<auth-type-value>konfigurálhatja: .

elfogadott értékek: key, login

alapértelmezett érték: key

--etag -e

Az erőforrás utolsó állapotának megfelelő etag vagy entitáscímke. Ha nincs megadva etag, a rendszer a "*" értéket használja.

--hub-name -n

IoT Hub nevet. Kötelező, ha a --login nincs megadva.

--login -l

Ez a parancs támogatja a művelet végrehajtásához szükséges jogosultságokkal rendelkező entitásokat kapcsolati sztring. Az "az login" használatával elkerülheti a munkamenet-bejelentkezést. Ha egy entitás kapcsolati sztring és a név is meg van adva, a kapcsolati sztring elsőbbséget élvez. Akkor szükséges, ha a --hub-name nincs megadva.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a következővel az configure --defaults group=<name>konfigurálhatja: .

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.

--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 a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot edge deployment list

IoT Hub IoT Edge üzemelő példányainak listázása.

az iot edge deployment list [--auth-type {key, login}]
                            [--hub-name]
                            [--login]
                            [--resource-group]
                            [--top]

Opcionális paraméterek

--auth-type

Azt jelzi, hogy a műveletnek automatikusan le kell-e származtatnia egy szabályzatkulcsot, vagy az aktuális Azure AD munkamenetet kell-e használnia. Az alapértelmezett beállításokat a következővel az configure --defaults iothub-data-auth-type=<auth-type-value>konfigurálhatja: .

elfogadott értékek: key, login

alapértelmezett érték: key

--hub-name -n

IoT Hub nevet. Kötelező, ha a --login nincs megadva.

--login -l

Ez a parancs támogatja a művelet végrehajtásához szükséges jogosultságokkal rendelkező entitásokat kapcsolati sztring. Az "az login" használatával elkerülheti a munkamenet-bejelentkezést. Ha egy entitás kapcsolati sztring és a név is meg van adva, a kapcsolati sztring elsőbbséget élvez. Akkor szükséges, ha a --hub-name nincs megadva.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a következővel az configure --defaults group=<name>konfigurálhatja: .

--top

A visszaadni kívánt üzemelő példányok maximális száma. Alapértelmezés szerint a rendszer minden üzemelő példányt visszaad.

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.

--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 a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot edge deployment show

Az IoT Edge üzemelő példány részleteinek lekérése.

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

Kötelező paraméterek

--deployment-id -d

A cél üzembehelyezési neve.

Opcionális paraméterek

--auth-type

Azt jelzi, hogy a műveletnek automatikusan le kell-e származtatnia egy szabályzatkulcsot, vagy az aktuális Azure AD munkamenetet kell-e használnia. Az alapértelmezett beállításokat a használatával az configure --defaults iothub-data-auth-type=<auth-type-value>konfigurálhatja.

elfogadott értékek: key, login

alapértelmezett érték: key

--hub-name -n

IoT Hub nevet. Kötelező, ha a --login nincs megadva.

--login -l

Ez a parancs olyan entitásokat támogat, kapcsolati sztring műveletek végrehajtásához szükséges jogosultságokkal. Az "az login" használatával történő munkamenet-bejelentkezés elkerülésére használható. Ha egy entitás kapcsolati sztring és név is meg van adva, a kapcsolati sztring prioritást élvez. Kötelező, ha a --hub-name nincs megadva.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a használatával az configure --defaults group=<name>konfigurálhatja.

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.

--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 a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot edge deployment show-metric

Értékelje ki egy IoT Edge üzemelő példányban definiált célrendszer-metrikát.

az iot edge deployment show-metric --deployment-id
                                   --metric-id
                                   [--auth-type {key, login}]
                                   [--hub-name]
                                   [--login]
                                   [--metric-type {system, user}]
                                   [--resource-group]

Példák

Az "appliedCount" rendszermetrika kiértékelése

az iot edge deployment show-metric -m appliedCount -d {deployment_name} -n {iothub_name} --mt system

A "myCustomMetric" felhasználói metrika kiértékelése

az iot edge deployment show-metric -m myCustomMetric -d {deployment_name} -n {iothub_name}

Kötelező paraméterek

--deployment-id -d

A cél üzembehelyezési neve.

--metric-id -m

A kiértékelés célmetrikája.

Opcionális paraméterek

--auth-type

Azt jelzi, hogy a műveletnek automatikusan le kell-e származtatnia egy szabályzatkulcsot, vagy az aktuális Azure AD munkamenetet kell-e használnia. Az alapértelmezett beállításokat a használatával az configure --defaults iothub-data-auth-type=<auth-type-value>konfigurálhatja.

elfogadott értékek: key, login

alapértelmezett érték: key

--hub-name -n

IoT Hub nevet. Kötelező, ha a --login nincs megadva.

--login -l

Ez a parancs olyan entitásokat támogat, kapcsolati sztring műveletek végrehajtásához szükséges jogosultságokkal. Az "az login" használatával történő munkamenet-bejelentkezés elkerülésére használható. Ha egy entitás kapcsolati sztring és név is meg van adva, a kapcsolati sztring prioritást élvez. Kötelező, ha a --hub-name nincs megadva.

--metric-type --mt

Azt jelzi, hogy melyik metrikagyűjteményt kell használni a metrikák kereséséhez.

elfogadott értékek: system, user

alapértelmezett érték: user

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a használatával az configure --defaults group=<name>konfigurálhatja.

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.

--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 a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot edge deployment update

Egy IoT Edge üzemelő példány megadott tulajdonságainak frissítése.

A --set és a tulajdonság-hozzárendelések használatával frissítheti az üzemelő példányokat.

Megjegyzés: IoT Edge üzembehelyezési tartalom nem módosítható. A frissíthető üzembehelyezési tulajdonságok a következők: "címkék", "metrikák", "prioritás" és "targetCondition".

az iot edge deployment update --deployment-id
                              [--add]
                              [--auth-type {key, login}]
                              [--etag]
                              [--force-string]
                              [--hub-name]
                              [--login]
                              [--remove]
                              [--resource-group]
                              [--set]

Példák

Meglévő peremhálózati üzemelő példány címkéinek és célállapotának módosítása

az iot edge deployment update -d {deployment_name} -n {iothub_name} --set labels='{"purpose":"dev", "owners":"IoTEngineering"}' targetCondition='tags.building=9'

Kötelező paraméterek

--deployment-id -d

A cél üzembehelyezési neve.

Opcionális paraméterek

--add

Adjon hozzá egy objektumot az objektumok listájához egy elérési út és egy kulcsértékpár megadásával. Példa: --add property.listProperty <key=value, string vagy JSON string>.

--auth-type

Azt jelzi, hogy a műveletnek automatikusan le kell-e származtatnia egy szabályzatkulcsot, vagy az aktuális Azure AD munkamenetet kell-e használnia. Az alapértelmezett beállításokat a használatával az configure --defaults iothub-data-auth-type=<auth-type-value>konfigurálhatja.

elfogadott értékek: key, login

alapértelmezett érték: key

--etag -e

Az erőforrás utolsó állapotának megfelelő etag vagy entitáscímke. Ha nincs megadva etag, a rendszer a "*" értéket használja.

--force-string

A "set" vagy az "add" használatakor őrizze meg a sztringkonstansokat ahelyett, hogy JSON-ra próbálnál konvertálni.

--hub-name -n

IoT Hub nevet. Kötelező, ha a --login nincs megadva.

--login -l

Ez a parancs olyan entitásokat támogat, kapcsolati sztring műveletek végrehajtásához szükséges jogosultságokkal. Az "az login" használatával történő munkamenet-bejelentkezés elkerülésére használható. Ha egy entitás kapcsolati sztring és név is meg van adva, a kapcsolati sztring prioritást élvez. Kötelező, ha a --hub-name nincs megadva.

--remove

Tulajdonság vagy elem eltávolítása egy listából. Példa: --remove property.list OR --remove propertyToRemove.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a használatával az configure --defaults group=<name>konfigurálhatja.

--set

Objektum frissítése a beállítandó tulajdonság elérési útjának és értékének megadásával. Példa: --set property1.property2=.

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.

--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 a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.