Dela via

Använda IoT-tillägget för Azure CLI för Azure IoT Hub enhetshantering

  • Artikel

Diagram från slutpunkt till slutpunkt

I den här artikeln får du lära dig hur du använder IoT-tillägget för Azure CLI med olika hanteringsalternativ på utvecklingsdatorn. IoT-tillägget för Azure CLI är ett IoT-tillägg med öppen källkod som lägger till funktionerna i Azure CLI. Azure CLI innehåller kommandon för att interagera med Azure Resource Manager- och hanteringsslutpunkter. Du kan till exempel använda Azure CLI för att skapa en virtuell Azure-dator eller en IoT-hubb. Med ett CLI-tillägg kan en Azure-tjänst utöka Azure CLI så att du får åtkomst till ytterligare tjänstspecifika funktioner. IoT-tillägget ger IoT-utvecklare kommandoradsåtkomst till alla funktioner för IoT Hub, IoT Edge och IoT Hub Device Provisioning Service.

Hanteringsalternativ Uppgift
Direkta metoder Få en enhet att fungera som att starta eller sluta skicka meddelanden eller starta om enheten.
Önskade egenskaper för tvilling Placera en enhet i vissa tillstånd, till exempel att ange en LED till grön eller ställa in telemetrins sändningsintervall på 30 minuter.
Rapporterade egenskaper för tvilling Hämta det rapporterade tillståndet för en enhet. Enheten rapporterar till exempel att lysdioderna blinkar nu.
Tvillingtaggar Lagra enhetsspecifika metadata i molnet. Till exempel distributionsplatsen för en varuautomat.
Frågor för enhetstvillingar Fråga alla enhetstvillingar om du vill hämta dessa tvillingar med godtyckliga villkor, till exempel att identifiera de enheter som är tillgängliga för användning.

Mer detaljerad förklaring av skillnaderna och vägledningen om hur du använder dessa alternativ finns i Vägledning för kommunikation från enhet till moln och vägledning för kommunikation från moln till enhet.

Enhetstvillingar är JSON-dokument som lagrar information om enhetstillstånd (metadata, konfigurationer och villkor). IoT Hub bevarar en enhetstvilling för varje enhet som ansluter till den. Mer information om enhetstvillingar finns i Kom igång med enhetstvillingar.

Anteckning

Den här artikeln använder den senaste versionen av Azure IoT-tillägget med namnet azure-iot. Den äldre versionen heter azure-cli-iot-ext. Du bör bara ha en version installerad åt gången. Du kan använda kommandot az extension list för att verifiera de för närvarande installerade tilläggen.

Använd az extension remove --name azure-cli-iot-ext för att ta bort den äldre versionen av tillägget.

Använd az extension add --name azure-iot för att lägga till den nya versionen av tillägget.

Om du vill se vilka tillägg som du har installerat använder du az extension list.

Anteckning

Funktionerna som beskrivs i den här artikeln är endast tillgängliga på standardnivån för IoT Hub. Mer information om nivåerna grundläggande och standard/kostnadsfri IoT Hub finns i Välj rätt IoT Hub nivå för din lösning.

Förutsättningar

  • Slutför självstudien om Raspberry Pi-onlinesimulatorn eller någon av självstudierna för enheten. Du kan till exempel gå till Raspberry Pi med Node.js eller till någon av snabbstarterna Skicka telemetri . De här artiklarna beskriver följande krav:

    • En aktiv Azure-prenumeration.
    • En Azure IoT-hubb under din prenumeration.
    • Ett klientprogram som skickar meddelanden till din Azure IoT-hubb.

  • Kontrollera att enheten körs med klientprogrammet under den här självstudien.

  • Python 2.7x eller Python 3.x

  • The Azure CLI. Om du behöver installera det läser du Installera Azure CLI. Azure CLI-versionen måste minst vara 2.0.70 eller senare. Validera med az –version.

Anteckning

Den här artikeln använder den senaste versionen av Azure IoT-tillägget med namnet azure-iot. Den äldre versionen heter azure-cli-iot-ext. Du bör bara ha en version installerad åt gången. Du kan använda kommandot az extension list för att verifiera de för närvarande installerade tilläggen.

Använd az extension remove --name azure-cli-iot-ext för att ta bort den äldre versionen av tillägget.

Använd az extension add --name azure-iot för att lägga till den nya versionen av tillägget.

Om du vill se vilka tillägg som du har installerat använder du az extension list.

  • Installera IoT-tillägget. Det enklaste sättet är att köra az extension add --name azure-iot. I IoT-tilläggets Viktigt-fil beskrivs olika sätt att installera tillägget.

Logga in på ditt Azure-konto

Logga in på ditt Azure-konto genom att köra följande kommando:

az login

Direkta metoder

az iot hub invoke-device-method --device-id <your device id> \
  --hub-name <your hub name> \
  --method-name <the method name> \
  --method-payload <the method payload>

Önskade egenskaper för enhetstvilling

Ange ett önskat egenskapsintervall = 3 000 genom att köra följande kommando:

az iot hub device-twin update -n <your hub name> \
  -d <your device id> --set properties.desired.interval=3000

Den här egenskapen kan läsas från enheten.

Rapporterade egenskaper för enhetstvilling

Hämta de rapporterade egenskaperna för enheten genom att köra följande kommando:

az iot hub device-twin show -n <your hub name> -d <your device id>

En av de tvillingrapporterade egenskaperna är $metadata.$lastUpdated, som visar senaste gången enhetsappen uppdaterade sin rapporterade egenskapsuppsättning.

Taggar för enhetstvillingar

Visa taggar och egenskaper för enheten genom att köra följande kommando:

az iot hub device-twin show --hub-name <your hub name> --device-id <your device id>

Lägg till en fältroll = temperaturfuktighet&på enheten genom att köra följande kommando:

az iot hub device-twin update \
  --hub-name <your hub name> \
  --device-id <your device id> \
  --set tags='{"role":"temperature&humidity"}'

Frågor för enhetstvillingar

Fråga enheter med en tagg av rollen = "temperaturfuktighet&" genom att köra följande kommando:

az iot hub query --hub-name <your hub name> \
  --query-command "SELECT * FROM devices WHERE tags.role = 'temperature&humidity'"

Fråga alla enheter utom de med en tagg av rollen = "temperaturfuktighet&" genom att köra följande kommando:

az iot hub query --hub-name <your hub name> \
  --query-command "SELECT * FROM devices WHERE tags.role != 'temperature&humidity'"

Nästa steg

Du har lärt dig hur du övervakar meddelanden från enhet till moln och skickar meddelanden från moln till enhet mellan din IoT-enhet och Azure IoT Hub.

Om du vill fortsätta att komma igång med Azure IoT Hub och utforska alla utökade IoT-scenarier kan du läsa följande: