az dt twin

Note

This reference is part of the azure-iot extension for the Azure CLI (version 2.59.0 or higher). De extensie installeert automatisch de eerste keer dat u een opdracht az dt twin uitvoert. Learn more about extensions.

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

Opdracht

Name	Description	Type	Status
az dt twin component	De digitale dubbelonderdelen van een Digital Twins-exemplaar weergeven en bijwerken.	Extension	GA
az dt twin component show	Details van een digital twin-onderdeel weergeven.	Extension	GA
az dt twin component update	Werk een digital twin-onderdeel bij via de JSON-patchspecificatie.	Extension	GA
az dt twin create	Maak een digitale dubbel op een exemplaar.	Extension	GA
az dt twin delete	Een digitale dubbel verwijderen. Alle relaties die naar deze dubbel verwijzen, moeten al worden verwijderd.	Extension	GA
az dt twin delete-all	Hiermee verwijdert u alle digitale dubbels binnen een Digital Twins-exemplaar, inclusief alle relaties voor die tweelingen.	Extension	GA
az dt twin query	Voer een query uit op de digitale dubbels van een exemplaar. Hiermee staat u doorkruisingsrelaties toe en filtert u op eigenschapswaarden.	Extension	GA
az dt twin relationship	Beheer en configureer de digitale dubbelrelaties van een Digital Twins-exemplaar.	Extension	GA
az dt twin relationship create	Maak een relatie tussen de digitale dubbels van de bron en het doel.	Extension	GA
az dt twin relationship delete	Een digitale dubbelrelatie op een Digital Twins-exemplaar verwijderen.	Extension	GA
az dt twin relationship delete-all	Hiermee verwijdert u alle digitale dubbelrelaties binnen een Digital Twins-exemplaar, inclusief binnenkomende relaties.	Extension	GA
az dt twin relationship list	De relaties van een digitale dubbel weergeven.	Extension	GA
az dt twin relationship show	Details van een digitale dubbelrelatie weergeven.	Extension	GA
az dt twin relationship update	Hiermee worden de eigenschappen van een relatie tussen twee digitale dubbels bijgewerkt via de JSON-patchspecificatie.	Extension	GA
az dt twin show	De details van een digitale dubbel weergeven.	Extension	GA
az dt twin telemetry	Test en valideer de gebeurtenisroutes en eindpunten van een Digital Twins-exemplaar.	Extension	GA
az dt twin telemetry send	Verzendt telemetrie namens een digitale dubbel. Als het onderdeelpad wordt opgegeven, is de verzonden telemetrie namens het onderdeel.	Extension	GA
az dt twin update	Werk een digitale exemplaardubbel bij via de JSON-patchspecificatie.	Extension	GA

az dt twin create

Maak een digitale dubbel op een exemplaar.

--properties kunnen inline JSON of bestandspad zijn. Opmerking: --eigenschappen zijn vereist voor tweelingen die onderdelen bevatten.

az dt twin create --dt-name --dtn
                  --dtmi --model-id
                  --twin-id
                  [--if-none-match]
                  [--properties]
                  [--resource-group]

Voorbeelden

Maak een digitale dubbel op basis van een bestaand (vooraf gemaakt) model.

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:Room;1" --twin-id {twin_id}

Maak een digitale dubbel op basis van een bestaand (vooraf 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 dubbel op basis van een bestaand (vooraf 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 dubbel met een onderdeel op basis van bestaande (vooraf gemaakte) modellen. Instantieer een onderdeel 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 dubbel met een onderdeel op basis van bestaande (vooraf 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

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.

--dtmi --model-id -m

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

--twin-id -t

De digitale dubbel-id.

Optionele parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--if-none-match

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

Eigenschap	Waarde
Default value:	False

--properties -p

Initiële eigenschapswaarden voor het instantiëren van een digitale dubbel of gerelateerde onderdelen. Geef bestandspad of inline-JSON op. Eigenschappen zijn vereist voor dubbels die onderdelen bevatten. U moet minimaal een leeg $metadata-object opgeven voor elk onderdeel.

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

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Output format.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van 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.

Eigenschap	Waarde
Default value:	False

az dt twin delete

Een digitale dubbel verwijderen. Alle relaties die naar deze dubbel verwijzen, moeten al worden verwijderd.

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

Voorbeelden

Verwijder een digitale dubbel op id.

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

Verwijder een digitale dubbel met 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

--twin-id -t

De digitale dubbel-id.

Optionele parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Output format.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van 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.

Eigenschap	Waarde
Default value:	False

az dt twin delete-all

Hiermee verwijdert u alle digitale dubbels binnen een Digital Twins-exemplaar, inclusief alle relaties voor die tweelingen.

az dt twin delete-all --dt-name --dtn
                      [--resource-group]
                      [--yes]

Voorbeelden

Verwijder alle digitale dubbels. Alle relaties die naar de tweelingen verwijzen, worden ook verwijderd.

az dt twin delete-all -n {instance_or_hostname}

Vereiste parameters

--dt-name --dtn -n

Optionele parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

Resourcegroep voor Digital Twins-exemplaren. U kunt de standaardgroep configureren met behulp van az configure --defaults group={name}.

--yes -y

Niet vragen om bevestiging.

Eigenschap	Waarde
Default value:	False

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Output format.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van 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.

Eigenschap	Waarde
Default value:	False

az dt twin query

Voer een query uit op de digitale dubbels van een exemplaar. Hiermee staat u doorkruisingsrelaties toe en filtert u op eigenschapswaarden.

In veel dubbelquery's wordt het $ teken gebruikt om te verwijzen naar de eigenschap $dtId van een dubbel. In bash-achtige shells of PowerShell heeft het $ teken functionele betekenis en moet worden ontsnapt als onderdeel van de queryinvoer. Raadpleeg het document over concepten van Digital Twins CLI https://learn.microsoft.com/en-us/azure/digital-twins/concepts-cli voor meer informatie.

az dt twin query --dt-name --dtn
                 --query-command
                 [--cost --show-cost {false, true}]
                 [--resource-group]

Voorbeelden

Voer een query uit op alle digitale dubbels in het doelexemplaren en project alle kenmerken. Ook kosten weergeven in query-eenheden.

az dt twin query -n {instance_or_hostname} -q "select * from digitaltwins" --show-cost

Voer een query uit op model en project 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')"

Query die gebruikmaakt van '$dtId' met bash-compatibele syntaxis

az dt twin query -n {instance_or_hostname} --query-command "SELECT * FROM DigitalTwins T Where T.\$dtId = 'room0'"

Query die gebruikmaakt van '$dtId' met de syntaxis die compatibel is met PowerShell

az dt twin query -n {instance_or_hostname} --query-command "SELECT * FROM DigitalTwins T Where T.`$dtId = 'room0'"

Vereiste parameters

--dt-name --dtn -n

--query-command -q

Gebruikersquery die moet worden uitgevoerd.

Optionele parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--cost --show-cost

Berekent en toont de querykosten.

Eigenschap	Waarde
Default value:	False
Geaccepteerde waarden:	false, true

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

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Output format.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van 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.

Eigenschap	Waarde
Default value:	False

az dt twin show

De details van een digitale dubbel weergeven.

az dt twin show --dt-name --dtn
                --twin-id
                [--resource-group]

Voorbeelden

De details van een digitale dubbel weergeven.

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

Vereiste parameters

--dt-name --dtn -n

--twin-id -t

De digitale dubbel-id.

Optionele parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Output format.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van 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.

Eigenschap	Waarde
Default value:	False

az dt twin update

Werk een digitale exemplaardubbel bij via de JSON-patchspecificatie.

Updates voor eigenschapswaarden en $model elementen kunnen plaatsvinden in dezelfde aanvraag. Bewerkingen zijn beperkt tot toevoegen, vervangen en verwijderen.

az dt twin update --dt-name --dtn
                  --json-patch --patch
                  --twin-id
                  [--etag]
                  [--resource-group]

Voorbeelden

Werk een digitale dubbel bij via de JSON-patchspecificatie.

az dt twin update -n {instance_or_hostname} --twin-id {twin_id} --json-patch '{"op":"replace", "path":"/Temperature", "value": 20.5}'

Werk een digitale dubbel bij via de JSON-patchspecificatie en met behulp van etag.

az dt twin update -n {instance_or_hostname} --twin-id {twin_id} --etag {etag} --json-patch '{"op":"replace", "path":"/Temperature", "value": 20.5}'

Werk een digitale dubbel bij via de 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"]}
]'

Werk een digitale dubbel bij via de JSON-patchspecificatie die is gedefinieerd in een bestand.

az dt twin update -n {instance_or_hostname} --twin-id {twin_id} --json-patch ./my/patch/document.json

Vereiste parameters

--dt-name --dtn -n

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

--twin-id -t

De digitale dubbel-id.

Optionele parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Output format.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van 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.

Eigenschap	Waarde
Default value:	False

Delen via

az dt twin

Opdracht

az dt twin create

Voorbeelden

Vereiste parameters

Optionele parameters

az dt twin delete

Voorbeelden

Vereiste parameters

Optionele parameters

az dt twin delete-all

Voorbeelden

Vereiste parameters

Optionele parameters

az dt twin query

Voorbeelden

Vereiste parameters

Optionele parameters

az dt twin show

Voorbeelden

Vereiste parameters

Optionele parameters

az dt twin update

Voorbeelden

Vereiste parameters

Optionele parameters

Feedback