Hantera enhetsgrupper
I det här avsnittet beskrivs hur du hanterar enhetsgrupper med antingen CLI eller Azure Sphere Explorer. Stegen i det här avsnittet förutsätter att du är bekant med begreppen Azure Sphere-klientorganisationer, produkter och enhetsgrupper.
Lista enhetsgrupper
Visa en lista över alla enhetsgrupper i Azure Sphere-klientorganisationen med listkommandot azsfärenhetsgrupp eller med hjälp av API:et Enhetsgrupp – lista .
Så här visar du alla enhetsgrupper:
azsphere device-group list
Visa en lista över enhetsgrupper i en viss produkt med kommandot azsfärproduktenhetsgrupp eller med HJÄLP av API:t Product - List Groups .
azsphere product device-group list --product <product-name>
Expandera klientorganisationens nod för den klientorganisation du är intresserad av.
Expandera klientorganisationens nod för den klientorganisation du är intresserad av.
Så här visar du en klientorganisations produkter och enhetsgrupper:
Expandera klientorganisationens nod för den klientorganisation du är intresserad av.
Om det inte finns några produkter i listan skapar du en produkt.
Om enheten redan är kopplad till en produkt och har tilldelats till en grupp kan du uppdatera enhetens grupp när som helst.
Så här visar du en klientorganisations produkter och enhetsgrupper:
Expandera klientorganisationens nod för den klientorganisation du är intresserad av.
Om det inte finns några produkter i listan skapar du en produkt.
Om enheten redan är kopplad till en produkt och har tilldelats till en grupp kan du uppdatera enhetens grupp när som helst.
Skapa en enhetsgrupp
Skapa en enhetsgrupp med hjälp av kommandot skapa en azsfärenhet 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 kan endast innehålla alfanumeriska tecken och blanksteg. De får inte överstiga 50 tecken. Om namnet eller beskrivningen innehåller blanksteg omger du det med citattecken.
Du kan ta med följande valfria parametrar:
--os-feedanger vilken typ av OS-feed som ska användas för OS-uppdateringar.--application-updateanger princip för programuppdateringar för den här enhetsgruppen.
För den klientorganisation du är intresserad av expanderar du produktnoden.
För den produkt 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 kan endast innehålla alfanumeriska tecken och blanksteg. De får inte överstiga 50 tecken. Om du anger ett ogiltigt namn rapporteras ett fel i fönstret Utdata .
Du kan skapa en enhetsgrupp i Visual Studio-kod, men inte ta bort den. Om du vill ta bort en enhetsgrupp använder du borttagningskommandot azsfärenhetsgrupp eller Azure Sphere Public API.
För den klientorganisation du är intresserad av expanderar du produktnoden.
För den produkt 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 kan endast innehålla alfanumeriska tecken och blanksteg. De får inte överstiga 50 tecken. Om du anger ett ogiltigt namn rapporteras ett fel i fönstret Utdata .
Du kan skapa en enhetsgrupp i Visual Studio, men inte ta bort den. Om du vill ta bort produkter använder du borttagningskommandot för azsfärenhetsgruppen eller azure sphere public API.
Uppdatera enhetsgruppen
Du kan ändra en enhetsgrupps namn eller beskrivning med uppdateringskommandot för azsfärenhetsgruppen eller med hjälp av Enhetsgrupp – Korrigerings-API .
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 application-update med uppdateringskommandot azsfärenhetsgrupp .
För den klientorganisation du är intresserad av expanderar du produktnoden.
För den produkt du är intresserad av expanderar du produktnoden så att dess enhetsgrupper ingår. Du kan byta namn på enhetsgruppen eller uppdatera dess beskrivning, typ av OS-feed 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 kan endast innehålla alfanumeriska tecken och blanksteg. De får inte överstiga 50 tecken. Om du anger ett ogiltigt namn rapporteras ett fel i fönstret Utdata .
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 typen av OS-feed expanderar du enhetsgruppen, högerklickar på typ av OS-feed, väljer Uppdatera och väljer sedan Återförsäljning 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 intern användning. Om du väljer det här alternativet rapporteras ett fel i fönstret Utdata .)
Flytta en enhet till en annan enhetsgrupp med uppdateringskommandot för azsfärenheten eller med hjälp av Devices - Move API.
För den klientorganisation du är intresserad av expanderar du produktnoden.
För den produkt du är intresserad av expanderar du produktnoden så att dess enhetsgrupper ingår. Du kan byta namn på enhetsgruppen eller uppdatera dess beskrivning, typ av OS-feed eller uppdateringsprincip:
Om du vill byta namn på en enhetsgrupp markerar 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 kan endast innehålla alfanumeriska tecken och blanksteg. De får inte överstiga 50 tecken. Om du anger ett ogiltigt namn rapporteras ett fel i fönstret Utdata .
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 typen av OS-feed expanderar du enhetsgruppen, väljer typ av OS-feed och trycker på F2 eller högerklickar på typ av OS-feed och väljer Ändra, väljer Återförsäljning 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å Verkställ. (Det tredje alternativet, NoUpdates, är för närvarande reserverat för intern användning. Om du väljer det här alternativet rapporteras ett fel i fönstret Utdata ).
Flytta en enhet till en annan enhetsgrupp med uppdateringskommandot för azsfärenheten eller med hjälp av Devices - Move API.
Flytta en enhet till en annan enhetsgrupp
Flytta en enhet till en annan enhetsgrupp med uppdateringskommandot för azsfärenheten eller med hjälp av Devices - Move API.
Ange antingen enhetsgrupp-ID eller en kombination av produktnamnet och enhetsgruppens namn i <formatet produktnamn>/<enhet-grupp-namn> :
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 Azure Sphere-klientorganisationen med borttagningskommandot för azsfärenhetsgruppen eller med hjälp av Enhetsgrupp – Ta bort API.
En enhetsgrupp kan bara tas bort när:
- Användaren har administratörsbehörighet till klientorganisationen.
- Enhetsgruppen är tom och har inga enheter. Kommandot azsfärenhetsgruppenhet listar alla enheter i en enhetsgrupp. Kör azsfärenhetsuppdatering – enhetsgrupp för att flytta enheten till en annan enhetsgrupp.
Ange antingen enhetsgrupp-ID eller en kombination av produktnamnet och enhetsgruppens namn i <formatet produktnamn>/<enhet-grupp-namn> :
azsphere device-group delete --device-group <device-group-id>
azsphere device-group delete --device-group <product-name/device-group-name>