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

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

--dtmi --model-id -m

Digital Twins model-id. Voorbeeld: dtmi:com:example:Room;2.

--twin-id -t

De id van de digitale tweeling.

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

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

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

--twin-id -t

De id van de digitale tweeling.

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

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

--yes -y

Niet vragen om bevestiging.

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

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

--query-command -q

Gebruikersquery die moet worden uitgevoerd.

Optionele parameters

--cost --show-cost

Berekent en toont de querykosten.

geaccepteerde waarden: false, true
--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 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

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

--twin-id -t

De id van de digitale tweeling.

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

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

--twin-id -t

De id van de digitale tweeling.

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 .