az dt model

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 dt modellparancs első futtatásakor. További információ a bővítményekről.

DTDL-modellek és -definíciók kezelése egy Digital Twins-példányon.

Parancsok

Name	Description	Típus	Állapot
az dt model create	Feltölt egy vagy több modellt.	Mellék	FE
az dt model delete	Modell törlése. A modellek csak akkor törölhetők, ha más modellek nem hivatkoznak rá.	Mellék	FE
az dt model delete-all	Törölje az összes modellt egy Digital Twins-példányon belül.	Mellék	FE
az dt model list	Modell metaadatainak, definícióinak és függőségeinek listázása.	Mellék	FE
az dt model show	Célmodell vagy modelldefiníció lekérése.	Mellék	FE
az dt model update	Frissíti a modell metaadatait. Egy modell jelenleg csak felbontással bontható fel.	Mellék	FE

az dt model create

Feltölt egy vagy több modellt.

--modellek lehetnek beágyazott json vagy fájl elérési útja. A bemeneti modellkészlet (ontológia) méretét a DT-példány által tárolható modellek maximális száma korlátozza (alapértelmezés szerint 10000 modell).

az dt model create --dt-name
                   [--failure-policy {None, Rollback}]
                   [--fd]
                   [--max-models-per-batch]
                   [--models]
                   [--resource-group]

Példák

Töltse fel tömegesen az összes .json vagy .dtdl-modellfájlt egy célkönyvtárból. A modellfeldolgozás rekurzív.

az dt model create -n {instance_or_hostname} --from-directory {directory_path}

Töltse fel a modell json-modelljét a szövegbe vagy a fájl elérési útjából.

az dt model create -n {instance_or_hostname} --models {file_path_or_inline_json}

Kötelező paraméterek

--dt-name --dtn -n

Digital Twins-példány neve vagy állomásneve. Ha meg van adva egy példánynév, a rendszer először lekérdezi a felhasználói előfizetést, hogy a célpéldány lekérje a gazdagépnevet. Ha meg van adva egy gazdagépnév, a rendszer kihagyja az előfizetési lekérdezést, és a megadott értéket használja a rendszer a későbbi interakcióhoz.

Opcionális paraméterek

--failure-policy --fp

A hibaházirendet jelzi, ha hiba történik egy modellköteg feldolgozása során. A visszaállítási módban az előző kötegekben létrehozott összes modell egyenként törlődik. Ha a "Nincs" lehetőséget választja, az előző kötegekben létrehozott modellek nem törlődnek a DT-példányból.

elfogadott értékek: None, Rollback

alapértelmezett érték: Rollback

--fd --from-directory

A címtár JSON-modellfájljait a rendszer elemzi. Megjegyzés: A modellek atomilag jönnek létre, ha a címtár 250 vagy kisebb modellt tartalmaz, ezért hiba esetén egyik modell sem jön létre. A bemeneti modellkészlet darabolt és kötegekben jön létre, ha a könyvtár több mint 250 modellel rendelkezik (API-korlát). Köteg feldolgozása során fellépő hiba esetén a viselkedést a --failure-policy paraméter határozza meg.

--max-models-per-batch --mmpb

Kísérleti

A kötegenkénti maximális modellméret 250-nél több modell létrehozásakor. Csökkentse ezt a számot a DTDLParser hiba elkerülése érdekében.

alapértelmezett érték: 30

--models

Beágyazott modell JSON-ja vagy a JSON-modell fájlútvonala. Megjegyzés: A modellek atomilag jönnek létre, ha a JSON modell 250 vagy kisebb modellt tartalmaz, ezért hiba esetén egyik modell sem jön létre. A bemeneti modell készlete kötegekben van létrehozva, ha a JSON-modell több mint 250 modellel rendelkezik (API-korlát). Köteg feldolgozása során fellépő hiba esetén a viselkedést a --failure-policy paraméter határozza meg.

--resource-group -g

Digital Twins-példány erőforráscsoportja. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults 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 dt model delete

Modell törlése. A modellek csak akkor törölhetők, ha más modellek nem hivatkoznak rá.

az dt model delete --dt-name
                   --dtmi
                   [--resource-group]

Példák

Célmodell törlése.

az dt model delete -n {instance_or_hostname} --dtmi "dtmi:com:example:Floor;1"

Kötelező paraméterek

--dt-name --dtn -n

Digital Twins-példány neve vagy állomásneve. Ha meg van adva egy példánynév, a rendszer először lekérdezi a felhasználói előfizetést, hogy a célpéldány lekérje a gazdagépnevet. Ha meg van adva egy gazdagépnév, a rendszer kihagyja az előfizetési lekérdezést, és a megadott értéket használja a rendszer a későbbi interakcióhoz.

--dtmi --model-id -m

Digital Twins modellazonosító. Példa: dtmi:com:example:Room;2.

Opcionális paraméterek

--resource-group -g

Digital Twins-példány erőforráscsoportja. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults 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 dt model delete-all

Törölje az összes modellt egy Digital Twins-példányon belül.

Az ikerpéldány-konfigurációk nem érintettek, de modelldefiníciók nélkül megszakadhatnak.

az dt model delete-all --dt-name
                       [--resource-group]
                       [--yes]

Példák

Törölje az összes modellt.

az dt model delete-all -n {instance_or_hostname}

Kötelező paraméterek

--dt-name --dtn -n

Digital Twins-példány neve vagy állomásneve. Ha meg van adva egy példánynév, a rendszer először lekérdezi a felhasználói előfizetést, hogy a célpéldány lekérje a gazdagépnevet. Ha meg van adva egy gazdagépnév, a rendszer kihagyja az előfizetési lekérdezést, és a megadott értéket használja a rendszer a későbbi interakcióhoz.

Opcionális paraméterek

--resource-group -g

Digital Twins-példány erőforráscsoportja. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

--yes -y

Ne kérje a megerősítést.

alapértelmezett érték: False

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 dt model list

Modell metaadatainak, definícióinak és függőségeinek listázása.

az dt model list --dt-name
                 [--def {false, true}]
                 [--dependencies-for]
                 [--resource-group]

Példák

Modell metaadatainak listázása

az dt model list -n {instance_or_hostname}

Modelldefiníciók listázása

az dt model list -n {instance_or_hostname} --definition

Az adott meglévő modell(ek) függőségeinek listázása. Térköz elválasztja a dtmi-értékeket.

az dt model list -n {instance_or_hostname} --dependencies-for {model_id0} {model_id1}

Kötelező paraméterek

--dt-name --dtn -n

Digital Twins-példány neve vagy állomásneve. Ha meg van adva egy példánynév, a rendszer először lekérdezi a felhasználói előfizetést, hogy a célpéldány lekérje a gazdagépnevet. Ha meg van adva egy gazdagépnév, a rendszer kihagyja az előfizetési lekérdezést, és a megadott értéket használja a rendszer a későbbi interakcióhoz.

Opcionális paraméterek

--def --definition

A művelet lekéri a modelldefiníciót.

elfogadott értékek: false, true

alapértelmezett érték: False

--dependencies-for

Azoknak a modelleknek a készlete, amelyekhez le lesznek kérve a függőségek. Ha nincs megadva, a rendszer az összes modellt lekéri. A formátum egy szóközrel elválasztott lista.

--resource-group -g

Digital Twins-példány erőforráscsoportja. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults 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 dt model show

Célmodell vagy modelldefiníció lekérése.

az dt model show --dt-name
                 --dtmi
                 [--def {false, true}]
                 [--resource-group]

Példák

Modell metaadatainak megjelenítése

az dt model show -n {instance_or_hostname} --dtmi "dtmi:com:example:Floor;1"

Modell metaadatainak és definíciójának megjelenítése

az dt model show -n {instance_or_hostname} --dtmi "dtmi:com:example:Floor;1" --definition

Kötelező paraméterek

--dt-name --dtn -n

Digital Twins-példány neve vagy állomásneve. Ha meg van adva egy példánynév, a rendszer először lekérdezi a felhasználói előfizetést, hogy a célpéldány lekérje a gazdagépnevet. Ha meg van adva egy gazdagépnév, a rendszer kihagyja az előfizetési lekérdezést, és a megadott értéket használja a rendszer a későbbi interakcióhoz.

--dtmi --model-id -m

Digital Twins modellazonosító. Példa: dtmi:com:example:Room;2.

Opcionális paraméterek

--def --definition

A művelet lekéri a modelldefiníciót.

elfogadott értékek: false, true

alapértelmezett érték: False

--resource-group -g

Digital Twins-példány erőforráscsoportja. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults 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 dt model update

Frissíti a modell metaadatait. Egy modell jelenleg csak felbontással bontható fel.

az dt model update --dt-name
                   --dtmi
                   [--decommission {false, true}]
                   [--resource-group]

Példák

Célmodell felbontása

az dt model update -n {instance_or_hostname} --dtmi "dtmi:com:example:Floor;1" --decommission

Kötelező paraméterek

--dt-name --dtn -n

Digital Twins-példány neve vagy állomásneve. Ha meg van adva egy példánynév, a rendszer először lekérdezi a felhasználói előfizetést, hogy a célpéldány lekérje a gazdagépnevet. Ha meg van adva egy gazdagépnév, a rendszer kihagyja az előfizetési lekérdezést, és a megadott értéket használja a rendszer a későbbi interakcióhoz.

--dtmi --model-id -m

Digital Twins modellazonosító. Példa: dtmi:com:example:Room;2.

Opcionális paraméterek

--decommission

Célmodell leszerelési szándékát jelzi.

elfogadott értékek: false, true

--resource-group -g

Digital Twins-példány erőforráscsoportja. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults 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.