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

--cn --command-name

Digital Twin-opdrachtnaam.

--device-id -d

Doelapparaat.

Optionele parameters

--component-path

Pad naar digital twin-onderdelen. Bijvoorbeeld: thermostat1.

--connect-timeout --cto

Maximale tijdsinterval, in seconden, dat IoT Hub probeert verbinding te maken met het apparaat.

--hub-name -n

IoT Hub naam.

--login -l

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.

--payload

Invoer van JSON-nettolading voor opdracht. Geef het bestandspad of inline JSON op.

standaardwaarde: {}
--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

--response-timeout --rto

Maximuminterval in seconden dat de digital twin-opdracht op het resultaat wacht.

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

--device-id -d

Doelapparaat.

Optionele parameters

--hub-name -n

IoT Hub naam.

--login -l

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.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

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

--device-id -d

Doelapparaat.

--json-patch --patch

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

Etag of entiteitstag die overeenkomt met de laatste status van de resource. Als er geen etag wordt opgegeven, wordt de waarde * ' ' gebruikt.

--hub-name -n

IoT Hub naam.

--login -l

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.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .