apparaatgroep
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.
Hiermee maakt en beheert u apparaatgroepen.
Apparaatgroepen worden geadresseerd op id (id) of op een productnaam en een paar apparaatgroepen.
| Operation | Omschrijving |
|---|---|
| create | Hiermee maakt u een nieuwe apparaatgroep. |
| lijst | Een lijst weergeven van alle apparaatgroepen in uw Azure Sphere-tenant. |
| verwijderen | Hiermee verwijdert u een bestaande apparaatgroep. |
| Implementatie | Beheert implementaties binnen een apparaatgroep. |
| apparaat | Een lijst met apparaten in een apparaatgroep. |
| tonen | Geeft informatie weer over een apparaatgroep. |
| update | Hiermee wijzigt u een bestaande apparaatgroep. |
maken
Hiermee maakt u een apparaatgroep met de opgegeven naam voor het opgegeven product. De apparaatgroep organiseert apparaten met hetzelfde product en ontvangt dezelfde toepassingen uit de cloud.
Vereiste parameters
| Parameter | Type | Description |
|---|---|---|
| -p, --product | GUID of naam | Hiermee geeft u het product waaraan deze apparaatgroep moet worden toegevoegd. U kunt de id of naam van het Azure Sphere-product opgeven. |
| -n, --name | String | Hiermee geeft u een naam op voor de apparaatgroep. De naam mag alleen alfanumerieke tekens bevatten. Als de naam spaties bevat, plaatst u deze tussen aanhalingstekens. De naam van de apparaatgroep mag niet langer zijn dan 50 tekens, is niet hoofdlettergevoelig, moet uniek zijn binnen het product. |
Optionele parameters
| Parameter | Type | Description |
|---|---|---|
| -a, --application-update | Enum | Hiermee geeft u het beleid voor toepassingsupdates op dat moet worden toegepast op deze apparaatgroep. Geaccepteerde waarden: No3rdPartyAppUpdates, UpdateAllen NoUpdates. Standaard is UpdateAll. Het NoUpdates beleid is momenteel alleen gereserveerd voor intern gebruik. |
| -f, --os-feed | Enum | Hiermee geeft u het type besturingssysteemfeed op dat moet worden gebruikt voor besturingssysteemupdates. Geaccepteerde waarden: Retail, RetailEval. |
| -t, --tenant | GUID of naam | Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Hiermee overschrijft u de standaard geselecteerde tenant. U kunt de tenant-id of tenantnaam opgeven. |
| -d, --description | String | Hiermee geeft u de optionele tekst om de apparaatgroep te beschrijven. De maximale lengte is 100 tekens. Als de beschrijving spaties bevat, plaatst u deze tussen aanhalingstekens. |
| -r, --regional-data-boundary | String | Regionale gegevensgrens voor deze afbeelding. Toegestane waarden: EU, None. De standaardwaarde is None. Als er geen waarde is opgegeven, wordt de standaardwaarde gebruikt. Zie Crashdumps configureren voor meer informatie - Pivacy-overwegingen |
Globale parameters
De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. Als u een fout vindt, kunt u een foutenrapport indienen op basis van de uitvoer die met de vlag --debug wordt gegeneerd. |
| -h, --help | Cli-referentiegegevens over opdrachten en de bijbehorende argumenten en lijsten met beschikbare subgroepen en opdrachten afdrukken. |
| --only-show-errors | Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt. |
| -o, --output | Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard is table de uitvoer van de CLI. Zie De uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
| --vraag | Hiermee wordt de JMESPath-querytaal gebruikt om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de zelfstudie JMESPath en Voer uitvoer van Azure CLI-opdrachten uit voor meer informatie en voorbeelden. |
| --verbose | Hiermee wordt informatie afgedrukt over resources die zijn gemaakt in Azure Sphere tijdens een bewerking en andere nuttige informatie. Gebruik --debug voor de volledige logboeken voor foutopsporing. |
Notitie
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u globale parameters voor meer informatie over beschikbare opties.
Opmerking
azsphere device-group create --name Marketing --product DW100
------------------------------------ ------------------------------------ ---------- ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- ---------------------
Id TenantId OsFeedType ProductId Name UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
===================================================================================================================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail 6f52bead-700d-4289-bdc2-2f11f774270e Marketing Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
lijst
Een lijst weergeven van alle apparaatgroepen in uw Azure Sphere-tenant.
Optionele parameters
| Parameter | Type | Description |
|---|---|---|
| -t, --tenant | GUID of naam | Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Hiermee overschrijft u de standaard geselecteerde tenant. U kunt de tenant-id of tenantnaam opgeven. |
Globale parameters
De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. Als u een fout vindt, kunt u een foutenrapport indienen op basis van de uitvoer die met de vlag --debug wordt gegeneerd. |
| -h, --help | Cli-referentiegegevens over opdrachten en de bijbehorende argumenten en lijsten met beschikbare subgroepen en opdrachten afdrukken. |
| --only-show-errors | Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt. |
| -o, --output | Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard is table de uitvoer van de CLI. Zie De uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
| --vraag | Hiermee wordt de JMESPath-querytaal gebruikt om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de zelfstudie JMESPath en Voer uitvoer van Azure CLI-opdrachten uit voor meer informatie en voorbeelden. |
| --verbose | Hiermee wordt informatie afgedrukt over resources die zijn gemaakt in Azure Sphere tijdens een bewerking en andere nuttige informatie. Gebruik --debug voor de volledige logboeken voor foutopsporing. |
Notitie
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u globale parameters voor meer informatie over beschikbare opties.
Opmerking
azsphere device-group list --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- ---------------------
Id Name Description ProductId OsFeedType UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
=====================================================================================================================================================================================================================================================================================
a3a49688-4601-4422-8b51-a0838ea84627 Development Default development device group 6f52bead-700d-4289-bdc2-2f11f774270e Retail Accept only system software updates. Don't accept application updates. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
7cb46b96-8c17-4afd-bd3f-614acad9d264 Field Test Default test device group 6f52bead-700d-4289-bdc2-2f11f774270e Retail Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
30c39bae-f525-4094-8008-d03705429ef0 Production Default production device group 6f52bead-700d-4289-bdc2-2f11f774270e Retail Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
cb5c9685-5dbe-470c-91a9-91dc129884d6 Production OS Evaluation Default Production OS Evaluation device group 6f52bead-700d-4289-bdc2-2f11f774270e RetailEval Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
63e72035-3fcf-4fdc-b88a-05e30d1ba224 Field Test OS Evaluation Default Field Test OS Evaluation device group 6f52bead-700d-4289-bdc2-2f11f774270e RetailEval Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- --------------------------------------------------
delete
Hiermee verwijdert u de opgegeven apparaatgroep in uw Azure Sphere-tenant.
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.
Vereiste parameters
| Parameter | Type | Description |
|---|---|---|
| -g, --device-group | String | Hiermee geeft u de apparaatgroep die moet worden verwijderd. U kunt de apparaatgroep-id of de naam van de apparaatgroep opgeven. Als u de naam van de apparaatgroep wilt gebruiken, moet u zowel de productnaam als de naam van de apparaatgroep opgeven in de <product-name/device-group-name> indeling. |
Optionele parameters
| Parameter | Type | Description |
|---|---|---|
| -t, --tenant | GUID of naam | Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Hiermee overschrijft u de standaard geselecteerde tenant. U kunt de tenant-id of tenantnaam opgeven. |
Globale parameters
De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. Als u een fout vindt, kunt u een foutenrapport indienen op basis van de uitvoer die met de vlag --debug wordt gegeneerd. |
| -h, --help | Cli-referentiegegevens over opdrachten en de bijbehorende argumenten en lijsten met beschikbare subgroepen en opdrachten afdrukken. |
| --only-show-errors | Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt. |
| -o, --output | Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard is table de uitvoer van de CLI. Zie De uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
| --vraag | Hiermee wordt de JMESPath-querytaal gebruikt om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de zelfstudie JMESPath en Voer uitvoer van Azure CLI-opdrachten uit voor meer informatie en voorbeelden. |
| --verbose | Hiermee wordt informatie afgedrukt over resources die zijn gemaakt in Azure Sphere tijdens een bewerking en andere nuttige informatie. Gebruik --debug voor de volledige logboeken voor foutopsporing. |
Notitie
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u globale parameters voor meer informatie over beschikbare opties.
Opmerking
azsphere device-group delete --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Successfully deleted the device group
azsphere device-group delete --device-group DW100/Development
Successfully deleted the device group
implementatie
Beheert implementaties voor een apparaatgroep.
| Operation | Omschrijving |
|---|---|
| create | Hiermee maakt u een nieuwe implementatie voor de opgegeven apparaatgroep. |
| lijst | Geeft de implementaties voor een apparaatgroep weer. |
implementatie maken
Hiermee maakt u een nieuwe implementatie voor een apparaatgroep met de opgegeven installatiekopieën.
U kunt de apparaatgroep identificeren op id (id) of op een productnaam en een paar apparaatgroepen.
Vereiste parameters
| Parameter | Type | Description |
|---|---|---|
| -g, --device-group | String | Hiermee geeft u de apparaatgroep op waarin de implementatie moet worden gemaakt. U kunt de apparaatgroep-id of de naam van de apparaatgroep opgeven. Als u de naam van de apparaatgroep wilt gebruiken, moet u zowel de productnaam als de naam van de apparaatgroep opgeven in de <product-name/device-group-name> indeling. |
| -i, --images | String | Hiermee geeft u de installatiekopieën-id's op voor een of meer installatiekopieën die moeten worden opgenomen in de implementatie. U kunt meerdere installatiekopieën toevoegen door extra parameters toe te voegen of meerdere afbeeldings-id's kunnen worden gecombineerd in één parameter in een door spaties gescheiden lijst. Voer de opdracht azsphere image add uit om de installatiekopieën-id op te halen. |
Optionele parameters
| Parameter | Type | Description |
|---|---|---|
| -t, --tenant | GUID of naam | Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Hiermee overschrijft u de standaard geselecteerde tenant. U kunt de tenant-id of tenantnaam opgeven. |
Globale parameters
De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. Als u een fout vindt, kunt u een foutenrapport indienen op basis van de uitvoer die met de vlag --debug wordt gegeneerd. |
| -h, --help | Cli-referentiegegevens over opdrachten en de bijbehorende argumenten en lijsten met beschikbare subgroepen en opdrachten afdrukken. |
| --only-show-errors | Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt. |
| -o, --output | Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard is table de uitvoer van de CLI. Zie De uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
| --vraag | Hiermee wordt de JMESPath-querytaal gebruikt om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de zelfstudie JMESPath en Voer uitvoer van Azure CLI-opdrachten uit voor meer informatie en voorbeelden. |
| --verbose | Hiermee wordt informatie afgedrukt over resources die zijn gemaakt in Azure Sphere tijdens een bewerking en andere nuttige informatie. Gebruik --debug voor de volledige logboeken voor foutopsporing. |
Notitie
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u globale parameters voor meer informatie over beschikbare opties.
Opmerking
De --device-group parameter identificeert de apparaatgroep. De apparaatgroep-id levert een GUID, waarmee de apparaatgroep uniek wordt geïdentificeerd in alle producten. U kunt ook het paar productnamen en apparaatgroepen gebruiken in de <indeling productnaam>/<apparaatgroepnaam> . Met dit paar namen wordt een apparaatgroep voor een bepaald product uniek geïdentificeerd.
Voorbeeld voor het opgeven van apparaatgroep op id:
azsphere device-group deployment create --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd --images 5572509b-43a4-45b0-88c5-365cbf9732c1
Voorbeeld van het opgeven van apparaatgroep op naam:
azsphere device-group deployment create --device-group DW100/Development --images 5572509b-43a4-45b0-88c5-365cbf9732c1
Voorbeeld van het opgeven van meerdere afbeeldings-id's door een lijst met waarden op te geven, gescheiden door spaties:
azsphere device-group deployment create --device-group DW100/Development --images 5572509b-43a4-45b0-88c5-365cbf9732c1 3bbd2d2a-2870-4dde-9db8-ae50548ea7b4
De uitvoer ziet er als volgt uit:
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
Id TenantId DeployedImages DeploymentDateUtc
===================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb 5572509b-43a4-45b0-88c5-365cbf9732c1 2021-04-01T18:48:41.721662+00:00
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
implementatielijst
Geeft de implementatiegeschiedenis voor een apparaatgroep weer. Retourneert de implementatie-id, tijdstempel en lijst met opgenomen installatiekopieën. De lijst wordt gerangschikt op de meest recente implementaties.
Vereiste parameters
| Parameter | Type | Description |
|---|---|---|
| -g, --device-group | String | Hiermee geeft u de apparaatgroep op waarvoor de lijst met implementatiegeschiedenis moet worden weergegeven. U kunt de apparaatgroep-id of de naam van de apparaatgroep opgeven. Als u de naam van de apparaatgroep wilt gebruiken, moet u zowel de productnaam als de naam van de apparaatgroep opgeven in de <product-name/device-group-name> indeling. |
Optionele parameters
| Parameter | Type | Description |
|---|---|---|
| -t, --tenant | GUID of naam | Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Hiermee overschrijft u de standaard geselecteerde tenant. U kunt de tenant-id of tenantnaam opgeven. |
Globale parameters
De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. Als u een fout vindt, kunt u een foutenrapport indienen op basis van de uitvoer die met de vlag --debug wordt gegeneerd. |
| -h, --help | Cli-referentiegegevens over opdrachten en de bijbehorende argumenten en lijsten met beschikbare subgroepen en opdrachten afdrukken. |
| --only-show-errors | Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt. |
| -o, --output | Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard is table de uitvoer van de CLI. Zie De uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
| --vraag | Hiermee wordt de JMESPath-querytaal gebruikt om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de zelfstudie JMESPath en Voer uitvoer van Azure CLI-opdrachten uit voor meer informatie en voorbeelden. |
| --verbose | Hiermee wordt informatie afgedrukt over resources die zijn gemaakt in Azure Sphere tijdens een bewerking en andere nuttige informatie. Gebruik --debug voor de volledige logboeken voor foutopsporing. |
Notitie
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u globale parameters voor meer informatie over beschikbare opties.
Opmerking
Voorbeeld voor het opgeven van apparaatgroep op id:
azsphere device-group deployment list --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Voorbeeld van het opgeven van apparaatgroep op naam:
azsphere device-group deployment list --device-group DW100/Development
De uitvoer ziet er als volgt uit:
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
Id TenantId DeployedImages DeploymentDateUtc
===================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb e3769536-dc4b-48d9-afd4-22ed321ba4bc 2020-11-18T19:46:50.514429+00:00
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
apparaat
Hiermee beheert u apparaten voor een apparaatgroep.
| Operation | Omschrijving |
|---|---|
| lijst | Geeft de apparaten weer in een apparaatgroep. |
| show-count | Geeft het aantal apparaten in een apparaatgroep weer. |
apparaatlijst
Geeft de apparaten weer in een apparaatgroep.
Vereiste parameters
| Parameter | Type | Description |
|---|---|---|
| -g, --device-group | String | Hiermee geeft u de apparaatgroep op waarvoor de lijst met apparaten moet worden weergegeven. U kunt de apparaatgroep-id of de naam van de apparaatgroep opgeven. Als u de naam van de apparaatgroep wilt gebruiken, moet u zowel de productnaam als de naam van de apparaatgroep opgeven in de <product-name/device-group-name> indeling. |
Optionele parameters
| Parameter | Type | Description |
|---|---|---|
| -t, --tenant | GUID of naam | Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Hiermee overschrijft u de standaard geselecteerde tenant. U kunt de tenant-id of tenantnaam opgeven. |
Globale parameters
De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. Als u een fout vindt, kunt u een foutenrapport indienen op basis van de uitvoer die met de vlag --debug wordt gegeneerd. |
| -h, --help | Cli-referentiegegevens over opdrachten en de bijbehorende argumenten en lijsten met beschikbare subgroepen en opdrachten afdrukken. |
| --only-show-errors | Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt. |
| -o, --output | Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard is table de uitvoer van de CLI. Zie De uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
| --vraag | Hiermee wordt de JMESPath-querytaal gebruikt om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de zelfstudie JMESPath en Voer uitvoer van Azure CLI-opdrachten uit voor meer informatie en voorbeelden. |
| --verbose | Hiermee wordt informatie afgedrukt over resources die zijn gemaakt in Azure Sphere tijdens een bewerking en andere nuttige informatie. Gebruik --debug voor de volledige logboeken voor foutopsporing. |
Notitie
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u globale parameters voor meer informatie over beschikbare opties.
Opmerking
Voorbeeld voor het opgeven van apparaatgroep op id:
azsphere device-group device list --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Voorbeeld van het opgeven van apparaatgroep op naam:
azsphere device-group device list --device-group DW100/Marketing
De uitvoer ziet er als volgt uit:
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
DeviceId TenantId ProductId DeviceGroupId
===================================================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 143adbc9-1bf0-4be2-84a2-084a331d81cb 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
show-count van apparaat
Geeft het aantal apparaten in een apparaatgroep weer.
Vereiste parameters
| Parameter | Type | Description |
|---|---|---|
| -g, --device-group | String | Hiermee geeft u de apparaatgroep op waarvoor het aantal apparaten moet worden weergegeven. U kunt de apparaatgroep-id of de naam van de apparaatgroep opgeven. Als u de naam van de apparaatgroep wilt gebruiken, moet u zowel de productnaam als de naam van de apparaatgroep opgeven in de <product-name/device-group-name> indeling. |
Optionele parameters
| Parameter | Type | Description |
|---|---|---|
| -t, --tenant | GUID of naam | Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Hiermee overschrijft u de standaard geselecteerde tenant. U kunt de tenant-id of tenantnaam opgeven. |
Globale parameters
De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. Als u een fout vindt, kunt u een foutenrapport indienen op basis van de uitvoer die met de vlag --debug wordt gegeneerd. |
| -h, --help | Cli-referentiegegevens over opdrachten en de bijbehorende argumenten en lijsten met beschikbare subgroepen en opdrachten afdrukken. |
| --only-show-errors | Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt. |
| -o, --output | Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard is table de uitvoer van de CLI. Zie De uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
| --vraag | Hiermee wordt de JMESPath-querytaal gebruikt om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de zelfstudie JMESPath en Voer uitvoer van Azure CLI-opdrachten uit voor meer informatie en voorbeelden. |
| --verbose | Hiermee wordt informatie afgedrukt over resources die zijn gemaakt in Azure Sphere tijdens een bewerking en andere nuttige informatie. Gebruik --debug voor de volledige logboeken voor foutopsporing. |
Notitie
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u globale parameters voor meer informatie over beschikbare opties.
Opmerking
Voorbeeld voor het opgeven van apparaatgroep op id:
azsphere device-group device show-count --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Voorbeeld om apparaatgroep op naam op te geven:
azsphere device-group device show-count --device-group DW100/Marketing
De uitvoer ziet er als volgt uit:
------
Result
======
1
------
weergeven
Retourneert informatie over een apparaatgroep.
Vereiste parameters
| Parameter | Type | Description |
|---|---|---|
| -g, --device-group | String | Hiermee geeft u de apparaatgroep op waarvoor details moeten worden weergegeven. U kunt de apparaatgroep-id of de naam van de apparaatgroep opgeven. Als u de naam van de apparaatgroep wilt gebruiken, moet u zowel de productnaam als de naam van de apparaatgroep opgeven in de <product-name/device-group-name> indeling. |
Optionele parameters
| Parameter | Type | Description |
|---|---|---|
| -t, --tenant | GUID of naam | Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Hiermee overschrijft u de standaard geselecteerde tenant. U kunt de tenant-id of tenantnaam opgeven. |
Globale parameters
De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. Als u een fout vindt, kunt u een foutenrapport indienen op basis van de uitvoer die met de vlag --debug wordt gegeneerd. |
| -h, --help | Cli-referentiegegevens over opdrachten en de bijbehorende argumenten en lijsten met beschikbare subgroepen en opdrachten afdrukken. |
| --only-show-errors | Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt. |
| -o, --output | Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard is table de uitvoer van de CLI. Zie De uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
| --vraag | Hiermee wordt de JMESPath-querytaal gebruikt om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de zelfstudie JMESPath en Voer uitvoer van Azure CLI-opdrachten uit voor meer informatie en voorbeelden. |
| --verbose | Hiermee wordt informatie afgedrukt over resources die zijn gemaakt in Azure Sphere tijdens een bewerking en andere nuttige informatie. Gebruik --debug voor de volledige logboeken voor foutopsporing. |
Notitie
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u globale parameters voor meer informatie over beschikbare opties.
Opmerking
Voorbeeld voor het opgeven van apparaatgroep op id:
azsphere device-group show --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Voorbeeld om apparaatgroep op naam op te geven:
azsphere device-group show --device-group DW100/Marketing
De uitvoer ziet er als volgt uit:
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
Id Name Description TenantId ProductId OsFeedType UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
========================================================================================================================================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd Marketing Marketing device group 143adbc9-1bf0-4be2-84a2-084a331d81cb 6f52bead-700d-4289-bdc2-2f11f774270e Retail Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
update
Hiermee werkt u een bestaande apparaatgroep bij, geïdentificeerd met id of productnaam en paar apparaatgroepen.
Vereiste parameters
| Parameter | Type | Description |
|---|---|---|
| -g, --device-group | String | Hiermee geeft u de apparaatgroep op waarvoor details moeten worden bijgewerkt. U kunt de apparaatgroep-id of de naam van de apparaatgroep opgeven. Als u de naam van de apparaatgroep wilt gebruiken, moet u zowel de productnaam als de naam van de apparaatgroep opgeven in de <product-name/device-group-name> indeling. |
Optionele parameters
| Parameter | Type | Description |
|---|---|---|
| -c, --allow-crash-dumps-collection | String | Stel toestemming in voor het verzamelen van crashdumps door Microsoft voor de apparaatgroep. Standaard is Off. Toegestane waarden: Off en On. Gebruik de --regional-data-boundary parameter om op te geven waar de crashdumpbestanden moeten worden opgeslagen. Zie Crashdumps configureren voor meer informatie. |
| -a, --application-update | ApplicationUpdatePolicyType | Hiermee geeft u het updatebeleid voor de toepassing voor de apparaatgroep. Toegestane waarden: No3rdPartyAppUpdates, UpdateAllen NoUpdates. Standaard is UpdateAll. Het NoUpdates beleid is momenteel alleen gereserveerd voor intern gebruik. |
| -d, --new-description | String | Hiermee geeft u optionele tekst om de apparaatgroep te beschrijven. De maximale lengte is 100 tekens. |
| -n, --nieuwe-naam | String | Hiermee geeft u een nieuwe naam voor de apparaatgroep. De naam mag alleen alfanumerieke tekens bevatten. Als de naam spaties bevat, plaatst u deze tussen aanhalingstekens. De naam van de apparaatgroep mag niet langer zijn dan 50 tekens, is niet hoofdlettergevoelig en moet uniek zijn binnen het product. |
| -f, --os-feed | String | Hiermee geeft u de besturingssysteemfeed voor de apparaatgroep. Mogelijke waarden zijn Retail en RetailEval. |
| -t, --tenant | GUID of naam | Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Hiermee overschrijft u de standaard geselecteerde tenant. U kunt de tenant-id of tenantnaam opgeven. |
| -r, --regional-data-boundary | String | Regionale gegevensgrens voor deze afbeelding. Toegestane waarden: EU, None. De standaardwaarde is None. Als er geen waarde is opgegeven, wordt de standaardwaarde gebruikt. Zie Crashdumps configureren voor meer informatie - Pivacy-overwegingen |
Globale parameters
De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. Als u een fout vindt, kunt u een foutenrapport indienen op basis van de uitvoer die met de vlag --debug wordt gegeneerd. |
| -h, --help | Cli-referentiegegevens over opdrachten en de bijbehorende argumenten en lijsten met beschikbare subgroepen en opdrachten afdrukken. |
| --only-show-errors | Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt. |
| -o, --output | Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard is table de uitvoer van de CLI. Zie De uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
| --vraag | Hiermee wordt de JMESPath-querytaal gebruikt om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de zelfstudie JMESPath en Voer uitvoer van Azure CLI-opdrachten uit voor meer informatie en voorbeelden. |
| --verbose | Hiermee wordt informatie afgedrukt over resources die zijn gemaakt in Azure Sphere tijdens een bewerking en andere nuttige informatie. Gebruik --debug voor de volledige logboeken voor foutopsporing. |
Notitie
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u globale parameters voor meer informatie over beschikbare opties.
Opmerking
Voorbeeld voor het opgeven van apparaatgroep op id:
azsphere device-group update --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd --new-description "Marketing device group"
Voorbeeld om apparaatgroep op naam op te geven:
azsphere device-group update --device-group DW100/Marketing --new-description "Marketing device group"
De uitvoer ziet er als volgt uit:
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------
Id TenantId OsFeedType ProductId Name Description UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
========================================================================================================================================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail 6f52bead-700d-4289-bdc2-2f11f774270e Marketing Marketing device group Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------