Delen via


az iot central device twin

Notitie

Deze verwijzing maakt deel uit van de Azure-iot-extensie voor de Azure CLI (versie 2.46.0 of hoger). De extensie installeert automatisch de eerste keer dat u een az iot central device twin-opdracht uitvoert. Meer informatie over extensies.

IoT Central-apparaatdubbels beheren.

Opdracht

Name Description Type Status
az iot central device twin replace

Vervang beschrijfbare eigenschapswaarden van een apparaat, een apparaatonderdeel of een apparaatmodule of een apparaatmoduleonderdeel.

Toestel GA
az iot central device twin show

Haal alle eigenschapswaarden van een apparaat, een apparaatonderdeel, een apparaatmodule of een apparaatmoduleonderdeel op.

Toestel GA
az iot central device twin update

Beschrijfbare eigenschapswaarden van een apparaat, een apparaatonderdeel, een apparaatmodule of een onderdeel van een apparaatmodule bijwerken.

Toestel GA

az iot central device twin replace

Vervang beschrijfbare eigenschapswaarden van een apparaat, een apparaatonderdeel of een apparaatmodule of een apparaatmoduleonderdeel.

Het opgeven van --component-name, --module-name of beide om eigenschappen van apparaatonderdelen, eigenschappen van apparaatmodules of eigenschappen van apparaatmoduleonderdelen te vervangen.

az iot central device twin replace --app-id
                                   --content
                                   --device-id
                                   [--api-version {2022-06-30-preview, 2022-07-31}]
                                   [--central-api-uri]
                                   [--co]
                                   [--mn]
                                   [--token]

Voorbeelden

Apparaateigenschappen vervangen

az iot central device twin replace --app-id {appid} --device-id {deviceid} -k {content}

Eigenschappen van apparaatonderdelen vervangen

az iot central device twin replace --app-id {appid} --device-id {deviceid} --co {componentname} -k {content}

Eigenschappen van apparaatmoduleonderdelen vervangen

az iot central device twin replace --app-id {appid} --device-id {deviceid} --mn {modulename} --co {componentname} -k {content}

Vereiste parameters

--app-id -n

De app-id van de IoT Central-app die u wilt beheren. U vindt de app-id op de pagina Info voor uw toepassing onder het menu Help.

--content -k

Configuratie voor aanvraag. Geef het pad naar het JSON-bestand of onbewerkte JSON op. [Voorbeeld van bestandspad: ./path/to/file.json] [Tekenreeks-JSON-voorbeeld: {'a': 'b'}].

--device-id -d

De apparaat-id van het doelapparaat. U vindt de apparaat-id door op de knop Verbinding maken te klikken op de pagina Apparaatdetails.

Optionele parameters

--api-version --av
Afgeschaft

Het argument 'api_version' is afgeschaft en wordt in een toekomstige release verwijderd.

Deze opdrachtparameter is afgeschaft en wordt genegeerd. In de toekomstige release ondersteunen we alleen IoT Central-API's van de nieuwste GA-versie. Als er nog geen API beschikbaar is, roepen we de nieuwste preview-versie aan.

geaccepteerde waarden: 2022-06-30-preview, 2022-07-31
standaardwaarde: 2022-07-31
--central-api-uri --central-dns-suffix

Het DNS-achtervoegsel ioT Central dat is gekoppeld aan uw toepassing.

standaardwaarde: azureiotcentral.com
--co --component-name

De naam van het apparaatonderdeel.

--mn --module-name

De naam van de apparaatmodule.

--token

Als u liever uw aanvraag indient zonder verificatie bij de Azure CLI, kunt u een geldig gebruikerstoken opgeven om uw aanvraag te verifiëren. U moet het type sleutel opgeven als onderdeel van de aanvraag. Meer informatie op https://aka.ms/iotcentraldocsapi.

Globale parameters
--debug

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

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

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

--subscription

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

az iot central device twin show

Haal alle eigenschapswaarden van een apparaat, een apparaatonderdeel, een apparaatmodule of een apparaatmoduleonderdeel op.

Geef --component-name, --module-name of beide op om eigenschappen van apparaatonderdelen, eigenschappen van apparaatmodules of eigenschappen van apparaatmoduleonderdelen op te halen.

az iot central device twin show --app-id
                                --device-id
                                [--api-version {2022-06-30-preview, 2022-07-31}]
                                [--central-api-uri]
                                [--co]
                                [--mn]
                                [--token]

Voorbeelden

Apparaateigenschappen ophalen

az iot central device twin show --app-id {appid} --device-id {deviceid}

Eigenschappen van apparaatonderdelen ophalen

az iot central device twin show --app-id {appid} --device-id {deviceid} --co {componentname}

Eigenschappen van apparaatmoduleonderdelen ophalen

az iot central device twin show --app-id {appid} --device-id {deviceid} --mn {modulename} --co {componentname}

Vereiste parameters

--app-id -n

De app-id van de IoT Central-app die u wilt beheren. U vindt de app-id op de pagina Info voor uw toepassing onder het menu Help.

--device-id -d

De apparaat-id van het doelapparaat. U vindt de apparaat-id door op de knop Verbinding maken te klikken op de pagina Apparaatdetails.

Optionele parameters

--api-version --av
Afgeschaft

Het argument 'api_version' is afgeschaft en wordt in een toekomstige release verwijderd.

Deze opdrachtparameter is afgeschaft en wordt genegeerd. In de toekomstige release ondersteunen we alleen IoT Central-API's van de nieuwste GA-versie. Als er nog geen API beschikbaar is, roepen we de nieuwste preview-versie aan.

geaccepteerde waarden: 2022-06-30-preview, 2022-07-31
standaardwaarde: 2022-07-31
--central-api-uri --central-dns-suffix

Het DNS-achtervoegsel ioT Central dat is gekoppeld aan uw toepassing.

standaardwaarde: azureiotcentral.com
--co --component-name

De naam van het apparaatonderdeel.

--mn --module-name

De naam van de apparaatmodule.

--token

Als u liever uw aanvraag indient zonder verificatie bij de Azure CLI, kunt u een geldig gebruikerstoken opgeven om uw aanvraag te verifiëren. U moet het type sleutel opgeven als onderdeel van de aanvraag. Meer informatie op https://aka.ms/iotcentraldocsapi.

Globale parameters
--debug

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

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

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

--subscription

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

az iot central device twin update

Beschrijfbare eigenschapswaarden van een apparaat, een apparaatonderdeel, een apparaatmodule of een onderdeel van een apparaatmodule bijwerken.

Het opgeven van --component-name, --module-name of beide om eigenschappen van apparaatonderdelen, eigenschappen van apparaatmodules of eigenschappen van apparaatmoduleonderdelen bij te werken.

az iot central device twin update --app-id
                                  --content
                                  --device-id
                                  [--api-version {2022-06-30-preview, 2022-07-31}]
                                  [--central-api-uri]
                                  [--co]
                                  [--mn]
                                  [--token]

Voorbeelden

Apparaateigenschappen bijwerken

az iot central device twin update --app-id {appid} --device-id {deviceid} -k {content}

Eigenschappen van apparaatonderdelen bijwerken

az iot central device twin update --app-id {appid} --device-id {deviceid} --co {componentname} -k {content}

Eigenschappen van apparaatmoduleonderdelen bijwerken

az iot central device twin update --app-id {appid} --device-id {deviceid} --mn {modulename} --co {componentname} -k {content}

Vereiste parameters

--app-id -n

De app-id van de IoT Central-app die u wilt beheren. U vindt de app-id op de pagina Info voor uw toepassing onder het menu Help.

--content -k

Configuratie voor aanvraag. Geef het pad naar het JSON-bestand of onbewerkte JSON op. [Voorbeeld van bestandspad: ./path/to/file.json] [Tekenreeks-JSON-voorbeeld: {'a': 'b'}].

--device-id -d

De apparaat-id van het doelapparaat. U vindt de apparaat-id door op de knop Verbinding maken te klikken op de pagina Apparaatdetails.

Optionele parameters

--api-version --av
Afgeschaft

Het argument 'api_version' is afgeschaft en wordt in een toekomstige release verwijderd.

Deze opdrachtparameter is afgeschaft en wordt genegeerd. In de toekomstige release ondersteunen we alleen IoT Central-API's van de nieuwste GA-versie. Als er nog geen API beschikbaar is, roepen we de nieuwste preview-versie aan.

geaccepteerde waarden: 2022-06-30-preview, 2022-07-31
standaardwaarde: 2022-07-31
--central-api-uri --central-dns-suffix

Het DNS-achtervoegsel ioT Central dat is gekoppeld aan uw toepassing.

standaardwaarde: azureiotcentral.com
--co --component-name

De naam van het apparaatonderdeel.

--mn --module-name

De naam van de apparaatmodule.

--token

Als u liever uw aanvraag indient zonder verificatie bij de Azure CLI, kunt u een geldig gebruikerstoken opgeven om uw aanvraag te verifiëren. U moet het type sleutel opgeven als onderdeel van de aanvraag. Meer informatie op https://aka.ms/iotcentraldocsapi.

Globale parameters
--debug

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

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

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

--subscription

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