Producten beheren
Belangrijk
Dit is de Documentatie voor Azure Sphere (verouderd). Azure Sphere (verouderd) wordt op 27 september 2027 buiten gebruik gesteld en gebruikers moeten tegen deze tijd migreren naar Azure Sphere (geïntegreerd). Gebruik de versiekiezer boven de inhoudsweergave om de Documentatie van Azure Sphere (geïntegreerd) weer te geven.
Een product identificeert een Azure Sphere MCU die is opgenomen in een verbonden apparaat om een specifieke functie uit te voeren. Als fabrikant maakt u een product voor elk model van een aangesloten apparaat, zoals een vaatwasser of koffiezetapparaat. Contoso maakt bijvoorbeeld een product voor de DW100-vaatwassers en wijst dit product toe aan elke DW100-vaatwasser tijdens de productie. Elk product heeft een GUID die uniek is binnen de tenant en kan niet worden gewijzigd.
Elk verbonden apparaat heeft één product, maar één product kan aan veel apparaten worden gekoppeld. Elk product heeft een naam die uniek moet zijn binnen de tenant, samen met een beschrijving. De productnaam en -beschrijving bieden een door mensen leesbare manier om het ene product van een ander te onderscheiden. De naam en beschrijving van het product kunnen zo vaak worden gewijzigd als u wilt.
Producten vermelden
Geef alle producten in uw Azure Sphere-tenant weer met behulp van de opdracht azsphere-productlijst of met behulp van de openbare API van Azure Sphere.
Alle producten weergeven:
azsphere product list
Er kan een bericht worden weergegeven als de standaardtenant niet is geselecteerd. Selecteer de vereiste tenant in de lijst en voer de opdracht opnieuw uit.
Alle producten in een Azure Sphere-tenant weergeven:
Selecteer het pictogram Azure Sphere Explorer in de activiteitenbalk van Visual Studio Code om Azure Sphere Explorer te openen. Als in het deelvenster Tenant aanmelden wordt weergegeven om tenants weer te geven, meldt u zich aan bij Azure Sphere en selecteert u Vernieuwen om de beschikbare tenants weer te geven.
Vouw de tenant uit waarin u geïnteresseerd bent.
Vouw het productknooppunt uit.
Selecteer Andere Windows>Azure Sphere Explorer weergeven om Azure Sphere Explorer te openen.> Als in het deelvenster Tenant aanmelden wordt weergegeven om tenants weer te geven, meldt u zich aan bij Azure Sphere en selecteert u Vernieuwen om de beschikbare tenants weer te geven.
Vouw de tenant uit waarin u geïnteresseerd bent.
Vouw het productknooppunt uit.
Een product maken
Maak een product in uw Azure Sphere-tenant met behulp van de opdracht azsphere product create of met behulp van de openbare Api van Azure Sphere.
Ga als volgende te werk om een product te maken:
azsphere product create --name <product-name>
Vervang <de productnaam> door een door mensen leesbare naam voor uw product, zoals DW100. Namen voor producten mogen alleen alfanumerieke tekens en spaties bevatten. Ze mogen niet langer zijn dan 50 tekens. Als de naam of beschrijving spaties bevat, plaatst u deze tussen aanhalingstekens.
Wanneer u een nieuw product maakt, maakt Azure Sphere standaard automatisch vijf apparaatgroepen voor gebruik bij het maken van implementaties. De vijf standaardapparaatgroepen zijn Development, Field Test, Production, Field Test OS Evaluation en Production OS Evaluation. Gebruik de opdracht om het product te maken zonder de standaardapparaatgroepen:
azsphere product create --name <product-name> --no-default-device-groups
Een tenant kan veel producten bevatten, het kan handig zijn om een beschrijving van elk product te geven. U kunt als volgt een beschrijving toevoegen aan een product:
azsphere product create --name <product-name> --description <product-description>
Ga als volgende te werk om een product te maken:
Voor de tenant waarin u geïnteresseerd bent, klikt u met de rechtermuisknop op het knooppunt Product en selecteert u Nieuw product.
Geef een naam op voor het product en druk op Enter. Namen voor producten mogen alleen alfanumerieke tekens en spaties bevatten. Ze mogen niet langer zijn dan 50 tekens. Als u een ongeldige naam opgeeft, wordt er een fout gerapporteerd in het venster Uitvoer .
Wanneer u een product maakt in Azure Sphere Explorer, worden de vijf standaardapparaatgroepen automatisch gemaakt. Als u een product zonder apparaatgroepen wilt maken, gebruikt u de opdracht azsphere product create of de openbare Azure Sphere-API en geeft u --no-default-device-groups op.
U kunt een product maken in Azure Sphere Explorer, maar niet verwijderen. Als u producten wilt verwijderen, gebruikt u de opdracht azsphere product delete of de openbare API van Azure Sphere.
Ga als volgende te werk om een product te maken:
Voor de tenant waarin u geïnteresseerd bent, klikt u met de rechtermuisknop op het knooppunt Product en selecteert u Nieuw product.
Geef een naam op voor het product en druk op Enter of klik op Toepassen. Namen voor producten mogen alleen alfanumerieke tekens en spaties bevatten. Ze mogen niet langer zijn dan 50 tekens. Als u een ongeldige naam opgeeft, wordt er een fout gerapporteerd in het venster Uitvoer .
Wanneer u een product maakt in Azure Sphere Explorer, worden de vijf standaardapparaatgroepen automatisch gemaakt. Als u een product zonder apparaatgroepen wilt maken, gebruikt u de opdracht azsphere product create of de openbare Azure Sphere-API en geeft u --no-default-device-groups op.
U kunt een product maken in Azure Sphere Explorer, maar niet verwijderen. Als u producten wilt verwijderen, gebruikt u de opdracht azsphere product delete of de openbare API van Azure Sphere.
Een product bijwerken
Wijzig de naam of beschrijving van een product op elk gewenst moment met behulp van de opdracht azsphere-productupdate of met behulp van de openbare API van Azure Sphere. De naam en beschrijving van een product bijwerken:
azsphere product update --product <product-name> --new-name <new-product-name> --new-description <new-product-description>
Een product verwijderen
U kunt een product op elk gewenst moment verwijderen met behulp van de opdracht azsphere product delete of met behulp van de openbare Api van Azure Sphere.
Een product kan alleen worden verwijderd wanneer:
- De gebruiker heeft beheerdersmachtigingen voor de tenant.
- Het product is leeg en de apparaatgroepen hebben er geen apparaten in. Met de opdracht azsphere-productapparatenlijst worden alle apparaten in een product weergegeven. Voer azsphere device update --device-group uit om het apparaat te verplaatsen naar een andere apparaatgroep of azsphere device-group delete om een apparaatgroep te verwijderen.
Een product verwijderen:
azsphere product delete --product <product-name>
Vouw het knooppunt Product uit voor de tenant waarin u geïnteresseerd bent.
Als u de naam van het product wilt wijzigen, klikt u met de rechtermuisknop op de productnaam en selecteert u Naam wijzigen, geeft u een nieuwe productnaam op en drukt u op Enter.
Als u de beschrijving wilt bijwerken, klikt u met de rechtermuisknop op de productnaam en selecteert u Beschrijving bijwerken, geeft u een nieuwe beschrijving op en drukt u op Enter.
Vouw het knooppunt Product uit voor de tenant waarin u geïnteresseerd bent.
Als u de naam van het product wilt wijzigen, selecteert u de productnaam en drukt u op F2 of klikt u met de rechtermuisknop op de productnaam en selecteert u Naam wijzigen, geeft u een nieuwe productnaam op en drukt u op Enter of klikt u op Toepassen.
Als u de beschrijving wilt bijwerken, vouwt u het product uit, selecteert u Beschrijving en drukt u op F2 of klikt u met de rechtermuisknop op Beschrijving en selecteert u Wijzigen, geeft u een nieuwe beschrijving op en drukt u op Enter of klikt u op Toepassen.
Productdetails weergeven
Bekijk de details van een product in uw tenant met behulp van de opdracht azsphere product show of met behulp van de openbare Api van Azure Sphere.
azsphere product show --product <product-name>
De details van een product in uw tenant weergeven:
Selecteer het pictogram Azure Sphere Explorer in de activiteitenbalk van Visual Studio Code om Azure Sphere Explorer te openen. Als in het deelvenster Tenant aanmelden wordt weergegeven om tenants weer te geven, meldt u zich aan bij Azure Sphere en selecteert u Vernieuwen om de beschikbare tenants weer te geven.
Vouw het knooppunt Product uit voor de tenant waarin u geïnteresseerd bent.
Vouw het product uit waarin u geïnteresseerd bent.
Selecteer Andere Windows>Azure Sphere Explorer weergeven om Azure Sphere Explorer te openen.> Als in het deelvenster Tenant aanmelden wordt weergegeven om tenants weer te geven, meldt u zich aan bij Azure Sphere en selecteert u Vernieuwen om de beschikbare tenants weer te geven.
Vouw het knooppunt Product uit voor de tenant waarin u geïnteresseerd bent.
Vouw het product uit waarin u geïnteresseerd bent.