az dt model

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

az dt model create

Feltölt egy vagy több modellt.

az dt model delete

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

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 list

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

az dt model show

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

az dt model update

Frissítések a modell metaadatait. Egy modell jelenleg csak felbontásra használható.

az dt model create

Feltölt egy vagy több modellt.

A modellek lehetnek beágyazott JSON-fájlok vagy fájlelérési utak. 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]
                   [--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 JSON-modellt 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 a célpéldányhoz a gazdagépnév lekéréséhez. 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 későbbi interakcióhoz.

Opcionális paraméterek

--failure-policy --fp

A hibaházirendet jelzi, ha hiba történik a modellek kötegének 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ájljai a következőből lesznek elemezve. Megjegyzés: A modellek atomilag jönnek létre, ha a könyvtár 250 vagy kisebb modellt tartalmaz, ezért hiba esetén egyik modell sem jön létre. A bemeneti modellkészlet kötegekben van létrehozva & , ha a címtár több mint 250 modellel rendelkezik (API-korlát). Kötegfeldolgozási hiba esetén a viselkedést a --failure-policy paraméter határozza meg.

--models

Beágyazott JSON-modell vagy a JSON-modell fájlelérési útja. 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 modellkészlet kötegekben van létrehozva & , ha a JSON-modell több mint 250 modellel rendelkezik (API-korlát). Kötegfeldolgozási 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 a következővel az configure --defaults group=<name>konfigurálhatja: .

az dt model delete

Modell törlése. Egy modell csak akkor törölhető, 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 a célpéldányhoz a gazdagépnév lekéréséhez. 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 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 a következővel az configure --defaults group=<name>konfigurálhatja: .

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 a célpéldányhoz a gazdagépnév lekéréséhez. 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 későbbi interakcióhoz.

Opcionális paraméterek

--resource-group -g

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

--yes -y

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

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

Adott, már meglévő modell(ek) függőségeinek listázása. Térelválasztó dtmi értékek.

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 a célpéldányhoz a gazdagépnév lekéréséhez. 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 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
--dependencies-for

Azoknak a modelleknek a készlete, amelyek függőségeit lekéri. Ha nincs megadva, a rendszer az összes modellt lekéri. A formátum térközrel tagolt lista.

--resource-group -g

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

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 a célpéldányhoz a gazdagépnév lekéréséhez. 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 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
--resource-group -g

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

az dt model update

Frissítések a modell metaadatait. Egy modell jelenleg csak felbontásra használható.

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 a célpéldányhoz a gazdagépnév lekéréséhez. 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 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

A 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 a következővel az configure --defaults group=<name>konfigurálhatja: .