az dt twin relationship
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 eerste keer een opdracht az dt twin relationship hebt uitgevoerd. Meer informatie over extensies.
De digitale dubbelrelaties van een Digital Twins beheren en configureren.
Opdracht
| 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 relationship create
Maak een relatie tussen de bron- en doel-digitale tweelingen.
--properties kan een inline JSON- of bestandspad zijn.
az dt twin relationship create --dt-name
--kind
--relationship-id
--source
--target
[--if-none-match]
[--properties]
[--resource-group]
Voorbeelden
Maak een relatie tussen twee digitale tweelingen.
az dt twin relationship create -n {instance_or_hostname} --relationship-id {relationship_id} --relationship contains --twin-id {source_twin_id} --target {target_twin_id}
Een relatie maken tussen twee digitale tweelingen met de tag if-none-match
az dt twin relationship create -n {instance_or_hostname} --relationship-id {relationship_id} --relationship contains --twin-id {source_twin_id} --target {target_twin_id} --if-none-match
Maak een relatie met de initialiseerde eigenschappen tussen twee digitale tweelingen.
az dt twin relationship create -n {instance_or_hostname} --relationship-id {relationship_id} --relationship contains --twin-id {source_twin_id} --target {target_twin_id} --properties '{"ownershipUser": "me", "ownershipDepartment": "Computer Science"}'
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.
Naam of soort relatie. Bijvoorbeeld: 'contains'.
Relatie-id.
De bron-dubbel-id voor een relatie.
De doel dubbel-id voor een relatie.
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 dubbelrelatie. Geef het bestandspad of inline JSON op.
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 relationship delete
Verwijder een digital twin-relatie op een Digital Twins exemplaar.
az dt twin relationship delete --dt-name
--relationship-id
--source
[--etag]
[--resource-group]
Voorbeelden
Verwijder een digital twin-relatie.
az dt twin relationship delete -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id}
Verwijder een digitale dubbelrelatie met behulp van de etag.
az dt twin relationship delete -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_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.
Relatie-id.
De bron-dubbel-id voor een relatie.
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 relationship delete-all
Hiermee verwijdert u alle digitale dubbelrelaties binnen een Digital Twins exemplaar, inclusief binnenkomende relaties.
az dt twin relationship delete-all --dt-name
[--resource-group]
[--source]
[--yes]
Voorbeelden
Verwijder alle digital twin-relaties die aan de tweeling zijn gekoppeld.
az dt twin relationship delete-all -n {instance_or_hostname} --twin-id {twin_id}
Verwijder alle digitale dubbelrelaties binnen de Digital Twins te maken.
az dt twin relationship 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 .
De bron-dubbel-id voor een relatie.
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 relationship list
De relaties van een digitale tweeling opnigeer.
az dt twin relationship list --dt-name
--source
[--incoming {false, true}]
[--kind]
[--resource-group]
Voorbeelden
Lijst met uitgaande relaties van een digitale tweeling.
az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id}
Uitgaande relaties van een digitale tweeling en filter op relatie 'contains'
az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id} --relationship contains
Een lijst met binnenkomende relaties van een digitale tweeling maken.
az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id} --incoming
Binnenkomende relaties van een digitale tweeling en filter op relatie 'contains'.
az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id} --relationship contains --incoming
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 bron-dubbel-id voor een relatie.
Optionele parameters
Hiermee worden alle binnenkomende relaties voor een digitale tweeling opgehaald.
Filter het resultaat op het soort relatie.
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 relationship show
Details van een digitale dubbelrelatie tonen.
az dt twin relationship show --dt-name
--relationship-id
--source
[--resource-group]
Voorbeelden
Details van een digitale dubbelrelatie tonen.
az dt twin relationship show -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_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.
Relatie-id.
De bron-dubbel-id voor een relatie.
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 relationship update
Werkt de eigenschappen van een relatie tussen twee digitale tweelingen bij via JSON-patchspecificatie.
Bewerkingen zijn beperkt tot toevoegen, vervangen en verwijderen.
az dt twin relationship update --dt-name
--json-patch
--relationship-id
--source
[--etag]
[--resource-group]
Voorbeelden
Werk een digital twin-relatie bij via de JSON-patchspecificatie.
az dt twin relationship update -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id} --relationship contains --json-patch '{"op":"replace", "path":"/Temperature", "value": 20.5}'
Werk een digital twin-relatie bij via de JSON-patchspecificatie en met behulp van etag.
az dt twin relationship update -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id} --relationship contains --json-patch '{"op":"replace", "path":"/Temperature", "value": 20.5}' --etag {etag}
Werk een digital twin-relatie bij via de JSON-patchspecificatie.
az dt twin relationship update -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id} --relationship contains --json-patch '[
{"op":"replace", "path":"/Temperature", "value": 20.5},
{"op":"add", "path":"/Areas", "value": ["ControlSystem"]}
]'
Werk een digital twin-relatie bij via de JSON-patchspecificatie die in een bestand is gedefinieerd.
az dt twin relationship update -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id} --relationship contains --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.
Relatie-id.
De bron-dubbel-id voor een relatie.
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.