enhetsgrupp
Viktigt!
Det här är dokumentationen om Azure Sphere (Legacy). Azure Sphere (Legacy) upphör den 27 september 2027 och användarna måste migrera till Azure Sphere (integrerad) vid den här tiden. Använd versionsväljaren ovanför TOC för att visa dokumentationen om Azure Sphere (integrerad).
Skapar och hanterar enhetsgrupper.
Enhetsgrupper adresseras antingen med identifierare (ID) eller med ett produktnamn och ett namnpar för enhetsgrupp.
| Operation | beskrivning |
|---|---|
| skapa | Skapar en ny enhetsgrupp. |
| lista | Visa en lista över alla enhetsgrupper i din Azure Sphere-klientorganisation. |
| ta bort | Tar bort en befintlig enhetsgrupp. |
| utplacering | Hanterar distributioner i en enhetsgrupp. |
| apparat | Visar en lista över enheter i en enhetsgrupp. |
| visa | Visar information om en enhetsgrupp. |
| uppdatera | Ändrar en befintlig enhetsgrupp. |
skapa
Skapar en enhetsgrupp med det angivna namnet på den angivna produkten. Enhetsgruppen organiserar enheter som har samma produkt och tar emot samma program från molnet.
Obligatoriska parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| -p, --product | GUID eller namn | Anger den produkt som den här enhetsgruppen ska läggas till i. Du kan ange antingen ID:t eller namnet på Azure Sphere-produkten. |
| -n, --name | String | Anger ett namn för enhetsgruppen. Namnet kan bara innehålla alfanumeriska tecken. Om namnet innehåller blanksteg omger du det inom citattecken. Enhetsgruppens namn får inte överstiga 50 tecken, är skiftlägesokänsligt, måste vara unikt i produkten. |
Valfria parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| -a, --application-update | Enum | Anger den programuppdateringsprincip som ska tillämpas för den här enhetsgruppen. Godkända värden: No3rdPartyAppUpdates, UpdateAlloch NoUpdates. Standard är UpdateAll. Principen NoUpdates är för närvarande endast reserverad för internt bruk. |
| -f, --os-feed | Enum | Anger vilken typ av os-feed som ska användas för OS-uppdateringar. Godkända värden: Retail, RetailEval. |
| -t, --tenant | GUID eller namn | Anger den klientorganisation som åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientnamn. |
| -d, --description | String | Anger den valfria texten för att beskriva enhetsgruppen. Den maximala längden är 100 tecken. Om beskrivningen innehåller blanksteg omger du den inom citattecken. |
| -r, --regional-data-boundary | String | Regional datagräns för den här avbildningen. Tillåtna värden: EU, None. Standardvärdet är None. Om inget värde anges används standardvärdet. Mer information finns i Konfigurera kraschdumpar – Pivacy-överväganden |
Globala parametrar
Följande globala parametrar är tillgängliga för Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --felsöka | Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan --debug när du skickar en felrapport. |
| -h, --help | Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon. |
| --only-show-errors | Visar endast fel och undertrycker varningar. |
| -o, --output | Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut table. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon. |
| --fråga | Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata . |
| --mångordig | Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra --debug. |
Kommentar
Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.
Exempel
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
------------------------------------ ------------------------------------ ---------- ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
lista
Visa en lista över alla enhetsgrupper i din Azure Sphere-klientorganisation.
Valfria parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| -t, --tenant | GUID eller namn | Anger den klientorganisation som åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientnamn. |
Globala parametrar
Följande globala parametrar är tillgängliga för Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --felsöka | Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan --debug när du skickar en felrapport. |
| -h, --help | Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon. |
| --only-show-errors | Visar endast fel och undertrycker varningar. |
| -o, --output | Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut table. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon. |
| --fråga | Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata . |
| --mångordig | Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra --debug. |
Kommentar
Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.
Exempel
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
Tar bort den angivna enhetsgruppen i din Azure Sphere-klientorganisation.
En enhetsgrupp kan bara tas bort när:
- Användaren har administratörsbehörighet till klientorganisationen.
- Enhetsgruppen är tom och har inga enheter i den. Kommandot azsphere device-group device list list alla enheter i en enhetsgrupp. Kör azsphere device update --device-group för att flytta enheten till en annan enhetsgrupp.
Obligatoriska parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| -g, --device-group | String | Anger vilken enhetsgrupp som ska tas bort. Du kan ange enhetsgrupps-ID eller enhetsgruppsnamn. Om du vill använda enhetsgruppens namn måste du ange både produktnamnet och enhetsgruppens <product-name/device-group-name> namn i formatet. |
Valfria parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| -t, --tenant | GUID eller namn | Anger den klientorganisation som åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientnamn. |
Globala parametrar
Följande globala parametrar är tillgängliga för Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --felsöka | Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan --debug när du skickar en felrapport. |
| -h, --help | Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon. |
| --only-show-errors | Visar endast fel och undertrycker varningar. |
| -o, --output | Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut table. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon. |
| --fråga | Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata . |
| --mångordig | Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra --debug. |
Kommentar
Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.
Exempel
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
distribution
Hanterar distributioner för en enhetsgrupp.
| Operation | beskrivning |
|---|---|
| skapa | Skapar en ny distribution för den angivna enhetsgruppen. |
| lista | Visar distributionerna för en enhetsgrupp. |
skapa distribution
Skapar en ny distribution för en enhetsgrupp med de angivna avbildningarna.
Du kan identifiera enhetsgruppen antingen efter identifierare (ID) eller med ett produktnamn och ett namnpar för enhetsgruppen.
Obligatoriska parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| -g, --device-group | String | Anger den enhetsgrupp där distributionen ska skapas. Du kan ange enhetsgrupps-ID eller enhetsgruppsnamn. Om du vill använda enhetsgruppens namn måste du ange både produktnamnet och enhetsgruppens <product-name/device-group-name> namn i formatet. |
| -i, --images | String | Anger avbildnings-ID:t för en eller flera avbildningar som ska inkluderas i distributionen. Du kan lägga till flera bilder genom att lägga till ytterligare parametrar, eller så kan flera bild-ID:t kombineras i en enda parameter i en blankstegsavgränsad lista. Kör kommandot azsphere image add för att hämta avbildnings-ID:t. |
Valfria parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| -t, --tenant | GUID eller namn | Anger den klientorganisation som åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientnamn. |
Globala parametrar
Följande globala parametrar är tillgängliga för Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --felsöka | Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan --debug när du skickar en felrapport. |
| -h, --help | Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon. |
| --only-show-errors | Visar endast fel och undertrycker varningar. |
| -o, --output | Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut table. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon. |
| --fråga | Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata . |
| --mångordig | Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra --debug. |
Kommentar
Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.
Exempel
Parametern --device-group identifierar enhetsgruppen. Enhetsgrupp-ID:t tillhandahåller ett GUID som unikt identifierar enhetsgruppen för alla produkter. Du kan också använda produktnamnet och enhetsgruppens namnpar i <formatet product-name>/<device-group-name> . Det här namnparet identifierar unikt en enhetsgrupp för en viss produkt.
Exempel för att ange enhetsgrupp efter ID:
azsphere device-group deployment create --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd --images 5572509b-43a4-45b0-88c5-365cbf9732c1
Exempel för att ange enhetsgrupp efter namn:
azsphere device-group deployment create --device-group DW100/Development --images 5572509b-43a4-45b0-88c5-365cbf9732c1
Exempel för att ange flera bild-ID:t genom att ange en lista med värden avgränsade med blanksteg:
azsphere device-group deployment create --device-group DW100/Development --images 5572509b-43a4-45b0-88c5-365cbf9732c1 3bbd2d2a-2870-4dde-9db8-ae50548ea7b4
Du bör se utdata som ser ut så här:
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
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
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
distributionslista
Visar distributionshistoriken för en enhetsgrupp. Returnerar distributions-ID, tidsstämpel och lista över inkluderade avbildningar. Listan sorteras efter de senaste distributionerna.
Obligatoriska parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| -g, --device-group | String | Anger den enhetsgrupp som distributionshistoriklistan ska visas för. Du kan ange enhetsgrupps-ID eller enhetsgruppsnamn. Om du vill använda enhetsgruppens namn måste du ange både produktnamnet och enhetsgruppens <product-name/device-group-name> namn i formatet. |
Valfria parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| -t, --tenant | GUID eller namn | Anger den klientorganisation som åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientnamn. |
Globala parametrar
Följande globala parametrar är tillgängliga för Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --felsöka | Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan --debug när du skickar en felrapport. |
| -h, --help | Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon. |
| --only-show-errors | Visar endast fel och undertrycker varningar. |
| -o, --output | Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut table. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon. |
| --fråga | Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata . |
| --mångordig | Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra --debug. |
Kommentar
Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.
Exempel
Exempel för att ange enhetsgrupp efter ID:
azsphere device-group deployment list --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Exempel för att ange enhetsgrupp efter namn:
azsphere device-group deployment list --device-group DW100/Development
Du bör se utdata som ser ut så här:
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
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
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
enhet
Hanterar enheter för en enhetsgrupp.
| Operation | beskrivning |
|---|---|
| lista | Visar enheterna i en enhetsgrupp. |
| show-count | Visar antalet enheter i en enhetsgrupp. |
enhetslista
Visar enheterna i en enhetsgrupp.
Obligatoriska parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| -g, --device-group | String | Anger den enhetsgrupp som enhetslistan ska visas för. Du kan ange enhetsgrupps-ID eller enhetsgruppsnamn. Om du vill använda enhetsgruppens namn måste du ange både produktnamnet och enhetsgruppens <product-name/device-group-name> namn i formatet. |
Valfria parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| -t, --tenant | GUID eller namn | Anger den klientorganisation som åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientnamn. |
Globala parametrar
Följande globala parametrar är tillgängliga för Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --felsöka | Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan --debug när du skickar en felrapport. |
| -h, --help | Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon. |
| --only-show-errors | Visar endast fel och undertrycker varningar. |
| -o, --output | Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut table. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon. |
| --fråga | Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata . |
| --mångordig | Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra --debug. |
Kommentar
Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.
Exempel
Exempel för att ange enhetsgrupp efter ID:
azsphere device-group device list --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Exempel för att ange enhetsgrupp efter namn:
azsphere device-group device list --device-group DW100/Marketing
Du bör se utdata som ser ut så här:
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
DeviceId TenantId ProductId DeviceGroupId
===================================================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 143adbc9-1bf0-4be2-84a2-084a331d81cb 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
enhetsvisningsantal
Visar antalet enheter i en enhetsgrupp.
Obligatoriska parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| -g, --device-group | String | Anger den enhetsgrupp som enhetens antal ska visas för. Du kan ange enhetsgrupps-ID eller enhetsgruppsnamn. Om du vill använda enhetsgruppens namn måste du ange både produktnamnet och enhetsgruppens <product-name/device-group-name> namn i formatet. |
Valfria parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| -t, --tenant | GUID eller namn | Anger den klientorganisation som åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientnamn. |
Globala parametrar
Följande globala parametrar är tillgängliga för Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --felsöka | Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan --debug när du skickar en felrapport. |
| -h, --help | Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon. |
| --only-show-errors | Visar endast fel och undertrycker varningar. |
| -o, --output | Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut table. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon. |
| --fråga | Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata . |
| --mångordig | Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra --debug. |
Kommentar
Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.
Exempel
Exempel för att ange enhetsgrupp efter ID:
azsphere device-group device show-count --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Exempel för att ange enhetsgrupp efter namn:
azsphere device-group device show-count --device-group DW100/Marketing
Du bör se utdata som ser ut så här:
------
Result
======
1
------
visa
Returnerar information om en enhetsgrupp.
Obligatoriska parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| -g, --device-group | String | Anger den enhetsgrupp som information ska visas för. Du kan ange enhetsgrupps-ID eller enhetsgruppsnamn. Om du vill använda enhetsgruppens namn måste du ange både produktnamnet och enhetsgruppens <product-name/device-group-name> namn i formatet. |
Valfria parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| -t, --tenant | GUID eller namn | Anger den klientorganisation som åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientnamn. |
Globala parametrar
Följande globala parametrar är tillgängliga för Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --felsöka | Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan --debug när du skickar en felrapport. |
| -h, --help | Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon. |
| --only-show-errors | Visar endast fel och undertrycker varningar. |
| -o, --output | Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut table. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon. |
| --fråga | Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata . |
| --mångordig | Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra --debug. |
Kommentar
Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.
Exempel
Exempel för att ange enhetsgrupp efter ID:
azsphere device-group show --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Exempel för att ange enhetsgrupp efter namn:
azsphere device-group show --device-group DW100/Marketing
Du bör se utdata som ser ut så här:
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
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
Uppdaterar en befintlig enhetsgrupp som identifieras med ID eller efter produktnamn och namnpar för enhetsgrupp.
Obligatoriska parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| -g, --device-group | String | Anger den enhetsgrupp som information ska uppdateras för. Du kan ange enhetsgrupps-ID eller enhetsgruppsnamn. Om du vill använda enhetsgruppens namn måste du ange både produktnamnet och enhetsgruppens <product-name/device-group-name> namn i formatet. |
Valfria parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| -c, --allow-crash-dumps-collection | String | Ange medgivande för insamling av kraschdumpar av Microsoft för enhetsgruppen. Standard är Off. Tillåtna värden: Off och On. Använd parametern --regional-data-boundary för att ange var kraschdumpfilerna ska lagras. Mer information finns i Konfigurera kraschdumpar. |
| -a, --application-update | ApplicationUpdatePolicyType | Anger programuppdateringsprincipen för enhetsgruppen. Tillåtna värden: No3rdPartyAppUpdates, UpdateAlloch NoUpdates. Standard är UpdateAll. Principen NoUpdates är för närvarande endast reserverad för internt bruk. |
| -d, --new-description | String | Anger valfri text för att beskriva enhetsgruppen. Den maximala längden är 100 tecken. |
| -n, --new-name | String | Anger ett nytt namn för enhetsgruppen. Namnet kan bara innehålla alfanumeriska tecken. Om namnet innehåller blanksteg omger du det inom citattecken. Enhetsgruppens namn får inte överstiga 50 tecken, är skiftlägesokänsligt och måste vara unikt i produkten. |
| -f, --os-feed | String | Anger operativsystemets feed för enhetsgruppen. Möjliga värden är Retail och RetailEval. |
| -t, --tenant | GUID eller namn | Anger den klientorganisation som åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientnamn. |
| -r, --regional-data-boundary | String | Regional datagräns för den här avbildningen. Tillåtna värden: EU, None. Standardvärdet är None. Om inget värde anges används standardvärdet. Mer information finns i Konfigurera kraschdumpar – Pivacy-överväganden |
Globala parametrar
Följande globala parametrar är tillgängliga för Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --felsöka | Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan --debug när du skickar en felrapport. |
| -h, --help | Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon. |
| --only-show-errors | Visar endast fel och undertrycker varningar. |
| -o, --output | Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut table. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon. |
| --fråga | Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata . |
| --mångordig | Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra --debug. |
Kommentar
Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.
Exempel
Exempel för att ange enhetsgrupp efter ID:
azsphere device-group update --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd --new-description "Marketing device group"
Exempel för att ange enhetsgrupp efter namn:
azsphere device-group update --device-group DW100/Marketing --new-description "Marketing device group"
Du bör se utdata som ser ut så här:
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------
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
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------