az dt twin relationship

  • 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 opdracht az dt twin relationship uitvoert. Meer informatie over extensies.

Beheer en configureer de digitale dubbelrelaties van een Digital Twins-exemplaar.

Opdracht

Name Description Type Status
az dt twin relationship create

Maak een relatie tussen de digitale dubbels van de bron en het doel.

 Toestel GA
az dt twin relationship delete

Een digitale dubbelrelatie op een Digital Twins-exemplaar verwijderen.

 Toestel GA
az dt twin relationship delete-all

Hiermee verwijdert u alle digitale dubbelrelaties binnen een Digital Twins-exemplaar, inclusief binnenkomende relaties.

 Toestel GA
az dt twin relationship list

De relaties van een digitale dubbel weergeven.

 Toestel GA
az dt twin relationship show

Details van een digitale dubbelrelatie weergeven.

 Toestel GA
az dt twin relationship update

Hiermee worden de eigenschappen van een relatie tussen twee digitale dubbels bijgewerkt via de JSON-patchspecificatie.

 Toestel GA

az dt twin relationship create

Maak een relatie tussen de digitale dubbels van de bron en het doel.

--properties kunnen 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 dubbels.

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 dubbels met if-none-match-tag

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 geïnitialiseerde eigenschappen tussen twee digitale dubbels.

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

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

--kind --relationship

Naam of soort relatie. Bijvoorbeeld: 'contains'.

--relationship-id -r

Relatie-id.

--source --twin-id -t

De brondubbel-id voor een relatie.

--target --target-twin-id

De doeldubbel-id voor een relatie.

Optionele parameters

--if-none-match

Geeft aan dat de maakbewerking moet mislukken als er een bestaande dubbel met dezelfde id bestaat.

standaardwaarde: False
--properties -p

Initiële eigenschapswaarden voor het instantiëren van een digitale dubbelrelatie. Geef bestandspad of inline-JSON op.

--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 twin relationship delete

Een digitale dubbelrelatie op een Digital Twins-exemplaar verwijderen.

az dt twin relationship delete --dt-name
                               --relationship-id
                               --source
                               [--etag]
                               [--resource-group]

Voorbeelden

Een digitale dubbelrelatie verwijderen.

az dt twin relationship delete -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id}

Een digitale dubbelrelatie verwijderen 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

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

--relationship-id -r

Relatie-id.

--source --twin-id -t

De brondubbel-id voor een relatie.

Optionele parameters

--etag -e

Waarde van entiteitstag. De opdracht slaagt als de etag overeenkomt met de huidige etag voor de resource.

--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 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 digitale dubbelrelaties die aan de dubbel zijn gekoppeld.

az dt twin relationship delete-all -n {instance_or_hostname} --twin-id {twin_id}

Verwijder alle digitale dubbelrelaties in de Digital Twins-bedreiging.

az dt twin relationship 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>.

--source --twin-id -t

De brondubbel-id voor een relatie.

--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 twin relationship list

De relaties van een digitale dubbel weergeven.

az dt twin relationship list --dt-name
                             --source
                             [--incoming {false, true}]
                             [--kind]
                             [--resource-group]

Voorbeelden

Lijst met uitgaande relaties van een digitale dubbel.

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id}

Uitgaande relaties van een digitale dubbel weergeven en filteren op relatie 'contains'

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id} --relationship contains

Hiermee worden binnenkomende relaties van een digitale dubbel weergegeven.

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id} --incoming

Geef binnenkomende relaties van een digitale dubbel weer en filter op relatie 'contains'.

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id} --relationship contains --incoming

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.

--source --twin-id -t

De brondubbel-id voor een relatie.

Optionele parameters

--incoming

Haalt alle binnenkomende relaties voor een digitale dubbel op.

geaccepteerde waarden: false, true
standaardwaarde: False
--kind --relationship

Filter het resultaat op het soort relatie.

--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 twin relationship show

Details van een digitale dubbelrelatie weergeven.

az dt twin relationship show --dt-name
                             --relationship-id
                             --source
                             [--resource-group]

Voorbeelden

Details van een digitale dubbelrelatie weergeven.

az dt twin relationship show -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id}

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.

--relationship-id -r

Relatie-id.

--source --twin-id -t

De brondubbel-id voor een relatie.

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 twin relationship update

Hiermee worden de eigenschappen van een relatie tussen twee digitale dubbels bijgewerkt via de 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 digitale dubbelrelatie 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 digitale dubbelrelatie bij via de JSON-patchspecificatie en het gebruik 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 digitale dubbelrelatie 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 digitale dubbelrelatie bij via de JSON-patchspecificatie die is gedefinieerd in een bestand.

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

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

--json-patch --patch

Een updatespecificatie die wordt beschreven door JSON-patch. Updates voor eigenschapswaarden en $model elementen kunnen plaatsvinden in dezelfde aanvraag. Bewerkingen zijn beperkt tot toevoegen, vervangen en verwijderen. Geef bestandspad of inline-JSON op.

--relationship-id -r

Relatie-id.

--source --twin-id -t

De brondubbel-id voor een relatie.

Optionele parameters

--etag -e

Waarde van entiteitstag. De opdracht slaagt als de etag overeenkomt met de huidige etag voor de resource.

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