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

--dt-name --dtn -n

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.

--kind --relationship

Naam of soort relatie. Bijvoorbeeld: 'contains'.

--relationship-id -r

Relatie-id.

--source --twin-id -t

De bron-dubbel-id voor een relatie.

--target --target-twin-id

De doel dubbel-id voor een relatie.

Optionele parameters

--if-none-match

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

--properties -p

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

--resource-group -g

Digital Twins resourcegroep van het exemplaar. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

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

--dt-name --dtn -n

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.

--relationship-id -r

Relatie-id.

--source --twin-id -t

De bron-dubbel-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

Digital Twins resourcegroep van het exemplaar. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

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

--dt-name --dtn -n

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

--resource-group -g

Digital Twins resourcegroep van het exemplaar. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

--source --twin-id -t

De bron-dubbel-id voor een relatie.

--yes -y

Niet vragen om bevestiging.

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

--dt-name --dtn -n

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.

--source --twin-id -t

De bron-dubbel-id voor een relatie.

Optionele parameters

--incoming

Hiermee worden alle binnenkomende relaties voor een digitale tweeling opgehaald.

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

Filter het resultaat op het soort relatie.

--resource-group -g

Digital Twins resourcegroep van het exemplaar. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

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

--dt-name --dtn -n

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.

--relationship-id -r

Relatie-id.

--source --twin-id -t

De bron-dubbel-id voor een relatie.

Optionele parameters

--resource-group -g

Digital Twins resourcegroep van het exemplaar. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

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

--dt-name --dtn -n

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.

--json-patch --patch

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.

--relationship-id -r

Relatie-id.

--source --twin-id -t

De bron-dubbel-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

Digital Twins resourcegroep van het exemplaar. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .