Hantera produkter
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).
En produkt identifierar en Azure Sphere MCU som ingår i en ansluten enhet för att utföra en specifik funktion. Som tillverkare skapar du en produkt för varje modell av en ansluten enhet, till exempel en diskmaskin eller kaffebryggare. Contoso skapar till exempel en produkt för sina DW100-diskmaskiner och tilldelar den här produkten till varje DW100-diskmaskin under tillverkningen. Varje produkt har ett GUID som är unikt i klientorganisationen och som inte kan ändras.
Varje ansluten enhet har en enda produkt, men en enda produkt kan associeras med många enheter. Varje produkt har ett namn som måste vara unikt i klientorganisationen, tillsammans med en beskrivning. Produktnamnet och beskrivningen ger ett läsbart sätt att skilja en produkt från en annan. Produktens namn och beskrivning kan ändras så ofta du vill.
Lista produkter
Visa en lista över alla produkter i din Azure Sphere-klientorganisation med kommandot azsphere-produktlista eller med hjälp av det offentliga API:et för Azure Sphere.
Så här listar du alla produkter:
azsphere product list
Ett meddelande kan visas om standardklientorganisationen inte är markerad. Välj den klientorganisation som krävs i listan och försök igen.
Så här listar du alla produkter i en Azure Sphere-klientorganisation:
Välj ikonen Azure Sphere Explorer i Aktivitetsfältet i Visual Studio Code för att öppna Azure Sphere Explorer. Om fönstret Klientorganisation visar Logga in för att se klienter loggar du in på Azure Sphere och väljer Uppdatera för att se tillgängliga klienter.
Expandera den klientorganisation som du är intresserad av.
Expandera produktnoden.
Välj Visa>andra Windows>Azure Sphere Explorer för att öppna Azure Sphere Explorer. Om fönstret Klientorganisation visar Logga in för att se klienter loggar du in på Azure Sphere och väljer Uppdatera för att se tillgängliga klienter.
Expandera den klientorganisation som du är intresserad av.
Expandera produktnoden.
Skapa en produkt
Skapa en produkt i din Azure Sphere-klientorganisation med hjälp av kommandot azsphere product create eller med hjälp av det offentliga AZURE Sphere-API:et.
Så här skapar du en produkt:
azsphere product create --name <product-name>
Ersätt <produktnamnet> med ett läsbart namn för din produkt, till exempel DW100. Namn för produkter 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.
När du skapar en ny produkt skapar Azure Sphere som standard automatiskt fem enhetsgrupper som ska användas för att skapa distributioner. De fem standardenhetsgrupperna är Development, Field Test, Production, Field Test OS Evaluation och Production OS Evaluation. Om du vill skapa produkten utan standardenhetsgrupperna använder du kommandot:
azsphere product create --name <product-name> --no-default-device-groups
En klientorganisation kan innehålla många produkter. Det kan vara bra att ange en beskrivning av var och en. Du kan lägga till en beskrivning i en produkt på följande sätt:
azsphere product create --name <product-name> --description <product-description>
Så här skapar du en produkt:
För den klientorganisation som du är intresserad av högerklickar du på noden Produkt och väljer Ny produkt.
Ange ett namn på produkten och tryck på Retur. Namn för produkter 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.
När du skapar en produkt i Azure Sphere Explorer skapas de fem standardenhetsgrupperna automatiskt. Om du vill skapa en produkt utan enhetsgrupper använder du kommandot azsphere product create eller Azure Sphere Public API och anger --no-default-device-groups.
Du kan skapa en produkt i Azure Sphere Explorer, men inte ta bort den. Om du vill ta bort produkter använder du kommandot azsphere product delete eller Azure Sphere Public API.
Så här skapar du en produkt:
För den klientorganisation som du är intresserad av högerklickar du på noden Produkt och väljer Ny produkt.
Ange ett namn på produkten och tryck sedan på Retur eller klicka på Använd. Namn för produkter 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.
När du skapar en produkt i Azure Sphere Explorer skapas de fem standardenhetsgrupperna automatiskt. Om du vill skapa en produkt utan enhetsgrupper använder du kommandot azsphere product create eller Azure Sphere Public API och anger --no-default-device-groups.
Du kan skapa en produkt i Azure Sphere Explorer, men inte ta bort den. Om du vill ta bort produkter använder du kommandot azsphere product delete eller Azure Sphere Public API.
Uppdatera en produkt
Ändra en produkts namn eller beskrivning när som helst med hjälp av kommandot azsphere product update eller med hjälp av det offentliga Azure Sphere-API:et. Så här uppdaterar du en produkts namn och beskrivning:
azsphere product update --product <product-name> --new-name <new-product-name> --new-description <new-product-description>
Ta bort produkt
Ta bort en produkt när som helst med kommandot azsphere product delete eller med hjälp av Azure Sphere Public API.
En produkt kan bara tas bort när:
- Användaren har administratörsbehörighet till klientorganisationen.
- Produkten är tom och enhetsgrupperna har inga enheter i den. Kommandot azsphere product device list list alla enheter i en produkt. Kör azsphere device update --device-group för att flytta enheten till en annan enhetsgrupp eller azsphere device-group delete för att ta bort en enhetsgrupp.
Så här tar du bort en produkt:
azsphere product delete --product <product-name>
För den klientorganisation som du är intresserad av expanderar du noden Produkt.
Om du vill byta namn på produkten högerklickar du på produktnamnet och väljer Byt namn, anger ett nytt produktnamn och trycker sedan på Retur.
Om du vill uppdatera beskrivningen högerklickar du på produktnamnet och väljer Uppdatera beskrivning, anger en ny beskrivning och trycker sedan på Retur.
För den klientorganisation som du är intresserad av expanderar du noden Produkt.
Om du vill byta namn på produkten väljer du produktnamnet och trycker på F2 eller högerklickar på produktnamnet och väljer Byt namn, anger ett nytt produktnamn och trycker sedan på Retur eller klickar på Använd.
Om du vill uppdatera beskrivningen expanderar du produkten, väljer Beskrivning och trycker på F2 eller högerklickar på Beskrivning och väljer Ändra, anger en ny beskrivning och trycker sedan på Retur eller klickar på Använd.
Visa produktinformation
Visa information om en produkt i din klientorganisation med kommandot azsphere product show eller med hjälp av det offentliga AZURE Sphere-API:et.
azsphere product show --product <product-name>
Så här visar du information om en produkt i din klientorganisation:
Välj ikonen Azure Sphere Explorer i Aktivitetsfältet i Visual Studio Code för att öppna Azure Sphere Explorer. Om fönstret Klientorganisation visar Logga in för att se klienter loggar du in på Azure Sphere och väljer Uppdatera för att se tillgängliga klienter.
För den klientorganisation som du är intresserad av expanderar du noden Produkt.
Expandera den produkt som du är intresserad av.
Välj Visa>andra Windows>Azure Sphere Explorer för att öppna Azure Sphere Explorer. Om fönstret Klientorganisation visar Logga in för att se klienter loggar du in på Azure Sphere och väljer Uppdatera för att se tillgängliga klienter.
För den klientorganisation som du är intresserad av expanderar du noden Produkt.
Expandera den produkt som du är intresserad av.