az dt model

  • Referentie

Notitie

Deze verwijzing maakt deel uit van de Azure-iot-extensie voor de Azure CLI (versie 2.37.0 of hoger). De extensie installeert automatisch de eerste keer dat u een az dt-modelopdracht uitvoert. Meer informatie over extensies.

DTDL-modellen en -definities beheren op een Digital Twins-exemplaar.

Opdracht

Name Description Type Status
az dt model create

Uploadt een of meer modellen.

 Toestel GA
az dt model delete

Een model verwijderen. Een model kan alleen worden verwijderd als er geen andere modellen ernaar verwijzen.

 Toestel GA
az dt model delete-all

Alle modellen in een Digital Twins-exemplaar verwijderen.

 Toestel GA
az dt model list

Metagegevens, definities en afhankelijkheden van modellen weergeven.

 Toestel GA
az dt model show

Haal een doelmodel of modeldefinitie op.

 Toestel GA
az dt model update

Hiermee worden de metagegevens voor een model bijgewerkt. Op dit moment kan een model alleen worden gedecommisioneerd.

 Toestel GA

az dt model create

Uploadt een of meer modellen.

--modellen kunnen inline json of bestandspad zijn. De grootte van de invoermodelset (ontologie) wordt beperkt door het maximum aantal modellen dat het DT-exemplaar kan opslaan (standaard is 10000 modellen).

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

Voorbeelden

Upload alle .json- of .dtdl-modelbestanden bulksgewijs vanuit een doelmap. Modelverwerking is recursief.

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

Upload model json inline of vanuit bestandspad.

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

Vereiste parameters

--dt-name --dtn -n

Naam of hostnaam van het Digital Twins-exemplaar. Als er een exemplaarnaam wordt opgegeven, wordt het gebruikersabonnement eerst opgevraagd voor het doelexemplaren om de hostnaam op te halen. Als er een hostnaam wordt opgegeven, wordt de abonnementsquery overgeslagen en wordt de opgegeven waarde gebruikt voor volgende interactie.

Optionele parameters

--failure-policy --fp

Geeft het foutbeleid aan wanneer er een fout optreedt tijdens het verwerken van een modelbatch. In de modus Terugdraaien worden alle modellen die in eerdere batches zijn gemaakt, één voor één verwijderd. Wanneer deze optie is geselecteerd als Geen, worden de modellen die in eerdere batches zijn gemaakt, niet verwijderd uit het DT-exemplaar.

geaccepteerde waarden: None, Rollback
standaardwaarde: Rollback
--fd --from-directory

De JSON-modelbestanden van de map worden geparseerd uit. Let op: modellen worden atomisch gemaakt wanneer de map 250 of minder modellen bevat, dus als er een fout optreedt, worden geen van de modellen gemaakt. De invoermodelset wordt gesegmenteerd en gemaakt in batches wanneer de map meer dan 250 modellen (API-limiet) heeft. In het geval van een fout bij het verwerken van een batch, wordt het gedrag bepaald door de parameter --failure-policy.

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

De maximale modelgrootte per batch bij het maken van meer dan 250 modellen. Verminder dit aantal om een DTDLParser-fout te voorkomen.

standaardwaarde: 30
--models

Inline model JSON of bestandspad naar model JSON. Let op: modellen worden atomisch gemaakt wanneer model JSON 250 of minder modellen bevat, dus als er een fout optreedt, worden geen van de modellen gemaakt. De invoermodelset wordt gesegmenteerd en gemaakt in batches wanneer model JSON meer dan 250 modellen (API-limiet) heeft. In het geval van een fout bij het verwerken van een batch, wordt het gedrag bepaald door de parameter --failure-policy.

--resource-group -g

Resourcegroep voor Digital Twins-exemplaren. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az dt model delete

Een model verwijderen. Een model kan alleen worden verwijderd als er geen andere modellen ernaar verwijzen.

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

Voorbeelden

Een doelmodel verwijderen.

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

Vereiste parameters

--dt-name --dtn -n

Naam of hostnaam van het Digital Twins-exemplaar. Als er een exemplaarnaam wordt opgegeven, wordt het gebruikersabonnement eerst opgevraagd voor het doelexemplaren om de hostnaam op te halen. Als er een hostnaam wordt opgegeven, wordt de abonnementsquery overgeslagen en wordt de opgegeven waarde gebruikt voor volgende interactie.

--dtmi --model-id -m

Digital Twins-model-id. Voorbeeld: dtmi:com:example:Room;2.

Optionele parameters

--resource-group -g

Resourcegroep voor Digital Twins-exemplaren. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az dt model delete-all

Alle modellen in een Digital Twins-exemplaar verwijderen.

Twins-configuraties worden niet beïnvloed, maar kunnen worden verbroken zonder modeldefinities.

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

Voorbeelden

Alle modellen verwijderen.

az dt model delete-all -n {instance_or_hostname}

Vereiste parameters

--dt-name --dtn -n

Naam of hostnaam van het Digital Twins-exemplaar. Als er een exemplaarnaam wordt opgegeven, wordt het gebruikersabonnement eerst opgevraagd voor het doelexemplaren om de hostnaam op te halen. Als er een hostnaam wordt opgegeven, wordt de abonnementsquery overgeslagen en wordt de opgegeven waarde gebruikt voor volgende interactie.

Optionele parameters

--resource-group -g

Resourcegroep voor Digital Twins-exemplaren. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--yes -y

Niet vragen om bevestiging.

standaardwaarde: False
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az dt model list

Metagegevens, definities en afhankelijkheden van modellen weergeven.

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

Voorbeelden

Metagegevens van lijstmodel

az dt model list -n {instance_or_hostname}

Modeldefinities weergeven

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

Afhankelijkheden van bepaalde bestaande modellen vermelden. Ruimte gescheiden dtmi-waarden.

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

Vereiste parameters

--dt-name --dtn -n

Naam of hostnaam van het Digital Twins-exemplaar. Als er een exemplaarnaam wordt opgegeven, wordt het gebruikersabonnement eerst opgevraagd voor het doelexemplaren om de hostnaam op te halen. Als er een hostnaam wordt opgegeven, wordt de abonnementsquery overgeslagen en wordt de opgegeven waarde gebruikt voor volgende interactie.

Optionele parameters

--def --definition

Met de bewerking wordt de modeldefinitie opgehaald.

geaccepteerde waarden: false, true
standaardwaarde: False
--dependencies-for

De set modellen waarop hun afhankelijkheden worden opgehaald. Als u dit weglaat, worden alle modellen opgehaald. Opmaak is een door witruimte gescheiden lijst.

--resource-group -g

Resourcegroep voor Digital Twins-exemplaren. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az dt model show

Haal een doelmodel of modeldefinitie op.

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

Voorbeelden

Modelmetagegevens weergeven

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

Modelmetagegevens en -definitie weergeven

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

Vereiste parameters

--dt-name --dtn -n

Naam of hostnaam van het Digital Twins-exemplaar. Als er een exemplaarnaam wordt opgegeven, wordt het gebruikersabonnement eerst opgevraagd voor het doelexemplaren om de hostnaam op te halen. Als er een hostnaam wordt opgegeven, wordt de abonnementsquery overgeslagen en wordt de opgegeven waarde gebruikt voor volgende interactie.

--dtmi --model-id -m

Digital Twins-model-id. Voorbeeld: dtmi:com:example:Room;2.

Optionele parameters

--def --definition

Met de bewerking wordt de modeldefinitie opgehaald.

geaccepteerde waarden: false, true
standaardwaarde: False
--resource-group -g

Resourcegroep voor Digital Twins-exemplaren. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az dt model update

Hiermee worden de metagegevens voor een model bijgewerkt. Op dit moment kan een model alleen worden gedecommisioneerd.

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

Voorbeelden

Een doelmodel decommisioneren

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

Vereiste parameters

--dt-name --dtn -n

Naam of hostnaam van het Digital Twins-exemplaar. Als er een exemplaarnaam wordt opgegeven, wordt het gebruikersabonnement eerst opgevraagd voor het doelexemplaren om de hostnaam op te halen. Als er een hostnaam wordt opgegeven, wordt de abonnementsquery overgeslagen en wordt de opgegeven waarde gebruikt voor volgende interactie.

--dtmi --model-id -m

Digital Twins-model-id. Voorbeeld: dtmi:com:example:Room;2.

Optionele parameters

--decommission

Hiermee wordt de intentie aangegeven om een doelmodel uit bedrijf te nemen.

geaccepteerde waarden: false, true
--resource-group -g

Resourcegroep voor Digital Twins-exemplaren. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.