Enhetsuppdatering för resurshantering i IoT Hub

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

• 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 för att 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 se till att du använder den senaste versionen av tillägget.

1. I Azure-portalenvä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.

   Anmärkning

   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, vilket ger behörighet att arbeta med IoT Hub (registerskrivning och tjänstanslutning). Den här principen säkerställer att åtkomst endast begränsas 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 + skapa. Efter valideringen väljer du Skapa.

   

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

   

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

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.

  Anmärkning

  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 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, vilket ger behörighet att arbeta med IoT Hub (registerskrivning och tjänstanslutning). Den här principen säkerställer att åtkomst endast begränsas 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 hjälp av 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>

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

   För mer information, 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

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

För mer information, Läs mer 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:

• <role>: Den roll för enhetsuppdatering som du tilldelar.
• <user_group>: Den användare eller grupp som du vill tilldela rollen till.
• <account_id>: Resurs-ID:t för det enhetsuppdateringskonto som användaren eller gruppen får åtkomst till. Du kan hämta resurs-ID:t med az iot device-update account show-kommandot och genom att söka 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>

1. I Azure Portal navigerar du till den IoT-hubb som är ansluten till enhetsuppdateringsinstansen.
2. Välj Åtkomstkontroll (IAM) på navigeringsmenyn.
3. Välj Lägg till>Lägg till rolltilldelning.
4. På fliken Roll väljer du IoT Hub-datahanterare. Välj Nästa.
5. För Tilldela åtkomst till, välj 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>Granska + tilldela

Så här verifierar du att du har angett behörigheter korrekt:

1. I Azure Portal navigerar du till den IoT-hubb som är ansluten till enhetsuppdateringsinstansen.
2. Välj Åtkomstkontroll (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 Updatekontrollerar du att rollen IoT Hub-datadeltagare visas under Rolltilldelningar

Använd kommandot az role assignment create för att skapa en rolltilldelning för tjänstehuvudnamnet 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 hjälp av 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>

1. Om du vill visa alla enhetsuppdateringskonton använder du Azure-portalen för att söka efter Device Update for 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-portalen. Välj instanser i avsnittet Instanshantering på menyn

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

Använd kommandot az iot device-update account list för att visa alla enhetsuppdateringskonton.

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 kommandon har stöd för ytterligare grupperings- och filteråtgärder. Använd argumentet --query för att hitta konton eller instanser baserat på villkor som taggar. Till exempel --query "[?tags.env == 'test']". Använd argumentet --output för att formatera resultatet. Till exempel --output table.