az iot hub digital-twin
Notitie
Deze verwijzing 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 iot hub digital-twin voor het eerst hebt uitgevoerd. Meer informatie over extensies.
De digitale dubbel van een apparaat met IoT Hub bewerken en gebruiken.
Opdracht
| az iot hub digital-twin invoke-command |
Roep een opdracht op hoofd- of onderdeelniveau aan van een digital twin-apparaat. |
| az iot hub digital-twin show |
De digitale dubbel van een IoT Hub apparaat. |
| az iot hub digital-twin update |
Werk de lees-/schrijfeigenschappen van een digital twin-apparaat bij via de JSON-patchspecificatie. |
az iot hub digital-twin invoke-command
Roep een opdracht op hoofd- of onderdeelniveau aan van een digital twin-apparaat.
az iot hub digital-twin invoke-command --cn
--device-id
[--component-path]
[--connect-timeout]
[--hub-name]
[--login]
[--payload]
[--resource-group]
[--response-timeout]
Voorbeelden
Roep de opdracht 'opnieuw opstarten' op hoofdniveau aan. Hierbij wordt een nettolading met de eigenschap 'delay' aanroepen.
az iot hub digital-twin invoke-command --command-name reboot -n {iothub_name} -d {device_id} --payload '{"delay":5}'
Roep de opdracht getMaxMinReport aan voor het onderdeel thermostat1 dat geen invoer gebruikt.
az iot hub digital-twin invoke-command --cn getMaxMinReport -n {iothub_name} -d {device_id} --component-path thermostat1
Vereiste parameters
Digital Twin-opdrachtnaam.
Doelapparaat.
Optionele parameters
Pad naar digital twin-onderdelen. Bijvoorbeeld: thermostat1.
Maximale tijdsinterval, in seconden, dat IoT Hub probeert verbinding te maken met het apparaat.
IoT Hub naam.
Deze opdracht ondersteunt een entiteitsgroep connection string rechten om actie uit te voeren. Gebruik om sessie-aanmelding via 'az login' te voorkomen. Als zowel een entiteits-connection string als de naam zijn opgegeven, heeft connection string prioriteit.
Invoer van JSON-nettolading voor opdracht. Geef het bestandspad of inline JSON op.
De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .
Maximuminterval in seconden dat de digital twin-opdracht op het resultaat wacht.
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 iot hub digital-twin show
De digitale dubbel van een IoT Hub apparaat.
az iot hub digital-twin show --device-id
[--hub-name]
[--login]
[--resource-group]
Voorbeelden
De digitale dubbel van het doelapparaat tonen.
az iot hub digital-twin show -n {iothub_name} -d {device_id}
Vereiste parameters
Doelapparaat.
Optionele parameters
IoT Hub naam.
Deze opdracht ondersteunt een entiteitsgroep connection string rechten om actie uit te voeren. Gebruik om sessie-aanmelding via 'az login' te voorkomen. Als zowel een entiteits-connection string als de naam zijn opgegeven, heeft connection string prioriteit.
De naam van de resourcegroep. 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 iot hub digital-twin update
Werk de lees-/schrijfeigenschappen van een digital twin-apparaat bij via de JSON-patchspecificatie.
Momenteel zijn bewerkingen beperkt tot toevoegen, vervangen en verwijderen.
az iot hub digital-twin update --device-id
--json-patch
[--etag]
[--hub-name]
[--login]
[--resource-group]
Voorbeelden
Een digitale tweeling bijwerken via JSON-patchspecificatie.
az iot hub digital-twin update --hub-name {iothub_name} --device-id {device_id} --json-patch '{"op":"add", "path":"/thermostat1/targetTemperature", "value": 54}'
Een digitale tweeling bijwerken via JSON-patchspecificatie.
az iot hub digital-twin update -n {iothub_name} -d {device_id} --json-patch '[
{"op":"remove", "path":"/thermostat1/targetTemperature"},
{"op":"add", "path":"/thermostat2/targetTemperature", "value": 22}
]'
Werk een digital twin-eigenschap bij via de JSON-patchspecificatie die in een bestand is gedefinieerd.
az iot hub digital-twin update -n {iothub_name} -d {device_id} --json-patch ./my/patch/document.json
Vereiste parameters
Doelapparaat.
Een updatespecificatie die wordt beschreven door JSON-patch. Bewerkingen zijn beperkt tot toevoegen, vervangen en verwijderen. Geef het bestandspad of inline JSON op.
Optionele parameters
Etag of entiteitstag die overeenkomt met de laatste status van de resource. Als er geen etag wordt opgegeven, wordt de waarde * ' ' gebruikt.
IoT Hub naam.
Deze opdracht ondersteunt een entiteitsgroep connection string rechten om actie uit te voeren. Gebruik om sessie-aanmelding via 'az login' te voorkomen. Als zowel een entiteits-connection string als de naam zijn opgegeven, heeft connection string prioriteit.
De naam van de resourcegroep. 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.