Enhetsuppdatering för IoT Hub resurshantering

För att komma igång med Enhetsuppdatering måste du skapa ett konto och en instans för enhetsuppdatering och sedan ange åtkomstkontrollroller.

Krav

Azure-portalen

En IoT-hubb. Vi rekommenderar att du använder en S1-nivå (Standard) eller senare.

Azure CLI

• En IoT-hubb. Vi rekommenderar att du använder en S1-nivå (Standard) eller senare.

• En Azure CLI-miljö:

  • Använd Bash-miljön i Azure Cloud Shell.

    

  • Eller om du föredrar att köra CLI-referenskommandon lokalt installerar du Azure CLI

    • Logga in på Azure CLI med kommandot az login .

    • Kör az version om du vill hitta versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.

    • När du uppmanas till det installerar du Azure CLI-tillägg vid första användningen. Kommandona i den här artikeln använder azure-iot-tillägget . Kör az extension update --name azure-iot för att kontrollera att du använder den senaste versionen av tillägget.

Skapa ett enhetsuppdateringskonto och en instans

Azure-portalen

1. I Azure Portal väljer du Skapa en resurs och söker efter "Enhetsuppdatering för IoT Hub"

   

2. Välj Skapa>enhetsuppdatering för IoT Hub

3. På fliken Grundläggande anger du följande information för ditt enhetsuppdateringskonto :

   • Prenumeration: Den Azure-prenumeration som ska associeras med ditt enhetsuppdateringskonto.
   • Resursgrupp: En befintlig eller ny resursgrupp.
   • Namn: Ett namn på ditt konto.
   • Plats: Den Azure-region där ditt konto ska finnas. Information om vilka regioner som stöder enhetsuppdatering för IoT Hub finns på sidan Azure Products-by-region.

   Anteckning

   Ditt enhetsuppdateringskonto behöver inte finnas i samma region som dina IoT-hubbar, men för bättre prestanda rekommenderar vi att du håller dem geografiskt nära.

   

4. Du kan också markera kryssrutan för att tilldela administratörsrollen Enhetsuppdatering till dig själv. Du kan också använda stegen i avsnittet Konfigurera åtkomstkontrollroller för att ge en kombination av roller till användare och program för rätt åtkomstnivå.

   Du måste ha behörighet som ägare eller administratör för användaråtkomst i din prenumeration för att hantera roller.

5. Välj Nästa: Instans

   En instans av Enhetsuppdatering är associerad med en enda IoT-hubb. Välj den IoT-hubb som ska användas med Enhetsuppdatering. När du länkar en IoT-hubb till en enhetsuppdateringsinstans skapas automatiskt en ny princip för delad åtkomst som ger behörighet att arbeta med IoT Hub (registerskrivning och tjänstanslutning). Den här principen säkerställer att åtkomsten endast är begränsad till Enhetsuppdatering.

6. På fliken Instans anger du följande information för enhetsuppdateringsinstansen:

   • Namn: Ett namn på din instans.
   • IoT Hub information: Välj en IoT-hubb för att länka till den här instansen.

   

7. Välj Nästa: Granska och skapa. Efter valideringen väljer du Skapa.

   

8. Du ser att distributionen pågår. Distributionsstatusen ändras till "slutförd" om några minuter. När den gör det väljer du Gå till resurs

   

Azure CLI

Använd kommandot az iot device-update account create för att skapa ett nytt konto för enhetsuppdatering.

Ersätt följande platshållare med din egen information:

• < >resource_group: En befintlig resursgrupp i din prenumeration.

• < >account_name: Ett namn på ditt enhetsuppdateringskonto.

• <region>: Den Azure-region där ditt konto ska finnas. Information om vilka regioner som stöder enhetsuppdatering för IoT Hub finns på sidan Azure Products-by-region. Om ingen region anges används resursgruppens plats.

  Anteckning

  Ditt enhetsuppdateringskonto behöver inte finnas i samma region som dina IoT-hubbar, men för bättre prestanda rekommenderar vi att du håller dem geografiskt nära.

az iot device-update account create --resource-group <resource_group> --account <account_name> --location <region>

Använd kommandot az iot device-update instance create för att skapa en enhetsuppdateringsinstans.

En instans av Enhetsuppdatering är associerad med en enda IoT-hubb. Välj den IoT-hubb som ska användas med Enhetsuppdatering. När du länkar en IoT-hubb till en enhetsuppdateringsinstans skapas automatiskt en ny princip för delad åtkomst som ger behörighet att arbeta med IoT Hub (registerskrivning och tjänstanslutning). Den här principen säkerställer att åtkomsten endast är begränsad till Enhetsuppdatering.

Ersätt följande platshållare med din egen information:

• < >account_name: Namnet på det enhetsuppdateringskonto som den här instansen ska associeras med.
• < >instance_name: Ett namn för den här instansen.
• < >iothub_id: Resurs-ID för den IoT-hubb som ska länkas till den här instansen. Du kan hämta resurs-ID:t för IoT Hub med kommandot az iot hub show och fråga efter ID-värdet: az iot hub show -n <iothub_name> --query id.

az iot device-update instance create --account <account_name> --instance <instance_name> --iothub-ids <iothub_id>

Tips

Som en del av processen för att skapa instanser kan du även konfigurera diagnostikloggning. Mer information finns i Samla in diagnostikloggar från enheter via fjärranslutning.

Konfigurera åtkomstkontrollroller för enhetsuppdatering

För att andra användare ska ha åtkomst till Enhetsuppdatering måste de beviljas åtkomst till den här resursen. Du kan hoppa över det här steget om du tilldelade administratörsrollen enhetsuppdatering till dig själv när kontot skapades och inte behöver ge åtkomst till andra användare eller program.

Azure-portalen

1. I ditt enhetsuppdateringskonto väljer du Åtkomstkontroll (IAM) på navigeringsmenyn.

   

2. Välj Lägg till rolltilldelningar.

3. På fliken Roll väljer du en enhetsuppdateringsroll bland de tillgängliga alternativen:

   • Administratör för enhetsuppdatering
   • Enhetsuppdateringsläsare
   • Innehållsadministratör för enhetsuppdatering
   • Innehållsläsare för enhetsuppdatering
   • Administratör för enhetsuppdateringsdistributioner
   • Läsare för enhetsuppdateringsdistributioner

   Mer information finns i Läs mer om rollbaserad åtkomstkontroll i Enhetsuppdatering för IoT Hub.

   

4. Välj Nästa

5. På fliken Medlemmar väljer du de användare eller grupper som du vill tilldela rollen till.

   

6. Välj Granska + tilldela

7. Granska de nya rolltilldelningarna och välj Granska + tilldela igen

8. Nu är du redo att använda Enhetsuppdatering från din IoT Hub

Azure CLI

Följande roller är tillgängliga för att tilldela åtkomst till enhetsuppdatering:

• Administratör för enhetsuppdatering
• Enhetsuppdateringsläsare
• Innehållsadministratör för enhetsuppdatering
• Innehållsläsare för enhetsuppdatering
• Administratör för enhetsuppdateringsdistributioner
• Läsare för enhetsuppdateringsdistributioner

Mer information finns i Mer information om rollbaserad åtkomstkontroll i Enhetsuppdatering för IoT Hub.

Använd kommandot az role assignment create för att konfigurera åtkomstkontroll för ditt enhetsuppdateringskonto.

Ersätt följande platshållare med din egen information:

• <roll>: Den enhetsuppdateringsroll som du tilldelar.
• < >user_group: Den användare eller grupp som du vill tilldela rollen till.
• < >account_id: Resurs-ID för det enhetsuppdateringskonto som användaren eller gruppen får åtkomst till. Du kan hämta resurs-ID:t med kommandot az iot device-update show och fråga efter ID-värdet: az iot device-update account show -n <account_name> --query id.

az role assignment create --role '<role>' --assignee <user_group> --scope <account_id>

Konfigurera åtkomstkontrollroller för IoT Hub

Enhetsuppdatering för IoT Hub kommunicerar med IoT Hub för att hantera distributioner och uppdateringar och för att få information om enheter. För att aktivera åtkomsten måste du ge tjänstens huvudnamn för Azure Device Update åtkomst med rollen IoT Hub datadeltagare.

Azure-portalen

1. I Azure Portal navigerar du till den IoT-hubb som är ansluten till din enhetsuppdateringsinstans.
2. Välj Access Control(IAM) på navigeringsmenyn.
3. Välj Lägg till>Lägg till rolltilldelning.
4. På fliken Roll väljer du IoT Hub Datadeltagare. Välj Nästa.
5. För Tilldela åtkomst till väljer du Användare, grupp eller tjänstens huvudnamn.
6. Välj Välj medlemmar och sök efter "Azure Device Update"
7. Välj Nästa>granskning + Tilldela

Så här kontrollerar du att du har angett rätt behörigheter:

1. I Azure Portal navigerar du till den IoT-hubb som är ansluten till din enhetsuppdateringsinstans.
2. Välj Access Control(IAM) på navigeringsmenyn.
3. Välj Kontrollera åtkomst.
4. Välj Användare, grupp eller tjänstens huvudnamn och sök efter "Azure Device Update"
5. När du har klickat på Azure Device Update kontrollerar du att rollen IoT Hub datadeltagare visas under Rolltilldelningar

Azure CLI

Använd kommandot az role assignment create för att skapa en rolltilldelning för tjänstens huvudnamn för Azure Device Update.

Ersätt <resource_id> med resurs-ID:t för din IoT-hubb. Du kan hämta resurs-ID:t med kommandot az iot hub show och fråga efter ID-värdet: az iot hub show -n <hub_name> --query id.

az role assignment create --role "IoT Hub Data Contributor" --assignee https://api.adu.microsoft.com/ --scope <resource_id>

Visa och fråga konton eller instanser

Du kan visa, sortera och fråga alla dina enhetsuppdateringskonton och instanser.

Azure-portalen

1. Om du vill visa alla enhetsuppdateringskonton använder du Azure Portal för att söka efter enhetsuppdateringen för IoT Hubs-tjänsten.

   • Använd listrutan Gruppering för att gruppera konto efter prenumeration, resursgrupp, plats och andra villkor.
   • Välj Lägg till filter för att filtrera listan över konton efter resursgrupp, plats, taggar och andra villkor.

2. Om du vill visa alla instanser i ett konto går du till det kontot i Azure Portal. Välj Instanser i avsnittet Instanshantering på menyn

   • Använd sökrutan för att filtrera instanser.

Azure CLI

Om du vill visa alla enhetsuppdateringskonton använder du kommandot az iot device-update account list .

az iot device-update account list 

Om du vill visa alla instanser i ett konto använder du kommandot az iot device-update instance list .

az iot device-update instance list --account <account_name>

Båda list kommandona stöder ytterligare grupperings- och filteråtgärder. --query Använd argumentet för att hitta konton eller instanser baserat på villkor som taggar. Till exempel --query "[?tags.env == 'test']". --output Använd argumentet för att formatera resultatet. Till exempel --output table.

Nästa steg

Prova att uppdatera en enhet med någon av följande snabbsjälvstudier:

• Uppdatera en simulerad IoT Edge enhet
• Uppdatera en Raspberry Pi
• Uppdatera en Ubuntu Server 18.04 x64-paketagent

Läs mer om enhetsuppdateringskonto och instans.

Läs mer om åtkomstkontrollroller för enhetsuppdatering