Delen via

az dt model

Note

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

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

Opdracht

Name Description Type Status
az dt model create

Uploadt een of meer modellen.

 Extension GA
az dt model delete

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

 Extension GA
az dt model delete-all

Alle modellen in een Digital Twins-exemplaar verwijderen.

 Extension GA
az dt model list

Metagegevens, definities en afhankelijkheden van modellen weergeven.

 Extension GA
az dt model show

Haal een doelmodel of modeldefinitie op.

 Extension GA
az dt model update

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

 Extension 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 --dtn
                   [--failure-policy --fp {None, Rollback}]
                   [--fd --from-directory]
                   [--max-models-per-batch --mmpb]
                   [--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

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

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

Eigenschap Waarde
Parametergroep: Models Input Arguments
Default value: Rollback
Geaccepteerde waarden: None, 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 & 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.

Eigenschap Waarde
Parametergroep: Models Input Arguments
--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.

Eigenschap Waarde
Parametergroep: Models Input Arguments
Default value: 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 & 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.

Eigenschap Waarde
Parametergroep: Models Input Arguments
--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.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Naam of id van 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.

Eigenschap Waarde
Default value: False

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 --dtn
                   --dtmi --model-id
                   [--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

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

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

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Naam of id van 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.

Eigenschap Waarde
Default value: False

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

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

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

Eigenschap Waarde
Default value: False
Globale parameters
--debug

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

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Naam of id van 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.

Eigenschap Waarde
Default value: False

az dt model list

Metagegevens, definities en afhankelijkheden van modellen weergeven.

az dt model list --dt-name --dtn
                 [--def --definition {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

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--def --definition

Met de bewerking wordt de modeldefinitie opgehaald.

Eigenschap Waarde
Default value: False
Geaccepteerde waarden: false, true
--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.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Naam of id van 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.

Eigenschap Waarde
Default value: False

az dt model show

Haal een doelmodel of modeldefinitie op.

az dt model show --dt-name --dtn
                 --dtmi --model-id
                 [--def --definition {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

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--def --definition

Met de bewerking wordt de modeldefinitie opgehaald.

Eigenschap Waarde
Default value: False
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.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Naam of id van 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.

Eigenschap Waarde
Default value: False

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 --dtn
                   --dtmi --model-id
                   [--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

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--decommission

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

Eigenschap Waarde
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.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Naam of id van 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.

Eigenschap Waarde
Default value: False