az dt twin
Notitie
Deze referentie maakt deel uit van de azure-iot-extensie voor Azure CLI en vereist versie 2.17.1 of hoger. De extensie wordt automatisch geïnstalleerd wanneer u de opdracht az dt twin voor het eerst hebt uitgevoerd. Meer informatie over extensies.
De digitale tweelingen van een Digital Twins beheren en configureren.
Opdracht
| az dt twin component |
De digital twin-onderdelen van een Digital Twins en bijwerken. |
| az dt twin component show |
Details van een digital twin-onderdeel tonen. |
| az dt twin component update |
Werk een digital twin-onderdeel bij via de JSON-patchspecificatie. |
| az dt twin create |
Maak een digitale tweeling op een exemplaar. |
| az dt twin delete |
Een digitale tweeling verwijderen. Alle relaties die naar deze tweeling verwijzen, moeten al worden verwijderd. |
| az dt twin delete-all |
Hiermee worden alle digitale tweelingen binnen een Digital Twins verwijderd, inclusief alle relaties voor deze tweelingen. |
| az dt twin query |
Een query uitvoeren op de digitale tweelingen van een exemplaar. Hiermee kunt u relaties doorlopen en filteren op eigenschapswaarden. |
| az dt twin relationship |
De digitale dubbelrelaties van een Digital Twins beheren en configureren. |
| az dt twin relationship create |
Maak een relatie tussen de bron- en doel-digitale tweelingen. |
| az dt twin relationship delete |
Verwijder een digital twin-relatie op een Digital Twins exemplaar. |
| az dt twin relationship delete-all |
Hiermee verwijdert u alle digitale dubbelrelaties binnen een Digital Twins exemplaar, inclusief binnenkomende relaties. |
| az dt twin relationship list |
De relaties van een digitale tweeling opnigeer. |
| az dt twin relationship show |
Details van een digitale dubbelrelatie tonen. |
| az dt twin relationship update |
Werkt de eigenschappen van een relatie tussen twee digitale tweelingen bij via JSON-patchspecificatie. |
| az dt twin show |
De details van een digitale tweeling tonen. |
| az dt twin telemetry |
Test en valideer de gebeurtenisroutes en eindpunten van een Digital Twins exemplaar. |
| az dt twin telemetry send |
Verzendt telemetrie namens een digitale tweeling. Als het onderdeelpad is opgegeven, wordt de uitgezonden telemetrie namens het onderdeel gebruikt. |
| az dt twin update |
Werk een digitale tweeling van het exemplaar bij via de JSON-patchspecificatie. |
az dt twin create
Maak een digitale tweeling op een exemplaar.
--properties kan een inline JSON- of bestandspad zijn. Opmerking: --properties zijn vereist voor tweelingen die onderdelen bevatten.
az dt twin create --dt-name
--dtmi
--twin-id
[--if-none-match]
[--properties]
[--resource-group]
Voorbeelden
Maak een digitale tweeling van een bestaand (eerder gemaakt) model.
az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:Room;1" --twin-id {twin_id}
Maak een digitale tweeling van een bestaand (eerder gemaakt) model met de tag if-none-match.
az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:Room;1" --twin-id {twin_id} --if-none-match
Maak een digitale tweeling van een bestaand (eerder gemaakt) model. Instantieer met eigenschapswaarden.
az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:DeviceInformation;1" --twin-id {twin_id} --properties '{"manufacturer": "Microsoft"}'
Maak een digitale tweeling met een onderdeel van bestaande (eerder gemaakte) modellen. Een onderdeel instantieren met minimale eigenschappen.
az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:TemperatureController;1" --twin-id {twin_id} --properties '{
"Thermostat": {
"$metadata": {},
}
}'
Maak een digitale tweeling met een onderdeel van bestaande (eerder gemaakte) modellen. Instantieer met eigenschapswaarden.
az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:TemperatureController;1" --twin-id {twin_id} --properties '{
"Temperature": 10.2,
"Thermostat": {
"$metadata": {},
"setPointTemp": 23.12
}
}'
Vereiste parameters
Digital Twins exemplaarnaam of hostnaam. Als er een exemplaarnaam wordt opgegeven, wordt eerst het gebruikersabonnement opgevraagd voor het doelexe exemplaar om de hostnaam op te halen. Als er een hostnaam wordt opgegeven, wordt de abonnementsquery overgeslagen en wordt de opgegeven waarde gebruikt voor de volgende interactie.
Digital Twins model-id. Voorbeeld: dtmi:com:example:Room;2.
De id van de digitale tweeling.
Optionele parameters
Geeft aan dat de maakbewerking moet mislukken als er een bestaande tweeling met dezelfde id bestaat.
Initiële eigenschapswaarden voor het instantiëren van een digitale tweeling of gerelateerde onderdelen. Geef het bestandspad of inline JSON op. Eigenschappen zijn vereist voor tweelingen die onderdelen bevatten. U moet minimaal een leeg $metadata-object voor elk onderdeel.
Digital Twins resourcegroep van het exemplaar. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
az dt twin delete
Een digitale tweeling verwijderen. Alle relaties die naar deze tweeling verwijzen, moeten al worden verwijderd.
az dt twin delete --dt-name
--twin-id
[--etag]
[--resource-group]
Voorbeelden
Een digitale tweeling verwijderen op id.
az dt twin delete -n {instance_or_hostname} --twin-id {twin_id}
Verwijder een digitale tweeling op id met behulp van de etag.
az dt twin delete -n {instance_or_hostname} --twin-id {twin_id} --etag {etag}
Vereiste parameters
Digital Twins exemplaarnaam of hostnaam. Als er een exemplaarnaam wordt opgegeven, wordt eerst het gebruikersabonnement opgevraagd voor het doelexe exemplaar om de hostnaam op te halen. Als er een hostnaam wordt opgegeven, wordt de abonnementsquery overgeslagen en wordt de opgegeven waarde gebruikt voor de volgende interactie.
De id van de digitale tweeling.
Optionele parameters
Waarde van entiteitstag. De opdracht slaagt als de etag overeenkomt met de huidige etag voor de resource.
Digital Twins resourcegroep van het exemplaar. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
az dt twin delete-all
Hiermee worden alle digitale tweelingen binnen een Digital Twins verwijderd, inclusief alle relaties voor deze tweelingen.
az dt twin delete-all --dt-name
[--resource-group]
[--yes]
Voorbeelden
Verwijder alle digitale tweelingen. Relaties die naar de tweelingen verwijzen, worden ook verwijderd.
az dt twin delete-all -n {instance_or_hostname}
Vereiste parameters
Digital Twins exemplaarnaam of hostnaam. Als er een exemplaarnaam wordt opgegeven, wordt eerst het gebruikersabonnement opgevraagd voor het doelexe exemplaar om de hostnaam op te halen. Als er een hostnaam wordt opgegeven, wordt de abonnementsquery overgeslagen en wordt de opgegeven waarde gebruikt voor de volgende interactie.
Optionele parameters
Digital Twins resourcegroep van het exemplaar. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .
Niet vragen om bevestiging.
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
az dt twin query
Een query uitvoeren op de digitale tweelingen van een exemplaar. Hiermee kunt u relaties doorlopen en filteren op eigenschapswaarden.
az dt twin query --dt-name
--query-command
[--cost {false, true}]
[--resource-group]
Voorbeelden
Alle digitale tweelingen in het doel-exemplaar opvragen en alle kenmerken projecten. Kosten worden ook in query-eenheden weer te geven.
az dt twin query -n {instance_or_hostname} -q "select * from digitaltwins" --show-cost
Query's uitvoeren op model en projecteert alle kenmerken.
az dt twin query -n {instance_or_hostname} -q "select * from digitaltwins T where IS_OF_MODEL(T, 'dtmi:com:example:Room;2')"
Vereiste parameters
Digital Twins exemplaarnaam of hostnaam. Als er een exemplaarnaam wordt opgegeven, wordt eerst het gebruikersabonnement opgevraagd voor het doelexe exemplaar om de hostnaam op te halen. Als er een hostnaam wordt opgegeven, wordt de abonnementsquery overgeslagen en wordt de opgegeven waarde gebruikt voor de volgende interactie.
Gebruikersquery die moet worden uitgevoerd.
Optionele parameters
Berekent en toont de querykosten.
Digital Twins resourcegroep van het exemplaar. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
az dt twin show
De details van een digitale tweeling tonen.
az dt twin show --dt-name
--twin-id
[--resource-group]
Voorbeelden
De details van een digitale tweeling tonen.
az dt twin show -n {instance_or_hostname} --twin-id {twin_id}
Vereiste parameters
Digital Twins exemplaarnaam of hostnaam. Als er een exemplaarnaam wordt opgegeven, wordt eerst het gebruikersabonnement opgevraagd voor het doelexe exemplaar om de hostnaam op te halen. Als er een hostnaam wordt opgegeven, wordt de abonnementsquery overgeslagen en wordt de opgegeven waarde gebruikt voor de volgende interactie.
De id van de digitale tweeling.
Optionele parameters
Digital Twins resourcegroep van het exemplaar. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
az dt twin update
Werk een digitale tweeling van het exemplaar bij via de JSON-patchspecificatie.
Updates voor eigenschapswaarden en $model elementen kunnen in dezelfde aanvraag plaatsvinden. Bewerkingen zijn beperkt tot toevoegen, vervangen en verwijderen.
az dt twin update --dt-name
--json-patch
--twin-id
[--etag]
[--resource-group]
Voorbeelden
Een digitale tweeling bijwerken via JSON-patchspecificatie.
az dt twin update -n {instance_or_hostname} --twin-id {twin_id} --json-patch '{"op":"replace", "path":"/Temperature", "value": 20.5}'
Een digitale tweeling bijwerken via JSON-patchspecificatie en etag gebruiken.
az dt twin update -n {instance_or_hostname} --twin-id {twin_id} --etag {etag} --json-patch '{"op":"replace", "path":"/Temperature", "value": 20.5}'
Een digitale tweeling bijwerken via JSON-patchspecificatie.
az dt twin update -n {instance_or_hostname} --twin-id {twin_id} --json-patch '[
{"op":"replace", "path":"/Temperature", "value": 20.5},
{"op":"add", "path":"/Areas", "value": ["ControlSystem"]}
]'
Een digitale tweeling bijwerken via de JSON-patchspecificatie die in een bestand is gedefinieerd.
az dt twin update -n {instance_or_hostname} --twin-id {twin_id} --json-patch ./my/patch/document.json
Vereiste parameters
Digital Twins exemplaarnaam of hostnaam. Als er een exemplaarnaam wordt opgegeven, wordt eerst het gebruikersabonnement opgevraagd voor het doelexe exemplaar om de hostnaam op te halen. Als er een hostnaam wordt opgegeven, wordt de abonnementsquery overgeslagen en wordt de opgegeven waarde gebruikt voor de volgende interactie.
Een updatespecificatie die wordt beschreven door JSON-patch. Updates voor eigenschapswaarden en $model elementen kunnen in dezelfde aanvraag plaatsvinden. Bewerkingen zijn beperkt tot toevoegen, vervangen en verwijderen. Geef het bestandspad of inline JSON op.
De id van de digitale tweeling.
Optionele parameters
Waarde van entiteitstag. De opdracht slaagt als de etag overeenkomt met de huidige etag voor de resource.
Digital Twins resourcegroep van het exemplaar. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.