Apparaatgroepen 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.
In dit onderwerp wordt beschreven hoe u uw apparaatgroepen beheert met behulp van de CLI of Azure Sphere Explorer. In de stappen in dit onderwerp wordt ervan uitgegaan dat u bekend bent met de concepten van Azure Sphere-tenants, -producten en -apparaatgroepen.
Apparaatgroepen weergeven
Geef alle apparaatgroepen in uw Azure Sphere-tenant weer met behulp van de opdracht azsphere device-group list of met behulp van de Device Group - List-API.
Alle apparaatgroepen weergeven:
azsphere device-group list
Vermeld de apparaatgroepen in een specifiek product met behulp van de opdracht azsphere-product device-group list of met behulp van de API Product - List Groups.
azsphere product device-group list --product <product-name>
Vouw het tenantknooppunt uit voor de tenant waarin u geïnteresseerd bent.
Vouw het tenantknooppunt uit voor de tenant waarin u geïnteresseerd bent.
De producten en apparaatgroepen van een tenant weergeven:
Vouw het tenantknooppunt uit voor de tenant waarin u geïnteresseerd bent.
Als er geen producten worden vermeld, maakt u een product.
Als het apparaat al is gekoppeld aan een product en is toegewezen aan een groep, kunt u de apparaatgroep op elk gewenst moment bijwerken.
De producten en apparaatgroepen van een tenant weergeven:
Vouw het tenantknooppunt uit voor de tenant waarin u geïnteresseerd bent.
Als er geen producten worden vermeld, maakt u een product.
Als het apparaat al is gekoppeld aan een product en is toegewezen aan een groep, kunt u de apparaatgroep op elk gewenst moment bijwerken.
Een apparaatgroep maken
Maak een apparaatgroep met behulp van de opdracht azsphere device-group create of met behulp van de apparaatgroep - Api maken.
Een apparaatgroep maken:
azsphere device-group create --product <product-name> --name <device-group-name> --description <device-group-description>
Namen voor apparaatgroepen kunnen 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.
U kunt de volgende optionele parameters opnemen:
--os-feedgeeft het type besturingssysteemfeed op dat moet worden gebruikt voor besturingssysteemupdates.--application-updatestelt beleid voor toepassingsupdates in voor deze apparaatgroep.
Vouw het knooppunt Product uit voor de tenant waarin u geïnteresseerd bent.
Voor het product waarin u geïnteresseerd bent, klikt u met de rechtermuisknop en selecteert u Nieuwe apparaatgroep.
Geef een naam op voor de apparaatgroep en druk op Enter. Namen voor apparaatgroepen kunnen 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 .
U kunt een apparaatgroep maken in Visual Studio Code, maar deze niet verwijderen. Als u een apparaatgroep wilt verwijderen, gebruikt u de opdracht azsphere device-group delete of de openbare Azure Sphere-API.
Vouw het knooppunt Product uit voor de tenant waarin u geïnteresseerd bent.
Voor het product waarin u geïnteresseerd bent, klikt u met de rechtermuisknop en selecteert u Nieuwe apparaatgroep.
Geef een naam op voor de apparaatgroep en druk op Enter of klik op Toepassen. Namen voor apparaatgroepen kunnen 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 .
U kunt een apparaatgroep maken in Visual Studio, maar deze niet verwijderen. Als u producten wilt verwijderen, gebruikt u de opdracht azsphere device-group delete of de openbare API van Azure Sphere.
De apparaatgroep bijwerken
U kunt de naam of beschrijving van een apparaatgroep wijzigen met behulp van de opdracht azsphere device-group update of met behulp van de Device Group - Patch-API.
De naam en beschrijving van een apparaatgroep bijwerken:
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>
U kunt de os-feed en parameters ook bijwerken met behulp van de opdracht azsphere device-group update.application-update
Vouw het knooppunt Product uit voor de tenant waarin u geïnteresseerd bent.
Voor het product waarin u geïnteresseerd bent, vouwt u het productknooppunt uit om de opgenomen apparaatgroepen weer te geven. U kunt de naam van de apparaatgroep wijzigen of de beschrijving, het type besturingssysteemfeed of het updatebeleid bijwerken:
Als u de naam van een apparaatgroep wilt wijzigen, klikt u met de rechtermuisknop op de naam van de apparaatgroep en selecteert u Naam wijzigen, typt u een nieuwe naam en drukt u op Enter. Namen voor apparaatgroepen kunnen 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 .
Als u de beschrijving voor de apparaatgroep wilt bijwerken, klikt u met de rechtermuisknop op de naam van de apparaatgroep en selecteert u Beschrijving bijwerken, typt u een nieuwe beschrijving en drukt u op Enter.
Als u het type besturingssysteemfeed wilt bijwerken, vouwt u de apparaatgroep uit, klikt u met de rechtermuisknop op het type besturingssysteemfeed, selecteert u Bijwerken en kiest u Retail of RetailEval in het menu.
Als u het updatebeleid wilt wijzigen, vouwt u de apparaatgroep uit, klikt u met de rechtermuisknop op Updatebeleid, selecteert u Bijwerken en kiest u Vervolgens No3rdPartyAppUpdates of UpdateAll in het menu. (De derde optie, NoUpdates, is momenteel gereserveerd voor intern gebruik. Als u deze optie kiest, wordt er een fout gerapporteerd in het venster Uitvoer .)
Verplaats een apparaat naar een andere apparaatgroep met behulp van de opdracht azsphere device update of met behulp van de Devices - Move-API.
Vouw het knooppunt Product uit voor de tenant waarin u geïnteresseerd bent.
Voor het product waarin u geïnteresseerd bent, vouwt u het productknooppunt uit om de opgenomen apparaatgroepen weer te geven. U kunt de naam van de apparaatgroep wijzigen of de beschrijving, het type besturingssysteemfeed of het updatebeleid bijwerken:
Als u de naam van een apparaatgroep wilt wijzigen, selecteert u de naam van de apparaatgroep en drukt u op F2 of klikt u met de rechtermuisknop op de naam van de apparaatgroep en selecteert u Naam wijzigen, typt u een nieuwe naam en drukt u op Enter of klikt u op Toepassen. Namen voor apparaatgroepen kunnen 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 .
Als u de beschrijving voor de apparaatgroep wilt bijwerken, vouwt u de apparaatgroep uit, selecteert u Beschrijving en drukt u op F2 of klikt u met de rechtermuisknop op Beschrijving en selecteert u Wijzigen, typt u een nieuwe beschrijving en drukt u op Enter of klikt u op Toepassen.
Als u het type besturingssysteemfeed wilt bijwerken, vouwt u de apparaatgroep uit, selecteert u het type besturingssysteemfeed en drukt u op F2 of klikt u met de rechtermuisknop op Type besturingssysteemfeed en selecteert u Wijzigen, kiest u Retail of RetailEval in het menu en drukt u vervolgens op Enter of op Toepassen.
Als u het updatebeleid wilt wijzigen, vouwt u de apparaatgroep uit, selecteert u Updatebeleid en drukt u op F2 of klikt u met de rechtermuisknop op Updatebeleid en selecteert u Wijzigen, kiest u No3rdPartyAppUpdates of UpdateAll in het menu en drukt u vervolgens op Enter of klik op Toepassen. (De derde optie, NoUpdates, is momenteel gereserveerd voor intern gebruik. Als u deze optie kiest, wordt er een fout gerapporteerd in het venster Uitvoer ).
Verplaats een apparaat naar een andere apparaatgroep met behulp van de opdracht azsphere device update of met behulp van de Devices - Move-API.
Een apparaat verplaatsen naar een andere apparaatgroep
Verplaats een apparaat naar een andere apparaatgroep met behulp van de opdracht azsphere device update of met behulp van de Devices - Move-API.
Geef de apparaatgroep-id of een combinatie van de productnaam en apparaatgroepnaam op in de <indeling productnaam>/<apparaatgroepnaam> :
azsphere device update --device-group <device-group-id>
azsphere device update --device-group <product-name/device-group-name>
Een apparaatgroep verwijderen
Verwijder een opgegeven apparaatgroep in uw Azure Sphere-tenant met behulp van de opdracht azsphere device-group delete of met behulp van de Device Group - Delete-API.
Een apparaatgroep kan alleen worden verwijderd wanneer:
- De gebruiker heeft beheerdersmachtigingen voor de tenant.
- De apparaatgroep is leeg en bevat geen apparaten. Met de opdracht azsphere device-group device list worden alle apparaten in een apparaatgroep weergegeven. Voer azsphere device update --device-group uit om het apparaat naar een andere apparaatgroep te verplaatsen.
Geef de apparaatgroep-id of een combinatie van de productnaam en apparaatgroepnaam op in de <indeling productnaam>/<apparaatgroepnaam> :
azsphere device-group delete --device-group <device-group-id>
azsphere device-group delete --device-group <product-name/device-group-name>