Apparaatgroepen beheren
In dit onderwerp wordt beschreven hoe u uw apparaatgroepen beheert met behulp van de CLI of Azure Sphere Explorer. Bij 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 Apparaatgroep - Lijst-API .
Ga als volgende te werk om alle apparaatgroepen weer te geven:
azsphere device-group list
Geef de apparaatgroepen in een specifiek product weer met behulp van de opdracht azsphere product device-group list of met behulp van de API Product - Lijstgroepen .
azsphere product device-group list --product <product-name>
Vouw het tenantknooppunt uit voor de tenant waarin u bent geïnteresseerd.
Vouw het tenantknooppunt uit voor de tenant waarin u bent geïnteresseerd.
De producten en apparaatgroepen van een tenant weergeven:
Vouw het tenantknooppunt uit voor de tenant waarin u bent geïnteresseerd.
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 bent geïnteresseerd.
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 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.
U kunt de volgende optionele parameters opnemen:
--os-feed
hiermee geeft u het type besturingssysteemfeed op dat moet worden gebruikt voor updates van het besturingssysteem.--application-update
stelt het beleid voor toepassingsupdates voor deze apparaatgroep in.
Vouw voor de tenant waarin u bent geïnteresseerd het knooppunt Product uit.
Klik met de rechtermuisknop op het product waarin u geïnteresseerd bent en selecteer Nieuwe apparaatgroep.
Geef een naam op voor de apparaatgroep en druk op Enter. Namen voor apparaatgroepen 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 .
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 API van Azure Sphere.
Vouw voor de tenant waarin u bent geïnteresseerd het knooppunt Product uit.
Klik met de rechtermuisknop op het product waarin u geïnteresseerd bent en selecteer Nieuwe apparaatgroep.
Geef een naam op voor de apparaatgroep en druk op Enter of klik op Toepassen. Namen voor apparaatgroepen 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 .
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 de opdracht azsphere device-group update of met behulp van de Apparaatgroep - 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
parameters en application-update
ook bijwerken met de opdracht azsphere device-group update .
Vouw voor de tenant waarin u bent geïnteresseerd het knooppunt Product uit.
Vouw voor het product waarin u bent geïnteresseerd het productknooppunt uit om de meegeleverde 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 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 .
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 Type besturingssysteemfeed, selecteert u Bijwerken en kiest u vervolgens 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 API Devices - Move .
Vouw voor de tenant waarin u bent geïnteresseerd het knooppunt Product uit.
Vouw voor het product waarin u bent geïnteresseerd het productknooppunt uit om de meegeleverde 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, selecteert u Naam wijzigen, typt u een nieuwe naam en drukt u op Enter of klikt u op Toepassen. Namen voor apparaatgroepen 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 .
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 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 klikt u op Toepassen.
Als u het updatebeleid wilt wijzigen, vouwt u de apparaatgroep uit, selecteert u Beleid bijwerken 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 op Enter of klikt u 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 API Devices - Move .
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 API Devices - Move .
Geef de id van de apparaatgroep of een combinatie van de productnaam en de naam van de apparaatgroep 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 Apparaatgroep - Verwijderen-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 vermeld. Voer azsphere device update --device-group uit om het apparaat naar een andere apparaatgroep te verplaatsen.
Geef de id van de apparaatgroep of een combinatie van de productnaam en de naam van de apparaatgroep 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>