Hantera enhetsgrupper
Viktigt!
Det här är dokumentationen om Azure Sphere (Legacy). Azure Sphere (Legacy) upphör den 27 september 2027 och användarna måste migrera till Azure Sphere (integrerad) vid den här tiden. Använd versionsväljaren ovanför TOC för att visa dokumentationen om Azure Sphere (integrerad).
Det här avsnittet beskriver hur du hanterar dina enhetsgrupper med hjälp av CLI eller Azure Sphere Explorer. Stegen i det här avsnittet förutsätter att du är bekant med begreppen för Azure Sphere-klientorganisationer, produkter och enhetsgrupper.
Lista enhetsgrupper
Visa en lista över alla enhetsgrupper i din Azure Sphere-klientorganisation med kommandot azsphere device-group list eller med hjälp av API:et Device Group – List.
Så här listar du alla enhetsgrupper:
azsphere device-group list
Visa en lista över enhetsgrupper i en specifik produkt med kommandot azsphere product device-group list eller med hjälp av API:et Product - List Groups.
azsphere product device-group list --product <product-name>
Expandera noden Klientorganisation för den klientorganisation som du är intresserad av.
Expandera noden Klientorganisation för den klientorganisation som du är intresserad av.
Så här visar du en klientorganisations produkter och enhetsgrupper:
Expandera noden Klientorganisation för den klientorganisation som du är intresserad av.
Om det inte finns några produkter i listan skapar du en produkt.
Om enheten redan är associerad med en produkt och har tilldelats till en grupp kan du uppdatera dess enhetsgrupp när som helst.
Så här visar du en klientorganisations produkter och enhetsgrupper:
Expandera noden Klientorganisation för den klientorganisation som du är intresserad av.
Om det inte finns några produkter i listan skapar du en produkt.
Om enheten redan är associerad med en produkt och har tilldelats till en grupp kan du uppdatera dess enhetsgrupp när som helst.
Skapa en enhetsgrupp.
Skapa en enhetsgrupp med kommandot azsphere device-group create eller med hjälp av enhetsgruppen – Skapa API.
Så här skapar du en enhetsgrupp:
azsphere device-group create --product <product-name> --name <device-group-name> --description <device-group-description>
Namn för enhetsgrupper får endast innehålla alfanumeriska tecken och blanksteg. De får inte överstiga 50 tecken. Om namnet eller beskrivningen innehåller blanksteg omger du det inom citattecken.
Du kan inkludera följande valfria parametrar:
--os-feedanger vilken typ av os-feed som ska användas för OS-uppdateringar.--application-updateanger programuppdateringsprincipen för den här enhetsgruppen.
För den klientorganisation som du är intresserad av expanderar du noden Produkt.
För den produkt som du är intresserad av högerklickar du och väljer Ny enhetsgrupp.
Ange ett namn för enhetsgruppen och tryck på Retur. Namn för enhetsgrupper får endast innehålla alfanumeriska tecken och blanksteg. De får inte överstiga 50 tecken. Om du anger ett ogiltigt namn rapporteras ett fel i utdatafönstret.
Du kan skapa en enhetsgrupp i Visual Studio Code, men inte ta bort den. Om du vill ta bort en enhetsgrupp använder du kommandot azsphere device-group delete eller Azure Sphere Public API.
För den klientorganisation som du är intresserad av expanderar du noden Produkt.
För den produkt som du är intresserad av högerklickar du och väljer Ny enhetsgrupp.
Ange ett namn för enhetsgruppen och tryck på Retur eller klicka på Använd. Namn för enhetsgrupper får endast innehålla alfanumeriska tecken och blanksteg. De får inte överstiga 50 tecken. Om du anger ett ogiltigt namn rapporteras ett fel i utdatafönstret.
Du kan skapa en enhetsgrupp i Visual Studio, men inte ta bort den. Om du vill ta bort produkter använder du kommandot azsphere device-group delete eller Azure Sphere Public API.
Uppdatera enhetsgruppen
Du kan ändra en enhetsgrupps namn eller beskrivning med hjälp av kommandot azsphere device-group update eller med hjälp av api:et Device Group – Patch .
Så här uppdaterar du en enhetsgrupps namn och beskrivning:
azsphere device-group update --device-group <device group ID or product-name/device-group-name> --new-name <new-device-group-name> --new-description <new-device-group-description>
Du kan också uppdatera parametrarna os-feed och med kommandot azsphere device-group updateapplication-update.
För den klientorganisation som du är intresserad av expanderar du noden Produkt.
För den produkt som du är intresserad av expanderar du produktnoden för att visa de enhetsgrupper som ingår. Du kan byta namn på enhetsgruppen eller uppdatera dess beskrivning, typ av os-flöde eller uppdateringsprincip:
Om du vill byta namn på en enhetsgrupp högerklickar du på enhetsgruppens namn och väljer Byt namn, skriver ett nytt namn och trycker sedan på Retur. Namn för enhetsgrupper får endast innehålla alfanumeriska tecken och blanksteg. De får inte överstiga 50 tecken. Om du anger ett ogiltigt namn rapporteras ett fel i utdatafönstret.
Om du vill uppdatera beskrivningen för enhetsgruppen högerklickar du på enhetsgruppens namn och väljer Uppdatera beskrivning, skriver en ny beskrivning och trycker sedan på Retur.
Om du vill uppdatera operativsystemets flödestyp expanderar du enhetsgruppen, högerklickar på operativsystemets flödestyp, väljer Uppdatera och väljer sedan Detaljhandel eller RetailEval på menyn.
Om du vill ändra uppdateringsprincipen expanderar du enhetsgruppen, högerklickar på Uppdatera princip, väljer Uppdatera och väljer sedan No3rdPartyAppUpdates eller UpdateAll på menyn. (Det tredje alternativet, NoUpdates är för närvarande reserverat för internt bruk. Om du väljer det här alternativet rapporteras ett fel i utdatafönstret.)
Flytta en enhet till en annan enhetsgrupp med kommandot azsphere device update eller med hjälp av API:et Enheter – Flytta .
För den klientorganisation som du är intresserad av expanderar du noden Produkt.
För den produkt som du är intresserad av expanderar du produktnoden för att visa de enhetsgrupper som ingår. Du kan byta namn på enhetsgruppen eller uppdatera dess beskrivning, typ av os-flöde eller uppdateringsprincip:
Om du vill byta namn på en enhetsgrupp väljer du enhetsgruppens namn och trycker på F2 eller högerklickar på enhetsgruppens namn och väljer Byt namn, skriver ett nytt namn och trycker sedan på Retur eller klickar på Använd. Namn för enhetsgrupper får endast innehålla alfanumeriska tecken och blanksteg. De får inte överstiga 50 tecken. Om du anger ett ogiltigt namn rapporteras ett fel i utdatafönstret.
Om du vill uppdatera beskrivningen för enhetsgruppen expanderar du enhetsgruppen, väljer Beskrivning och trycker på F2 eller högerklickar på Beskrivning och väljer Ändra, skriver en ny beskrivning och trycker sedan på Retur eller klickar på Använd.
Om du vill uppdatera operativsystemets flödestyp expanderar du enhetsgruppen, väljer typ av os-feed och trycker på F2 eller högerklickar på operativsystemets flödestyp och väljer Ändra, väljer Detaljhandel eller RetailEval på menyn och trycker sedan på Retur eller klickar på Använd.
Om du vill ändra uppdateringsprincipen expanderar du enhetsgruppen, väljer Uppdatera princip och trycker på F2 eller högerklickar på Uppdatera princip och väljer Ändra, väljer No3rdPartyAppUpdates eller UpdateAll på menyn och trycker sedan på Retur eller klickar på Använd. (Det tredje alternativet, NoUpdates är för närvarande reserverat för internt bruk. Om du väljer det här alternativet rapporteras ett fel i fönstret Utdata ).
Flytta en enhet till en annan enhetsgrupp med kommandot azsphere device update eller med hjälp av API:et Enheter – Flytta .
Flytta en enhet till en annan enhetsgrupp
Flytta en enhet till en annan enhetsgrupp med kommandot azsphere device update eller med hjälp av API:et Enheter – Flytta .
Ange antingen enhetsgrupps-ID eller en kombination av produktnamnet och enhetsgruppens namn i <formatet product-name>/<device-group-name> :
azsphere device update --device-group <device-group-id>
azsphere device update --device-group <product-name/device-group-name>
Ta bort en enhetsgrupp
Ta bort en angiven enhetsgrupp i din Azure Sphere-klientorganisation med kommandot azsphere device-group delete eller med hjälp av api:et Enhetsgrupp – Ta bort.
En enhetsgrupp kan bara tas bort när:
- Användaren har administratörsbehörighet till klientorganisationen.
- Enhetsgruppen är tom och har inga enheter i den. Kommandot azsphere device-group device list list alla enheter i en enhetsgrupp. Kör azsphere device update --device-group för att flytta enheten till en annan enhetsgrupp.
Ange antingen enhetsgrupps-ID eller en kombination av produktnamnet och enhetsgruppens namn i <formatet product-name>/<device-group-name> :
azsphere device-group delete --device-group <device-group-id>
azsphere device-group delete --device-group <product-name/device-group-name>