Delen via

az iot central device twin

Note

Deze verwijzing maakt deel uit van de Azure-iot-extensie voor de Azure CLI (versie 2.67.0 of hoger). De extensie wordt automatisch geïnstalleerd wanneer u een az iot central device twin opdracht uitvoert. Meer informatie over uitbreidingen.

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.

 Extension GA
az iot central device twin show

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

 Extension GA
az iot central device twin update

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

 Extension 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 --av {2022-06-30-preview, 2022-07-31}]
                                   [--central-api-uri --central-dns-suffix]
                                   [--co --component-name]
                                   [--mn --module-name]
                                   [--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

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

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

Eigenschap Waarde
Default value: 2022-07-31
Geaccepteerde waarden: 2022-06-30-preview, 2022-07-31
--central-api-uri --central-dns-suffix

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

Eigenschap Waarde
Default value: 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 vindt u op https://aka.ms/iotcentraldocsapi.

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

Uitvoerindeling.

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 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 --av {2022-06-30-preview, 2022-07-31}]
                                [--central-api-uri --central-dns-suffix]
                                [--co --component-name]
                                [--mn --module-name]
                                [--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

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

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

Eigenschap Waarde
Default value: 2022-07-31
Geaccepteerde waarden: 2022-06-30-preview, 2022-07-31
--central-api-uri --central-dns-suffix

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

Eigenschap Waarde
Default value: 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 vindt u op https://aka.ms/iotcentraldocsapi.

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

Uitvoerindeling.

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 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 --av {2022-06-30-preview, 2022-07-31}]
                                  [--central-api-uri --central-dns-suffix]
                                  [--co --component-name]
                                  [--mn --module-name]
                                  [--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

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

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

Eigenschap Waarde
Default value: 2022-07-31
Geaccepteerde waarden: 2022-06-30-preview, 2022-07-31
--central-api-uri --central-dns-suffix

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

Eigenschap Waarde
Default value: 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 vindt u op https://aka.ms/iotcentraldocsapi.

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

Uitvoerindeling.

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