enhetsgrupp
Skapar och hanterar enhetsgrupper.
Enhetsgrupper hanteras antingen med identifierare (ID) eller efter produktnamn och namnpar för enhetsgrupper.
| Drift | Beskrivning |
|---|---|
| Skapa | Skapar en ny enhetsgrupp. |
| Lista | Visa en lista över alla enhetsgrupper i Azure Sphere-klientorganisationen. |
| Ta bort | Tar bort en befintlig enhetsgrupp. |
| Distribution | Hanterar distributioner inom en enhetsgrupp. |
| Enhet | Visar enheter i en enhetsgrupp. |
| Visa | Visar information om en enhetsgrupp. |
| Uppdatering | Ändrar en befintlig enhetsgrupp. |
Skapa
Skapar en enhetsgrupp med angivet namn för den angivna produkten. Enhetsgruppen organiserar enheter som har samma produkt och tar emot samma program från molnet.
Obligatoriska parametrar
| Parametern | Typ | Beskrivning |
|---|---|---|
| -p, --product | GUID eller namn | Anger produkten som den här enhetsgruppen ska läggas till i. Du kan ange antingen ID eller namn på Azure Sphere-produkten. |
| -n, --name | Sträng | Anger ett namn för enhetsgruppen. Namnet kan bara innehålla alfanumeriska tecken. Om namnet innehåller blanksteg omger du det med citattecken. Enhetsgruppens namn får inte överstiga 50 tecken, är skiftlägeskänsligt och måste vara unikt i produkten. |
Valfria parametrar
| Parametern | Typ | Beskrivning |
|---|---|---|
| -a, --application-update | Enum | Anger vilken programuppdateringsprincip som ska gälla för den här enhetsgruppen. Godkända värden: No3rdPartyAppUpdates, UpdateAlloch NoUpdates. Standardvärdet är UpdateAll. Principen NoUpdates är för närvarande endast avsedd för intern användning. |
| -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 vilken klientorganisation som den här åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientorganisationsnamn. |
| -d, --description | Sträng | Anger den valfria texten som beskriver enhetsgruppen. Maxlängden är 100 tecken. Om beskrivningen innehåller blanksteg omger du den med citattecken. |
| -r, --regional-data-boundary | Sträng | 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 – överväganden för Pivacy |
Globala parametrar
Följande globala parametrar är tillgängliga för Azure Sphere CLI:
| Parametern | Beskrivning |
|---|---|
| --Debug | Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med --debug flaggan på 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 ignorerar varningar. |
| -o, --output | Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata tablefrån CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon. |
| --Fråga | Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata . |
| --Utförlig | Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används --debug för fullständiga felsökningsloggar. |
Observera
Om du använder azure sphere klassiska CLI, se 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 Azure Sphere-klientorganisationen.
Valfria parametrar
| Parametern | Typ | Beskrivning |
|---|---|---|
| -t, --tenant | GUID eller namn | Anger vilken klientorganisation som den här åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientorganisationsnamn. |
Globala parametrar
Följande globala parametrar är tillgängliga för Azure Sphere CLI:
| Parametern | Beskrivning |
|---|---|
| --Debug | Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med --debug flaggan på 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 ignorerar varningar. |
| -o, --output | Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata tablefrån CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon. |
| --Fråga | Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata . |
| --Utförlig | Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används --debug för fullständiga felsökningsloggar. |
Observera
Om du använder azure sphere klassiska CLI, se 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
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- --------------------------------------------------
Ta bort
Tar bort den angivna enhetsgruppen i Azure Sphere-klienten.
En enhetsgrupp kan bara tas bort när:
- Användaren har administratörsbehörighet till klientorganisationen.
- Enhetsgruppen är tom och har inga enheter. Kommandot azsfärenhetsgruppenhet listar alla enheter i en enhetsgrupp. Kör azsfärenhetsuppdatering – enhetsgrupp för att flytta enheten till en annan enhetsgrupp.
Obligatoriska parametrar
| Parametern | Typ | Beskrivning |
|---|---|---|
| -g, --device-group | Sträng | Anger vilken enhetsgrupp som ska tas bort. Du kan ange enhetsgrupp-ID eller enhetsgruppnamn. 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
| Parametern | Typ | Beskrivning |
|---|---|---|
| -t, --tenant | GUID eller namn | Anger vilken klientorganisation som den här åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientorganisationsnamn. |
Globala parametrar
Följande globala parametrar är tillgängliga för Azure Sphere CLI:
| Parametern | Beskrivning |
|---|---|
| --Debug | Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med --debug flaggan på 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 ignorerar varningar. |
| -o, --output | Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata tablefrån CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon. |
| --Fråga | Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata . |
| --Utförlig | Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används --debug för fullständiga felsökningsloggar. |
Observera
Om du använder azure sphere klassiska CLI, se 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.
| Drift | Beskrivning |
|---|---|
| Skapa | Skapar en ny distribution för den angivna enhetsgruppen. |
| Lista | Visar distributionerna för en enhetsgrupp. |
distribution skapa
Skapar en ny distribution för en enhetsgrupp med de medföljande avbildningarna.
Du kan identifiera enhetsgruppen antingen genom identifierare (ID) eller efter produktnamn och namnpar för enhetsgrupper.
Obligatoriska parametrar
| Parametern | Typ | Beskrivning |
|---|---|---|
| -g, --device-group | Sträng | Anger i vilken enhetsgrupp distributionen ska skapas. Du kan ange enhetsgrupp-ID eller enhetsgruppnamn. 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, --bilder | Sträng | Anger avbildnings-ID:t för en eller flera avbildningar som ska tas med i distributionen. Du kan lägga till flera bilder genom att lägga till ytterligare parametrar, eller så kan flera bild-ID:er kombineras i en enskild parameter i en blankstegsavgränsad lista. Kör kommandot lägg till azsfärbild för att hämta avbildnings-ID:et. |
Valfria parametrar
| Parametern | Typ | Beskrivning |
|---|---|---|
| -t, --tenant | GUID eller namn | Anger vilken klientorganisation som den här åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientorganisationsnamn. |
Globala parametrar
Följande globala parametrar är tillgängliga för Azure Sphere CLI:
| Parametern | Beskrivning |
|---|---|
| --Debug | Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med --debug flaggan på 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 ignorerar varningar. |
| -o, --output | Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata tablefrån CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon. |
| --Fråga | Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata . |
| --Utförlig | Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används --debug för fullständiga felsökningsloggar. |
Observera
Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.
Exempel
Parametern --device-group identifierar enhetsgruppen. Enhetsgrupp-ID tillhandahåller en GUID, som unikt identifierar enhetsgruppen för alla produkter. Du kan också använda namnparet för produktnamn och enhetsgrupp i <formatet produktnamn>/<enhet-grupp-namn> . 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 på hur du anger 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 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
| Parametern | Typ | Beskrivning |
|---|---|---|
| -g, --device-group | Sträng | Anger den enhetsgrupp som distributionshistoriklistan ska visas för. Du kan ange enhetsgrupp-ID eller enhetsgruppnamn. 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
| Parametern | Typ | Beskrivning |
|---|---|---|
| -t, --tenant | GUID eller namn | Anger vilken klientorganisation som den här åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientorganisationsnamn. |
Globala parametrar
Följande globala parametrar är tillgängliga för Azure Sphere CLI:
| Parametern | Beskrivning |
|---|---|
| --Debug | Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med --debug flaggan på 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 ignorerar varningar. |
| -o, --output | Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata tablefrån CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon. |
| --Fråga | Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata . |
| --Utförlig | Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används --debug för fullständiga felsökningsloggar. |
Observera
Om du använder azure sphere klassiska CLI, se 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 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.
| Drift | Beskrivning |
|---|---|
| Lista | Visar enheterna i en enhetsgrupp. |
| visa antal | Visar antalet enheter i en enhetsgrupp. |
enhetslista
Visar enheterna i en enhetsgrupp.
Obligatoriska parametrar
| Parametern | Typ | Beskrivning |
|---|---|---|
| -g, --device-group | Sträng | Anger vilken enhetsgrupp som enhetslistan ska visas för. Du kan ange enhetsgrupp-ID eller enhetsgruppnamn. 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
| Parametern | Typ | Beskrivning |
|---|---|---|
| -t, --tenant | GUID eller namn | Anger vilken klientorganisation som den här åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientorganisationsnamn. |
Globala parametrar
Följande globala parametrar är tillgängliga för Azure Sphere CLI:
| Parametern | Beskrivning |
|---|---|
| --Debug | Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med --debug flaggan på 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 ignorerar varningar. |
| -o, --output | Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata tablefrån CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon. |
| --Fråga | Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata . |
| --Utförlig | Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används --debug för fullständiga felsökningsloggar. |
Observera
Om du använder azure sphere klassiska CLI, se 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 så här:
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
DeviceId TenantId ProductId DeviceGroupId
===================================================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 143adbc9-1bf0-4be2-84a2-084a331d81cb 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
visa-antal enheter
Visar antalet enheter i en enhetsgrupp.
Obligatoriska parametrar
| Parametern | Typ | Beskrivning |
|---|---|---|
| -g, --device-group | Sträng | Anger den enhetsgrupp som enhetens antal ska visas för. Du kan ange enhetsgrupp-ID eller enhetsgruppnamn. 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
| Parametern | Typ | Beskrivning |
|---|---|---|
| -t, --tenant | GUID eller namn | Anger vilken klientorganisation som den här åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientorganisationsnamn. |
Globala parametrar
Följande globala parametrar är tillgängliga för Azure Sphere CLI:
| Parametern | Beskrivning |
|---|---|
| --Debug | Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med --debug flaggan på 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 ignorerar varningar. |
| -o, --output | Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata tablefrån CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon. |
| --Fråga | Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata . |
| --Utförlig | Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används --debug för fullständiga felsökningsloggar. |
Observera
Om du använder azure sphere klassiska CLI, se 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 så här:
------
Result
======
1
------
Visa
Returnerar information om en enhetsgrupp.
Obligatoriska parametrar
| Parametern | Typ | Beskrivning |
|---|---|---|
| -g, --device-group | Sträng | Anger vilken enhetsgrupp som information ska visas för. Du kan ange enhetsgrupp-ID eller enhetsgruppnamn. 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
| Parametern | Typ | Beskrivning |
|---|---|---|
| -t, --tenant | GUID eller namn | Anger vilken klientorganisation som den här åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientorganisationsnamn. |
Globala parametrar
Följande globala parametrar är tillgängliga för Azure Sphere CLI:
| Parametern | Beskrivning |
|---|---|
| --Debug | Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med --debug flaggan på 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 ignorerar varningar. |
| -o, --output | Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata tablefrån CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon. |
| --Fråga | Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata . |
| --Utförlig | Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används --debug för fullständiga felsökningsloggar. |
Observera
Om du använder azure sphere klassiska CLI, se 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 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
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
Uppdatering
Uppdateringar en befintlig enhetsgrupp, identifierad med ID eller efter produktnamn och namnpar för enhetsgrupp.
Obligatoriska parametrar
| Parametern | Typ | Beskrivning |
|---|---|---|
| -g, --device-group | Sträng | Anger den enhetsgrupp som information ska uppdateras för. Du kan ange enhetsgrupp-ID eller enhetsgruppnamn. 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
| Parametern | Typ | Beskrivning |
|---|---|---|
| -c, --allow-crash-dumps-collection | Sträng | Ange medgivande för microsofts insamling av kraschdumpar för enhetsgruppen. Standardvärdet ä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. Standardvärdet är UpdateAll. Principen NoUpdates är för närvarande endast avsedd för intern användning. |
| -d, --new-description | Sträng | Anger valfri text som beskriver enhetsgruppen. Maxlängden är 100 tecken. |
| -n, --new-name | Sträng | Anger ett nytt namn för enhetsgruppen. Namnet kan bara innehålla alfanumeriska tecken. Om namnet innehåller blanksteg omger du det med citattecken. Enhetsgruppens namn får inte överstiga 50 tecken, är skiftlägeskänsligt och måste vara unikt i produkten. |
| -f, --os-feed | Sträng | Anger operativsystemets feed för enhetsgruppen. Möjliga värden är Retail och RetailEval. |
| -t, --tenant | GUID eller namn | Anger vilken klientorganisation som den här åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientorganisationsnamn. |
| -r, --regional-data-boundary | Sträng | 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 – överväganden för Pivacy |
Globala parametrar
Följande globala parametrar är tillgängliga för Azure Sphere CLI:
| Parametern | Beskrivning |
|---|---|
| --Debug | Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med --debug flaggan på 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 ignorerar varningar. |
| -o, --output | Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata tablefrån CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon. |
| --Fråga | Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata . |
| --Utförlig | Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används --debug för fullständiga felsökningsloggar. |
Observera
Om du använder azure sphere klassiska CLI, se 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 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
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------