Distribuera en uppdatering med hjälp av Azure Device Update för IoT Hub

1. I Azure-portalen går du till din IoT-hubb.

2. Välj Uppdateringar under Enhetshantering i det vänstra navigeringsfältet.

   

3. På sidan Uppdateringar väljer du fliken Grupper och distributioner och visar listan över uppdateringskompatibilitetsdiagram och enhetsgrupper. Du kan behöva uppdatera vyn för att se nyligen importerade uppdateringar som är tillgängliga för din enhetsgrupp.

4. Under Status i grupplistan väljer du Distribuera bredvid En eller flera nya uppdateringar är tillgängliga för den här gruppen.

   

5. Visa uppdateringskompatibilitetsdiagrammet och grupplistan. Du bör se en ny uppdatering som är tillgänglig för din taggbaserade grupp eller standardgrupp. Du kan behöva uppdatera en gång. Mer information finns i Enhetsuppdateringsefterlevnad.

6. Välj Distribuera bredvid en eller flera tillgängliga uppdateringar.

7. I listan till höger väljer du önskad uppdatering som ska distribueras.

   

8. För nedladdningssäkerhet, välj HTTPS (rekommenderat) eller HTTP. Denna inställning styr protokollet som enheterna använder för att ladda ner uppdateringsinnehållet. HTTPS är standard och krypterar uppdaterande innehåll under överföring.

   För vägledning om hur du väljer protokoll och förbereder dina enheter, se Förstå nedladdningssäkerhet (TLS) i Device Update for IoT Hub.

9. Schemalägg distributionen så att den startar omedelbart eller i framtiden.

   Dricks

   Som standard är startdatum och tid 24 timmar från den aktuella tiden. Se till att välja ett annat datum och en annan tid om du vill att distributionen ska börja förr eller senare.

   

10. Skapa en princip för automatisk återställning om det behövs. Välj sedan Skapa.

11. På fliken Aktuella uppdateringar kan du visa status för distributionen.

    

12. I vyn Grunderna för grupp visar kompatibilitetsdiagrammet att uppdateringen nu pågår.

    När enheten har uppdaterats uppdateras efterlevnadsdiagrammet och distributionsinformationen för att återspegla den statusen.

Du kan använda Bash-miljön i Azure Cloud Shell för att köra följande kommandon. Välj Starta Cloud Shell för att öppna Cloud Shell eller välj Cloud Shell-ikonen i det översta verktygsfältet i Azure Portal.

Eller, om du vill, kan du köra Azure CLI-kommandon lokalt:

1. Installera Azure CLI. Kör az version för att se den installerade Azure CLI-versionen och beroende bibliotek och kör az upgrade för att installera den senaste versionen.
2. Logga in på Azure genom att köra az login.
3. azure-iot Installera tillägget när du uppmanas att använda det första. Kontrollera att du använder den senaste versionen av tillägget genom att köra az extension update --name azure-iot.

Verifiera uppdateringstillgänglighet

1. az iot du device group list Använd kommandot för att identifiera din enhetsgrupp.

   az iot du device group list \
       --account <Device Update account name> \
       --instance <Device Update instance name>\
   

2. Använd az iot du device group show sedan för att visa den bästa tillgängliga uppdateringen för din grupp. Kommandot tar följande argument:

   • --account: Namnet på enhetsuppdateringskontot.
   • --instance: Namnet på enhetsuppdateringsinstansen.
   • --group-id: Det enhetsgrupps-ID som du riktar in dig på med den här distributionen, som antingen är värdet för taggen ADUGroup eller $default för enheter utan tagg.
   • --resource-group: Resursgruppnamnet för enhetsuppdateringskontot.
   • --best-updates: Returnerar de bästa tillgängliga uppdateringarna för enhetsgruppen, inklusive antalet enheter som behöver varje uppdatering.
   • --update-compliance: Returnerar efterlevnadsinformation för enhetsgrupper, till exempel hur många enheter som har den senaste uppdateringen, hur många som behöver nya uppdateringar och hur många som för närvarande får en ny uppdatering.

   Kontrollera den bästa tillgängliga uppdateringen för din grupp genom att köra kommandot på följande sätt:

   az iot du device group show \
       --account <Device Update account name> \
       --instance <Device Update instance name>\
       --group-id <device group ID>\
       --best-updates
   

Skapa distributionen

Använd az iot du device deployment create för att skapa en distribution för enhetsgruppen. Kommandot tar följande argument:

• --account: Namnet på enhetsuppdateringskontot.
• --instance: Namnet på enhetsuppdateringsinstansen.
• --group-id: Det enhetsgrupps-ID som du riktar in dig på med den här distributionen, som antingen är värdet för taggen ADUGroup eller $default för enheter utan tagg.
• --deployment-id: Ett ID för att identifiera den här distributionen.
• --update-name, --update-provider, och --update-version: Parametrarna som definierar updateId objektet, en unik identifierare för uppdateringen i den här distributionen.

Kör kommandot på följande sätt:

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version>

Enheter laddar ner uppdaterat innehåll via HTTPS som standard. För att använda HTTP istället, lägg till den valfria --download-security parametern som beskrivs i Använd valfria argument.

Använda valfria argument

Med valfria argument kan du konfigurera distributionen ytterligare. En fullständig lista över valfria argument finns i Valfria parametrar.

Om du vill skapa en princip för automatisk återställning lägger du till följande parametrar:

• --failed-count: Antalet misslyckade enheter i en distribution som utlöser en återställning.
• --failed-percentage: Procentandelen misslyckade enheter i en distribution som utlöser en återställning.
• --rollback-update-name, --rollback-update-provider, --rollback-update-version: Parametrarna för uppdateringen som ska användas om en återställning initieras.

Kör kommandot på följande sätt:

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version> \
    --failed-count 10 \
    --failed-percentage 5 \
    --rollback-update-name <rollback update name> \
    --rollback-update-provider <rollback update provider> \
    --rollback-update-version <rollback update version>

Om du vill ange distributionens starttid använder du parametern --start-time för att ange måldatum och tid för distributionen enligt följande:

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id> \
    --deployment-id <deployment id> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version> \
    --start-time "2022-12-20T01:00:00"

För att välja protokollet som enheterna använder för att ladda ner uppdateringsinnehållet, lägg till den valfria --download-security parametern. Godkända värden är HTTPS (rekommenderade) och HTTP. Om du utelämnar parametern använder distributionen standardinställningen HTTPS. För vägledning om hur du väljer protokoll och förbereder dina enheter, se Förstå nedladdningssäkerhet (TLS) i Device Update for IoT Hub.

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version> \
    --download-security <HTTPS or HTTP>

1. På fliken Grupper och distributioner på sidan Uppdateringar väljer du den grupp som du distribuerade till.

2. På sidan Gruppinformation går du till fliken Aktuell distributions - eller distributionshistorik för att bekräfta att en distribution pågår.

   

3. Välj Information bredvid en distribution för att visa distributionsinformation, uppdateringsinformation och information om enhetsklassens mål. Du kan också lägga till ett eget namn för enhetsklassen.

4. Välj Uppdatera för att visa den senaste statusinformationen.

   

Gå till fliken Grundläggande grupp på sidan Gruppinformation för att söka efter status för en viss enhet eller filtrera för att visa enheter som misslyckades med distributionen.

Använd az iot du device deployment list för att visa alla distributioner för en enhetsgrupp.

az iot du device deployment list \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id>

Använd az iot du device deployment show för att visa information om en viss distribution.

az iot du device deployment show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID>

--status Lägg till flaggan för att returnera information om hur många enheter i distributionen som pågår, slutförs eller misslyckas.

az iot du device deployment show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID> \
    --status

1. Gå till fliken Aktuell distribution på skärmen Gruppinformation .

2. Välj Försök igen misslyckade enheter och bekräfta bekräftelsemeddelandet.

Använd az iot du device deployment retry to retry a deployment for a target subgroup of devices (Använd az iot du device deployment retry to retry a deployment for a target subgroup of devices).

Detta kommando tar argumentet --class-id , som genereras från modell-ID och kompatibilitetsegenskaper som rapporteras av enhetsuppdateringsagenten:

az iot du device deployment retry \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --deployment-id <deployment ID> \
    --group-id <device group ID> \
    --class-id <device class ID>