apparaatgroep
Maakt en beheert apparaatgroepen.
Apparaatgroepen worden geadresseerd door id (id) of door een productnaam en een naampaar van de apparaatgroep.
| Bewerking | Beschrijving |
|---|---|
| Maken | Hiermee maakt u een nieuwe apparaatgroep. |
| Lijst | Alle apparaatgroepen in uw Azure Sphere-tenant weergeven. |
| Verwijderen | Hiermee verwijdert u een bestaande apparaatgroep. |
| Implementatie | Hiermee beheert u implementaties binnen een apparaatgroep. |
| Apparaat | Een lijst met apparaten in een apparaatgroep. |
| Toon | 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 die hetzelfde product hebben en dezelfde toepassingen ontvangen uit de cloud.
Vereiste parameters
| Parameter | Type | Beschrijving |
|---|---|---|
| -p, --product | GUID of naam | Hiermee geeft u het product aan waaraan deze apparaatgroep moet worden toegevoegd. U kunt de id of naam van het Azure Sphere-product opgeven. |
| -n, --name | Tekenreeks | Hiermee geeft u een 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, moet uniek zijn binnen het product. |
Optionele parameters
| Parameter | Type | Beschrijving |
|---|---|---|
| -a, --application-update | Enum | Hiermee geeft u het updatebeleid voor de toepassing op deze apparaatgroep. Geaccepteerde waarden: No3rdPartyAppUpdates, UpdateAllen NoUpdates. De standaardwaarde is UpdateAll. Het NoUpdates beleid is momenteel alleen gereserveerd voor intern gebruik. |
| -f, --os-feed | Enum | Hiermee geeft u het type besturingssysteemfeed 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. Overschrijft de standaard geselecteerde tenant. U kunt de tenant-id of tenantnaam opgeven. |
| -d, --description | Tekenreeks | 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 | Tekenreeks | 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 - Aandachtspunten voor pivacy voor meer informatie |
Globale parameters
De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:
| Parameter | Beschrijving |
|---|---|
| --Debug | Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport. |
| -h, --help | Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten. |
| --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 voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
| --Query | Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden. |
| --Uitgebreide | Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken. |
Opmerking
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.
Voorbeeld
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
Alle apparaatgroepen in uw Azure Sphere-tenant weergeven.
Optionele parameters
| Parameter | Type | Beschrijving |
|---|---|---|
| -t, --tenant | GUID of naam | Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Overschrijft 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 | Beschrijving |
|---|---|
| --Debug | Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport. |
| -h, --help | Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten. |
| --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 voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
| --Query | Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden. |
| --Uitgebreide | Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken. |
Opmerking
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.
Voorbeeld
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
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- --------------------------------------------------
Verwijderen
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 vermeld. Voer azsphere device update --device-group uit om het apparaat naar een andere apparaatgroep te verplaatsen.
Vereiste parameters
| Parameter | Type | Beschrijving |
|---|---|---|
| -g, --device-group | Tekenreeks | Hiermee geeft u de apparaatgroep te verwijderen. 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 in de <product-name/device-group-name> indeling opgeven. |
Optionele parameters
| Parameter | Type | Beschrijving |
|---|---|---|
| -t, --tenant | GUID of naam | Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Overschrijft 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 | Beschrijving |
|---|---|
| --Debug | Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport. |
| -h, --help | Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten. |
| --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 voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
| --Query | Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden. |
| --Uitgebreide | Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken. |
Opmerking
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.
Voorbeeld
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
Hiermee beheert u implementaties voor een apparaatgroep.
| Bewerking | Beschrijving |
|---|---|
| Maken | 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 herkennen aan de id (id) of aan een productnaam en een naampaar van de apparaatgroep.
Vereiste parameters
| Parameter | Type | Beschrijving |
|---|---|---|
| -g, --device-group | Tekenreeks | 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 in de <product-name/device-group-name> indeling opgeven. |
| -i, --images | Tekenreeks | 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 | Beschrijving |
|---|---|---|
| -t, --tenant | GUID of naam | Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Overschrijft 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 | Beschrijving |
|---|---|
| --Debug | Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport. |
| -h, --help | Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten. |
| --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 voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
| --Query | Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden. |
| --Uitgebreide | Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken. |
Opmerking
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.
Voorbeeld
De --device-group parameter identificeert de apparaatgroep. De id van de apparaatgroep levert een GUID, waarmee de apparaatgroep in alle producten uniek wordt geïdentificeerd. U kunt ook de productnaam en het naampaar van de apparaatgroep gebruiken in de <indeling product-naam>/<apparaatgroep-naam> . Dit paar namen identificeert op unieke wijze een apparaatgroep voor een bepaald product.
Voorbeeld van het opgeven van een 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 een 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
U ziet de uitvoer als volgt:
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
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 is gerangschikt op de meest recente implementaties.
Vereiste parameters
| Parameter | Type | Beschrijving |
|---|---|---|
| -g, --device-group | Tekenreeks | 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 in de <product-name/device-group-name> indeling opgeven. |
Optionele parameters
| Parameter | Type | Beschrijving |
|---|---|---|
| -t, --tenant | GUID of naam | Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Overschrijft 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 | Beschrijving |
|---|---|
| --Debug | Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport. |
| -h, --help | Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten. |
| --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 voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
| --Query | Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden. |
| --Uitgebreide | Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken. |
Opmerking
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.
Voorbeeld
Voorbeeld van het opgeven van een apparaatgroep op id:
azsphere device-group deployment list --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Voorbeeld van het opgeven van een apparaatgroep op naam:
azsphere device-group deployment list --device-group DW100/Development
U ziet de uitvoer als volgt:
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
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.
| Bewerking | Beschrijving |
|---|---|
| Lijst | Geeft de apparaten in een apparaatgroep weer. |
| show-count | Toont het aantal apparaten in een apparaatgroep. |
apparatenlijst
Geeft de apparaten in een apparaatgroep weer.
Vereiste parameters
| Parameter | Type | Beschrijving |
|---|---|---|
| -g, --device-group | Tekenreeks | Hiermee geeft u de apparaatgroep 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 in de <product-name/device-group-name> indeling opgeven. |
Optionele parameters
| Parameter | Type | Beschrijving |
|---|---|---|
| -t, --tenant | GUID of naam | Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Overschrijft 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 | Beschrijving |
|---|---|
| --Debug | Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport. |
| -h, --help | Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten. |
| --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 voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
| --Query | Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden. |
| --Uitgebreide | Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken. |
Opmerking
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.
Voorbeeld
Voorbeeld van het opgeven van een apparaatgroep op id:
azsphere device-group device list --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Voorbeeld van het opgeven van een apparaatgroep op naam:
azsphere device-group device list --device-group DW100/Marketing
U ziet de uitvoer als volgt:
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
DeviceId TenantId ProductId DeviceGroupId
===================================================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 143adbc9-1bf0-4be2-84a2-084a331d81cb 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
aantal apparaatshows
Geeft het aantal apparaten in een apparaatgroep weer.
Vereiste parameters
| Parameter | Type | Beschrijving |
|---|---|---|
| -g, --device-group | Tekenreeks | 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 in de <product-name/device-group-name> indeling opgeven. |
Optionele parameters
| Parameter | Type | Beschrijving |
|---|---|---|
| -t, --tenant | GUID of naam | Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Overschrijft 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 | Beschrijving |
|---|---|
| --Debug | Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport. |
| -h, --help | Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten. |
| --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 voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
| --Query | Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden. |
| --Uitgebreide | Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken. |
Opmerking
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.
Voorbeeld
Voorbeeld om apparaatgroep op id op te geven:
azsphere device-group device show-count --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Voorbeeld van het opgeven van apparaatgroep op naam:
azsphere device-group device show-count --device-group DW100/Marketing
U ziet de uitvoer als volgt:
------
Result
======
1
------
Toon
Retourneert informatie over een apparaatgroep.
Vereiste parameters
| Parameter | Type | Beschrijving |
|---|---|---|
| -g, --device-group | Tekenreeks | Hiermee geeft u de apparaatgroep 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 in de <product-name/device-group-name> indeling opgeven. |
Optionele parameters
| Parameter | Type | Beschrijving |
|---|---|---|
| -t, --tenant | GUID of naam | Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Overschrijft 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 | Beschrijving |
|---|---|
| --Debug | Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport. |
| -h, --help | Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten. |
| --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 voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
| --Query | Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden. |
| --Uitgebreide | Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken. |
Opmerking
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.
Voorbeeld
Voorbeeld om apparaatgroep op id op te geven:
azsphere device-group show --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Voorbeeld van het opgeven van apparaatgroep op naam:
azsphere device-group show --device-group DW100/Marketing
U ziet de uitvoer als volgt:
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
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
Updates een bestaande apparaatgroep, geïdentificeerd door id of door productnaam en apparaatgroepnaampaar.
Vereiste parameters
| Parameter | Type | Beschrijving |
|---|---|---|
| -g, --device-group | Tekenreeks | Hiermee geeft u de apparaatgroep waarvoor de 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 in de <product-name/device-group-name> indeling opgeven. |
Optionele parameters
| Parameter | Type | Beschrijving |
|---|---|---|
| -c, --allow-crash-dumps-collection | Tekenreeks | Stel toestemming in voor het verzamelen van crashdumps door Microsoft voor de apparaatgroep. De standaardwaarde 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. De standaardwaarde is UpdateAll. Het NoUpdates beleid is momenteel alleen gereserveerd voor intern gebruik. |
| -d, --new-description | Tekenreeks | Hiermee geeft u optionele tekst om de apparaatgroep te beschrijven. De maximale lengte is 100 tekens. |
| -n, --new-name | Tekenreeks | 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 | Tekenreeks | Hiermee geeft u de besturingssysteemfeed voor de apparaatgroep op. Mogelijke waarden zijn Retail en RetailEval. |
| -t, --tenant | GUID of naam | Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Overschrijft de standaard geselecteerde tenant. U kunt de tenant-id of tenantnaam opgeven. |
| -r, --regional-data-boundary | Tekenreeks | 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 - Aandachtspunten voor pivacy voor meer informatie |
Globale parameters
De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:
| Parameter | Beschrijving |
|---|---|
| --Debug | Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport. |
| -h, --help | Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten. |
| --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 voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
| --Query | Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden. |
| --Uitgebreide | Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken. |
Opmerking
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.
Voorbeeld
Voorbeeld om apparaatgroep op id op te geven:
azsphere device-group update --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd --new-description "Marketing device group"
Voorbeeld van het opgeven van apparaatgroep op naam:
azsphere device-group update --device-group DW100/Marketing --new-description "Marketing device group"
U ziet de uitvoer als volgt:
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------
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
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------