az iot central device

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 central device voor het eerst gebruikt. Meer informatie over extensies.

Beheer en configureer IoT Central apparaten.

Opdracht

az iot central device command

Voer apparaatopdrachten uit.

az iot central device command history

Haal de details op voor de meest recente opdrachtaanvraag en het meest recente antwoord dat naar het apparaat is verzonden.

az iot central device command run

Voer een opdracht uit op een apparaat en bekijk het bijbehorende antwoord. De updates van eigenschappen die de opdracht kan uitvoeren, worden NIET bewaakt.

az iot central device compute-device-key

Genereer een AFGELEIDE SAS-sleutel voor het apparaat.

az iot central device create

Maak een apparaat in IoT Central.

az iot central device delete

Verwijder een apparaat uit IoT Central.

az iot central device manual-failback

De eerder uitgevoerde failover-opdracht wordt terugverdraaid door het apparaat terug te verplaatsen naar de oorspronkelijke IoT Hub.

az iot central device manual-failover

Voer een handmatige failover van het apparaat uit op meerdere IoT Hubs om te valideren of de apparaatfirmware opnieuw verbinding kan maken met behulp van DPS met een IoT Hub.

az iot central device registration-info

U kunt registratiegegevens op een of meer apparaten op IoT Central.

az iot central device show

Haal een apparaat op uit IoT Central.

az iot central device show-credentials

Haal apparaatreferenties op uit IoT Central.

az iot central device twin

Apparaattweeling IoT Central beheren.

az iot central device twin show

Haal de apparaat dubbel op uit IoT Hub.

az iot central device compute-device-key

Genereer een AFGELEIDE SAS-sleutel voor het apparaat.

Genereer een afgeleide apparaatsleutel op basis van een SAS-sleutel op groepsniveau.

az iot central device compute-device-key --device-id
                                         --pk

Voorbeelden

Basisgebruik

az iot central device compute-device-key --pk {primaryKey} --device-id {deviceid}

Vereiste parameters

--device-id -d

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

--pk --primary-key

De primaire symmetrische gedeelde toegangssleutel die is opgeslagen in base64-indeling.

az iot central device create

Maak een apparaat in IoT Central.

az iot central device create --app-id
                             --device-id
                             [--api-version {1.0, preview}]
                             [--central-api-uri]
                             [--device-name]
                             [--simulated {false, true}]
                             [--template]
                             [--token]

Voorbeelden

Een apparaat maken

az iot central device create --app-id {appid} --device-id {deviceid}

Een gesimuleerd apparaat maken

az iot central device create --app-id {appid} --device-id {deviceid} --template {devicetemplateid} --simulated

Vereiste parameters

--app-id -n

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

--device-id -d

Geef een unieke id op voor het apparaat. Een hoofd-gevoelige tekenreeks (maximaal 128 tekens lang) van 7-bits ASCII-alfanumerieke tekens plus bepaalde speciale tekens: - . + % _ # * ? ! ( ) , : = @ $ '.

Optionele parameters

--api-version --av

De API-versie voor de aangevraagde bewerking.

geaccepteerde waarden: 1.0, preview
standaardwaarde: 1.0
--central-api-uri --central-dns-suffix

Het IoT Central DNS-achtervoegsel dat is gekoppeld aan uw toepassing. De standaardwaarde is: azureiotcentral.com.

standaardwaarde: azureiotcentral.com
--device-name

Door mensen leesbare apparaatnaam. Voorbeeld: Gededer.

--simulated

Voeg deze vlag toe als u dit IoT Central als een gesimuleerd apparaat wilt instellen. --template is vereist als dit waar is.

geaccepteerde waarden: false, true
--template

Centrale sjabloon-id. Voorbeeld: dtmi:hebtpkindbz:modelDefinition:iild3tm_uo.

--token

Als u uw aanvraag liever indient zonder verificatie met de Azure CLI, kunt u een geldig gebruiker-token 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 .

az iot central device delete

Verwijder een apparaat uit IoT Central.

az iot central device delete --app-id
                             --device-id
                             [--api-version {1.0, preview}]
                             [--central-api-uri]
                             [--token]

Voorbeelden

Een apparaat verwijderen

az iot central device delete --app-id {appid} --device-id {deviceid}

Vereiste parameters

--app-id -n

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

--device-id -d

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

Optionele parameters

--api-version --av

De API-versie voor de aangevraagde bewerking.

geaccepteerde waarden: 1.0, preview
standaardwaarde: 1.0
--central-api-uri --central-dns-suffix

Het IoT Central DNS-achtervoegsel dat is gekoppeld aan uw toepassing. De standaardwaarde is: azureiotcentral.com.

standaardwaarde: azureiotcentral.com
--token

Als u uw aanvraag liever indient zonder verificatie met de Azure CLI, kunt u een geldig gebruiker-token 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 .

az iot central device manual-failback

De eerder uitgevoerde failover-opdracht wordt terugverdraaid door het apparaat terug te verplaatsen naar de oorspronkelijke IoT Hub.

Ga naar voor meer informatie over hoge https://github.com/iot-for-all/iot-central-high-availability-clients#readme beschikbaarheid.

az iot central device manual-failback --app-id
                                      --device-id
                                      [--central-api-uri]
                                      [--token]

Voorbeelden

De eerder uitgevoerde failover-opdracht wordt terugverdraaid door het apparaat terug te verplaatsen naar de oorspronkelijke IoT Hub

az iot central device manual-failback --app-id {appid} --device-id {deviceid}

Vereiste parameters

--app-id -n

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

--device-id -d

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

Optionele parameters

--central-api-uri --central-dns-suffix

Het IoT Central DNS-achtervoegsel dat is gekoppeld aan uw toepassing. De standaardwaarde is: azureiotcentral.com.

standaardwaarde: azureiotcentral.com
--token

Als u uw aanvraag liever indient zonder verificatie met de Azure CLI, kunt u een geldig gebruiker-token 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 .

az iot central device manual-failover

Voer een handmatige failover van het apparaat uit op meerdere IoT Hubs om te valideren of de apparaatfirmware opnieuw verbinding kan maken met behulp van DPS met een IoT Hub.

Ga voor meer informatie over hoge beschikbaarheid en standaardwaarde voor ttl-minuten naar https://github.com/iot-for-all/iot-central-high-availability-clients#readme .

az iot central device manual-failover --app-id
                                      --device-id
                                      [--central-api-uri]
                                      [--token]
                                      [--ttl]

Voorbeelden

Voer een handmatige failover van het apparaat uit op meerdere IoT Hubs om te valideren of de apparaatfirmware opnieuw verbinding kan maken met behulp van DPS met een IoT Hub.

az iot central device manual-failover --app-id {appid} --device-id {deviceid} --ttl-minutes {ttl_minutes}

Vereiste parameters

--app-id -n

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

--device-id -d

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

Optionele parameters

--central-api-uri --central-dns-suffix

Het IoT Central DNS-achtervoegsel dat is gekoppeld aan uw toepassing. De standaardwaarde is: azureiotcentral.com.

standaardwaarde: azureiotcentral.com
--token

Als u uw aanvraag liever indient zonder verificatie met de Azure CLI, kunt u een geldig gebruiker-token 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 .

--ttl --ttl-minutes

Een positief geheel getal. TTL in minuten om het apparaat terug te verplaatsen naar de oorspronkelijke hub. Heeft een standaardwaarde in de back-end. Zie de documentatie over wat de meest recente standaardwaarde voor time to live van de back-end is door naar te https://github.com/iot-for-all/iot-central-high-availability-clients#readme gaan.

az iot central device registration-info

U kunt registratiegegevens op een of meer apparaten op IoT Central.

Opmerking: het kan een aanzienlijke hoeveelheid tijd duren om deze opdracht te retourneren als er geen apparaat-id is opgegeven en uw app veel apparaten bevat.

az iot central device registration-info --app-id
                                        --device-id
                                        [--central-api-uri]
                                        [--token]

Voorbeelden

Registratiegegevens op het opgegeven apparaat op halen

az iot central device registration-info --app-id {appid} --device-id {deviceid}

Vereiste parameters

--app-id -n

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

--device-id -d

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

Optionele parameters

--central-api-uri --central-dns-suffix

Het IoT Central DNS-achtervoegsel dat is gekoppeld aan uw toepassing. De standaardwaarde is: azureiotcentral.com.

standaardwaarde: azureiotcentral.com
--token

Als u uw aanvraag liever indient zonder verificatie met de Azure CLI, kunt u een geldig gebruiker-token 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 .

az iot central device show

Haal een apparaat op uit IoT Central.

az iot central device show --app-id
                           --device-id
                           [--api-version {1.0, preview}]
                           [--central-api-uri]
                           [--token]

Voorbeelden

Een apparaat krijgen

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

Vereiste parameters

--app-id -n

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

--device-id -d

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

Optionele parameters

--api-version --av

De API-versie voor de aangevraagde bewerking.

geaccepteerde waarden: 1.0, preview
standaardwaarde: 1.0
--central-api-uri --central-dns-suffix

Het IoT Central DNS-achtervoegsel dat is gekoppeld aan uw toepassing. De standaardwaarde is: azureiotcentral.com.

standaardwaarde: azureiotcentral.com
--token

Als u uw aanvraag liever indient zonder verificatie met de Azure CLI, kunt u een geldig gebruiker-token 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 .

az iot central device show-credentials

Haal apparaatreferenties op uit IoT Central.

az iot central device show-credentials --app-id
                                       --device-id
                                       [--central-api-uri]
                                       [--token]

Voorbeelden

Apparaatreferenties voor een apparaat op halen

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

Vereiste parameters

--app-id -n

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

--device-id -d

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

Optionele parameters

--central-api-uri --central-dns-suffix

Het IoT Central DNS-achtervoegsel dat is gekoppeld aan uw toepassing. De standaardwaarde is: azureiotcentral.com.

standaardwaarde: azureiotcentral.com
--token

Als u uw aanvraag liever indient zonder verificatie met de Azure CLI, kunt u een geldig gebruiker-token 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 .