skupina zařízení
Důležité
Toto je dokumentace k Azure Sphere (starší verze). Azure Sphere (starší verze) se vyřazuje 27. září 2027 a uživatelé musí do této doby migrovat do Azure Sphere (integrované). K zobrazení dokumentace k Azure Sphere (integrované) použijte selektor verzí umístěný nad obsahem.
Vytvoří a spravuje skupiny zařízení.
Skupiny zařízení jsou adresovány buď identifikátorem (ID), nebo názvem produktu a párem názvů skupin zařízení.
| Operation | Popis |
|---|---|
| vytvoření | Vytvoří novou skupinu zařízení. |
| list | Vypište všechny skupiny zařízení v tenantovi Azure Sphere. |
| odstranění | Odstraní existující skupinu zařízení. |
| nasazení | Spravuje nasazení v rámci skupiny zařízení. |
| zařízení | Zobrazí seznam zařízení ve skupině zařízení. |
| ukázat | Zobrazí informace o skupině zařízení. |
| update | Upraví existující skupinu zařízení. |
vytvoření
Vytvoří skupinu zařízení se zadaným názvem zadaného produktu. Skupina zařízení uspořádá zařízení se stejným produktem a přijímá stejné aplikace z cloudu.
Povinné parametry
| Parametr | Typ | Popis |
|---|---|---|
| -p, --product | IDENTIFIKÁTOR GUID nebo název | Určuje produkt, do který se má tato skupina zařízení přidat. Můžete zadat ID nebo název produktu Azure Sphere. |
| -n, --name | String | Určuje název skupiny zařízení. Název může obsahovat pouze alfanumerické znaky. Pokud název obsahuje mezery, uzavřete ho do uvozovek. Název skupiny zařízení nesmí překročit 50 znaků, nerozlišuje velká a malá písmena, musí být v rámci produktu jedinečný. |
Volitelné parametry
| Parametr | Typ | Popis |
|---|---|---|
| -a, --application-update | Výčet | Určuje zásadu aktualizace aplikace, která se má použít pro tuto skupinu zařízení. Přijaté hodnoty: No3rdPartyAppUpdates, UpdateAlla NoUpdates. Výchozí hodnota je UpdateAll. Tato NoUpdates zásada je aktuálně vyhrazená jenom pro interní použití. |
| -f, --os-feed | Výčet | Určuje typ informačního kanálu operačního systému, který se má použít pro aktualizace operačního systému. Přijaté hodnoty: Retail, RetailEval. |
| -t, --tenant | IDENTIFIKÁTOR GUID nebo název | Určuje tenanta, ve které se má tato operace provést. Přepíše výchozího vybraného tenanta. Můžete zadat BUĎ ID tenanta, nebo název tenanta. |
| -d, --description | String | Určuje volitelný text, který popisuje skupinu zařízení. Maximální délka je 100 znaků. Pokud popis obsahuje mezery, uzavřete ho do uvozovek. |
| -r, --regional-data-boundary | String | Hranice místních dat pro tento obrázek. Povolené hodnoty: EU, None. Výchozí hodnota je None. Pokud není zadaná žádná hodnota, použije se výchozí hodnota. Další informace najdete v tématu Konfigurace výpisů stavu systému – Aspekty pivacy |
Globální parametry
Pro Rozhraní příkazového řádku Azure Sphere jsou k dispozici následující globální parametry:
| Parametr | Popis |
|---|---|
| --ladicí | Zvyšuje úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. Pokud narazíte na chybu, při odesílání zprávy o chybě zadejte výstup vygenerovaný pomocí příznaku --debug. |
| -h, --help | Vytiskne referenční informace rozhraní příkazového řádku o příkazech a jejich argumentech a seznamech dostupných podskupin a příkazů. |
| --only-show-errors | Zobrazuje pouze chyby a potlačuje upozornění. |
| -o, --output | Změní formát výstupu. Dostupné výstupní formáty jsou json, jsonc (barevné JSON), tsv (hodnoty oddělené tabulátory), tabulka (tabulky ASCII čitelné pro člověka) a yaml. Ve výchozím nastavení je výstup rozhraní příkazového řádku ve formátu table. Další informace o dostupných formátech výstupu najdete v tématu Formát výstupu pro příkazy Rozhraní příkazového řádku Azure Sphere. |
| --dotaz | Použije dotazovací jazyk JMESPath k filtrování výstupu vráceného ze služeb zabezpečení Azure Sphere. Další informace a příklady najdete v kurzu JMESPath a dotazování výstupu příkazu Azure CLI. |
| --užvaněný | Vytiskne informace o prostředcích vytvořených v Azure Sphere během operace a dalších užitečných informací. Pokud chcete zobrazit úplné protokoly ladění, použijte parametr --debug. |
Poznámka:
Pokud používáte Azure Sphere Classic CLI, další informace o dostupných možnostech najdete v tématu Globální parametry .
Příklad
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
------------------------------------ ------------------------------------ ---------- ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
list
Vypište všechny skupiny zařízení v tenantovi Azure Sphere.
Volitelné parametry
| Parametr | Typ | Popis |
|---|---|---|
| -t, --tenant | IDENTIFIKÁTOR GUID nebo název | Určuje tenanta, ve které se má tato operace provést. Přepíše výchozího vybraného tenanta. Můžete zadat BUĎ ID tenanta, nebo název tenanta. |
Globální parametry
Pro Rozhraní příkazového řádku Azure Sphere jsou k dispozici následující globální parametry:
| Parametr | Popis |
|---|---|
| --ladicí | Zvyšuje úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. Pokud narazíte na chybu, při odesílání zprávy o chybě zadejte výstup vygenerovaný pomocí příznaku --debug. |
| -h, --help | Vytiskne referenční informace rozhraní příkazového řádku o příkazech a jejich argumentech a seznamech dostupných podskupin a příkazů. |
| --only-show-errors | Zobrazuje pouze chyby a potlačuje upozornění. |
| -o, --output | Změní formát výstupu. Dostupné výstupní formáty jsou json, jsonc (barevné JSON), tsv (hodnoty oddělené tabulátory), tabulka (tabulky ASCII čitelné pro člověka) a yaml. Ve výchozím nastavení je výstup rozhraní příkazového řádku ve formátu table. Další informace o dostupných formátech výstupu najdete v tématu Formát výstupu pro příkazy Rozhraní příkazového řádku Azure Sphere. |
| --dotaz | Použije dotazovací jazyk JMESPath k filtrování výstupu vráceného ze služeb zabezpečení Azure Sphere. Další informace a příklady najdete v kurzu JMESPath a dotazování výstupu příkazu Azure CLI. |
| --užvaněný | Vytiskne informace o prostředcích vytvořených v Azure Sphere během operace a dalších užitečných informací. Pokud chcete zobrazit úplné protokoly ladění, použijte parametr --debug. |
Poznámka:
Pokud používáte Azure Sphere Classic CLI, další informace o dostupných možnostech najdete v tématu Globální parametry .
Příklad
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
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- --------------------------------------------------
Odstranit…
Odstraní zadanou skupinu zařízení v tenantovi Azure Sphere.
Skupinu zařízení je možné odstranit pouze v případech, kdy:
- Uživatel má oprávnění správce tenanta.
- Skupina zařízení je prázdná a nemá v ní žádná zařízení. Příkaz azsphere device-group device list list all the devices in a device group. Spuštěním příkazu azsphere device update --device-group přesuňte zařízení do jiné skupiny zařízení.
Povinné parametry
| Parametr | Typ | Popis |
|---|---|---|
| -g, --device-group | String | Určuje skupinu zařízení, která se má odstranit. Můžete zadat ID skupiny zařízení nebo název skupiny zařízení. Pokud chcete použít název skupiny zařízení, musíte zadat název produktu i název skupiny zařízení ve <product-name/device-group-name> formátu. |
Volitelné parametry
| Parametr | Typ | Popis |
|---|---|---|
| -t, --tenant | IDENTIFIKÁTOR GUID nebo název | Určuje tenanta, ve které se má tato operace provést. Přepíše výchozího vybraného tenanta. Můžete zadat BUĎ ID tenanta, nebo název tenanta. |
Globální parametry
Pro Rozhraní příkazového řádku Azure Sphere jsou k dispozici následující globální parametry:
| Parametr | Popis |
|---|---|
| --ladicí | Zvyšuje úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. Pokud narazíte na chybu, při odesílání zprávy o chybě zadejte výstup vygenerovaný pomocí příznaku --debug. |
| -h, --help | Vytiskne referenční informace rozhraní příkazového řádku o příkazech a jejich argumentech a seznamech dostupných podskupin a příkazů. |
| --only-show-errors | Zobrazuje pouze chyby a potlačuje upozornění. |
| -o, --output | Změní formát výstupu. Dostupné výstupní formáty jsou json, jsonc (barevné JSON), tsv (hodnoty oddělené tabulátory), tabulka (tabulky ASCII čitelné pro člověka) a yaml. Ve výchozím nastavení je výstup rozhraní příkazového řádku ve formátu table. Další informace o dostupných formátech výstupu najdete v tématu Formát výstupu pro příkazy Rozhraní příkazového řádku Azure Sphere. |
| --dotaz | Použije dotazovací jazyk JMESPath k filtrování výstupu vráceného ze služeb zabezpečení Azure Sphere. Další informace a příklady najdete v kurzu JMESPath a dotazování výstupu příkazu Azure CLI. |
| --užvaněný | Vytiskne informace o prostředcích vytvořených v Azure Sphere během operace a dalších užitečných informací. Pokud chcete zobrazit úplné protokoly ladění, použijte parametr --debug. |
Poznámka:
Pokud používáte Azure Sphere Classic CLI, další informace o dostupných možnostech najdete v tématu Globální parametry .
Příklad
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
nasazení
Spravuje nasazení pro skupinu zařízení.
| Operation | Popis |
|---|---|
| vytvoření | Vytvoří nové nasazení pro zadanou skupinu zařízení. |
| list | Zobrazí nasazení pro skupinu zařízení. |
vytvoření nasazení
Vytvoří nové nasazení pro skupinu zařízení se zadanými imagemi.
Skupinu zařízení můžete identifikovat podle identifikátoru (ID) nebo podle názvu produktu a páru názvů skupin zařízení.
Povinné parametry
| Parametr | Typ | Popis |
|---|---|---|
| -g, --device-group | String | Určuje skupinu zařízení, ve které se má nasazení vytvořit. Můžete zadat ID skupiny zařízení nebo název skupiny zařízení. Pokud chcete použít název skupiny zařízení, musíte zadat název produktu i název skupiny zařízení ve <product-name/device-group-name> formátu. |
| -i, --images | String | Určuje ID imagí pro jednu nebo více imagí, které se mají zahrnout do nasazení. Přidáním dalších parametrů můžete přidat více obrázků nebo v jednom parametru v seznamu odděleném mezerami můžete zkombinovat několik ID obrázků. Spuštěním příkazu azsphere image add získejte ID image. |
Volitelné parametry
| Parametr | Typ | Popis |
|---|---|---|
| -t, --tenant | IDENTIFIKÁTOR GUID nebo název | Určuje tenanta, ve které se má tato operace provést. Přepíše výchozího vybraného tenanta. Můžete zadat BUĎ ID tenanta, nebo název tenanta. |
Globální parametry
Pro Rozhraní příkazového řádku Azure Sphere jsou k dispozici následující globální parametry:
| Parametr | Popis |
|---|---|
| --ladicí | Zvyšuje úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. Pokud narazíte na chybu, při odesílání zprávy o chybě zadejte výstup vygenerovaný pomocí příznaku --debug. |
| -h, --help | Vytiskne referenční informace rozhraní příkazového řádku o příkazech a jejich argumentech a seznamech dostupných podskupin a příkazů. |
| --only-show-errors | Zobrazuje pouze chyby a potlačuje upozornění. |
| -o, --output | Změní formát výstupu. Dostupné výstupní formáty jsou json, jsonc (barevné JSON), tsv (hodnoty oddělené tabulátory), tabulka (tabulky ASCII čitelné pro člověka) a yaml. Ve výchozím nastavení je výstup rozhraní příkazového řádku ve formátu table. Další informace o dostupných formátech výstupu najdete v tématu Formát výstupu pro příkazy Rozhraní příkazového řádku Azure Sphere. |
| --dotaz | Použije dotazovací jazyk JMESPath k filtrování výstupu vráceného ze služeb zabezpečení Azure Sphere. Další informace a příklady najdete v kurzu JMESPath a dotazování výstupu příkazu Azure CLI. |
| --užvaněný | Vytiskne informace o prostředcích vytvořených v Azure Sphere během operace a dalších užitečných informací. Pokud chcete zobrazit úplné protokoly ladění, použijte parametr --debug. |
Poznámka:
Pokud používáte Azure Sphere Classic CLI, další informace o dostupných možnostech najdete v tématu Globální parametry .
Příklad
Parametr --device-group identifikuje skupinu zařízení. ID skupiny zařízení poskytuje identifikátor GUID, který jednoznačně identifikuje skupinu zařízení ve všech produktech. Alternativně můžete použít dvojici název produktu a název skupiny zařízení ve <formátu product-name>/<device-group-name> . Tato dvojice názvů jednoznačně identifikuje skupinu zařízení pro konkrétní produkt.
Příklad určení skupiny zařízení podle ID:
azsphere device-group deployment create --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd --images 5572509b-43a4-45b0-88c5-365cbf9732c1
Příklad určení skupiny zařízení podle názvu:
azsphere device-group deployment create --device-group DW100/Development --images 5572509b-43a4-45b0-88c5-365cbf9732c1
Příklad zadání více ID obrázků zadáním seznamu hodnot oddělených mezerami:
azsphere device-group deployment create --device-group DW100/Development --images 5572509b-43a4-45b0-88c5-365cbf9732c1 3bbd2d2a-2870-4dde-9db8-ae50548ea7b4
Měl by se zobrazit výstup podobný tomuto:
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
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
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
seznam nasazení
Zobrazí historii nasazení pro skupinu zařízení. Vrátí ID nasazení, časové razítko a seznam zahrnutých imagí. Seznam je seřazený podle nejnovějších nasazení.
Povinné parametry
| Parametr | Typ | Popis |
|---|---|---|
| -g, --device-group | String | Určuje skupinu zařízení, pro kterou se má zobrazit seznam historie nasazení. Můžete zadat ID skupiny zařízení nebo název skupiny zařízení. Pokud chcete použít název skupiny zařízení, musíte zadat název produktu i název skupiny zařízení ve <product-name/device-group-name> formátu. |
Volitelné parametry
| Parametr | Typ | Popis |
|---|---|---|
| -t, --tenant | IDENTIFIKÁTOR GUID nebo název | Určuje tenanta, ve které se má tato operace provést. Přepíše výchozího vybraného tenanta. Můžete zadat BUĎ ID tenanta, nebo název tenanta. |
Globální parametry
Pro Rozhraní příkazového řádku Azure Sphere jsou k dispozici následující globální parametry:
| Parametr | Popis |
|---|---|
| --ladicí | Zvyšuje úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. Pokud narazíte na chybu, při odesílání zprávy o chybě zadejte výstup vygenerovaný pomocí příznaku --debug. |
| -h, --help | Vytiskne referenční informace rozhraní příkazového řádku o příkazech a jejich argumentech a seznamech dostupných podskupin a příkazů. |
| --only-show-errors | Zobrazuje pouze chyby a potlačuje upozornění. |
| -o, --output | Změní formát výstupu. Dostupné výstupní formáty jsou json, jsonc (barevné JSON), tsv (hodnoty oddělené tabulátory), tabulka (tabulky ASCII čitelné pro člověka) a yaml. Ve výchozím nastavení je výstup rozhraní příkazového řádku ve formátu table. Další informace o dostupných formátech výstupu najdete v tématu Formát výstupu pro příkazy Rozhraní příkazového řádku Azure Sphere. |
| --dotaz | Použije dotazovací jazyk JMESPath k filtrování výstupu vráceného ze služeb zabezpečení Azure Sphere. Další informace a příklady najdete v kurzu JMESPath a dotazování výstupu příkazu Azure CLI. |
| --užvaněný | Vytiskne informace o prostředcích vytvořených v Azure Sphere během operace a dalších užitečných informací. Pokud chcete zobrazit úplné protokoly ladění, použijte parametr --debug. |
Poznámka:
Pokud používáte Azure Sphere Classic CLI, další informace o dostupných možnostech najdete v tématu Globální parametry .
Příklad
Příklad určení skupiny zařízení podle ID:
azsphere device-group deployment list --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Příklad určení skupiny zařízení podle názvu:
azsphere device-group deployment list --device-group DW100/Development
Měl by se zobrazit výstup podobný tomuto:
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
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
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
device
Spravuje zařízení pro skupinu zařízení.
| Operation | Popis |
|---|---|
| list | Zobrazí zařízení ve skupině zařízení. |
| show-count | Zobrazuje počet zařízení ve skupině zařízení. |
seznam zařízení
Zobrazí zařízení ve skupině zařízení.
Povinné parametry
| Parametr | Typ | Popis |
|---|---|---|
| -g, --device-group | String | Určuje skupinu zařízení, pro kterou se má zobrazit seznam zařízení. Můžete zadat ID skupiny zařízení nebo název skupiny zařízení. Pokud chcete použít název skupiny zařízení, musíte zadat název produktu i název skupiny zařízení ve <product-name/device-group-name> formátu. |
Volitelné parametry
| Parametr | Typ | Popis |
|---|---|---|
| -t, --tenant | IDENTIFIKÁTOR GUID nebo název | Určuje tenanta, ve které se má tato operace provést. Přepíše výchozího vybraného tenanta. Můžete zadat BUĎ ID tenanta, nebo název tenanta. |
Globální parametry
Pro Rozhraní příkazového řádku Azure Sphere jsou k dispozici následující globální parametry:
| Parametr | Popis |
|---|---|
| --ladicí | Zvyšuje úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. Pokud narazíte na chybu, při odesílání zprávy o chybě zadejte výstup vygenerovaný pomocí příznaku --debug. |
| -h, --help | Vytiskne referenční informace rozhraní příkazového řádku o příkazech a jejich argumentech a seznamech dostupných podskupin a příkazů. |
| --only-show-errors | Zobrazuje pouze chyby a potlačuje upozornění. |
| -o, --output | Změní formát výstupu. Dostupné výstupní formáty jsou json, jsonc (barevné JSON), tsv (hodnoty oddělené tabulátory), tabulka (tabulky ASCII čitelné pro člověka) a yaml. Ve výchozím nastavení je výstup rozhraní příkazového řádku ve formátu table. Další informace o dostupných formátech výstupu najdete v tématu Formát výstupu pro příkazy Rozhraní příkazového řádku Azure Sphere. |
| --dotaz | Použije dotazovací jazyk JMESPath k filtrování výstupu vráceného ze služeb zabezpečení Azure Sphere. Další informace a příklady najdete v kurzu JMESPath a dotazování výstupu příkazu Azure CLI. |
| --užvaněný | Vytiskne informace o prostředcích vytvořených v Azure Sphere během operace a dalších užitečných informací. Pokud chcete zobrazit úplné protokoly ladění, použijte parametr --debug. |
Poznámka:
Pokud používáte Azure Sphere Classic CLI, další informace o dostupných možnostech najdete v tématu Globální parametry .
Příklad
Příklad určení skupiny zařízení podle ID:
azsphere device-group device list --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Příklad určení skupiny zařízení podle názvu:
azsphere device-group device list --device-group DW100/Marketing
Měl by se zobrazit výstup podobný tomuto:
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
DeviceId TenantId ProductId DeviceGroupId
===================================================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 143adbc9-1bf0-4be2-84a2-084a331d81cb 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
počet zobrazení zařízení
Zobrazí počet zařízení ve skupině zařízení.
Povinné parametry
| Parametr | Typ | Popis |
|---|---|---|
| -g, --device-group | String | Určuje skupinu zařízení, pro kterou se má zobrazit počet zařízení. Můžete zadat ID skupiny zařízení nebo název skupiny zařízení. Pokud chcete použít název skupiny zařízení, musíte zadat název produktu i název skupiny zařízení ve <product-name/device-group-name> formátu. |
Volitelné parametry
| Parametr | Typ | Popis |
|---|---|---|
| -t, --tenant | IDENTIFIKÁTOR GUID nebo název | Určuje tenanta, ve které se má tato operace provést. Přepíše výchozího vybraného tenanta. Můžete zadat BUĎ ID tenanta, nebo název tenanta. |
Globální parametry
Pro Rozhraní příkazového řádku Azure Sphere jsou k dispozici následující globální parametry:
| Parametr | Popis |
|---|---|
| --ladicí | Zvyšuje úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. Pokud narazíte na chybu, při odesílání zprávy o chybě zadejte výstup vygenerovaný pomocí příznaku --debug. |
| -h, --help | Vytiskne referenční informace rozhraní příkazového řádku o příkazech a jejich argumentech a seznamech dostupných podskupin a příkazů. |
| --only-show-errors | Zobrazuje pouze chyby a potlačuje upozornění. |
| -o, --output | Změní formát výstupu. Dostupné výstupní formáty jsou json, jsonc (barevné JSON), tsv (hodnoty oddělené tabulátory), tabulka (tabulky ASCII čitelné pro člověka) a yaml. Ve výchozím nastavení je výstup rozhraní příkazového řádku ve formátu table. Další informace o dostupných formátech výstupu najdete v tématu Formát výstupu pro příkazy Rozhraní příkazového řádku Azure Sphere. |
| --dotaz | Použije dotazovací jazyk JMESPath k filtrování výstupu vráceného ze služeb zabezpečení Azure Sphere. Další informace a příklady najdete v kurzu JMESPath a dotazování výstupu příkazu Azure CLI. |
| --užvaněný | Vytiskne informace o prostředcích vytvořených v Azure Sphere během operace a dalších užitečných informací. Pokud chcete zobrazit úplné protokoly ladění, použijte parametr --debug. |
Poznámka:
Pokud používáte Azure Sphere Classic CLI, další informace o dostupných možnostech najdete v tématu Globální parametry .
Příklad
Příklad určení skupiny zařízení podle ID:
azsphere device-group device show-count --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Příklad určení skupiny zařízení podle názvu:
azsphere device-group device show-count --device-group DW100/Marketing
Měl by se zobrazit výstup podobný tomuto:
------
Result
======
1
------
zobrazit
Vrátí informace o skupině zařízení.
Povinné parametry
| Parametr | Typ | Popis |
|---|---|---|
| -g, --device-group | String | Určuje skupinu zařízení, pro kterou se mají zobrazit podrobnosti. Můžete zadat ID skupiny zařízení nebo název skupiny zařízení. Pokud chcete použít název skupiny zařízení, musíte zadat název produktu i název skupiny zařízení ve <product-name/device-group-name> formátu. |
Volitelné parametry
| Parametr | Typ | Popis |
|---|---|---|
| -t, --tenant | IDENTIFIKÁTOR GUID nebo název | Určuje tenanta, ve které se má tato operace provést. Přepíše výchozího vybraného tenanta. Můžete zadat BUĎ ID tenanta, nebo název tenanta. |
Globální parametry
Pro Rozhraní příkazového řádku Azure Sphere jsou k dispozici následující globální parametry:
| Parametr | Popis |
|---|---|
| --ladicí | Zvyšuje úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. Pokud narazíte na chybu, při odesílání zprávy o chybě zadejte výstup vygenerovaný pomocí příznaku --debug. |
| -h, --help | Vytiskne referenční informace rozhraní příkazového řádku o příkazech a jejich argumentech a seznamech dostupných podskupin a příkazů. |
| --only-show-errors | Zobrazuje pouze chyby a potlačuje upozornění. |
| -o, --output | Změní formát výstupu. Dostupné výstupní formáty jsou json, jsonc (barevné JSON), tsv (hodnoty oddělené tabulátory), tabulka (tabulky ASCII čitelné pro člověka) a yaml. Ve výchozím nastavení je výstup rozhraní příkazového řádku ve formátu table. Další informace o dostupných formátech výstupu najdete v tématu Formát výstupu pro příkazy Rozhraní příkazového řádku Azure Sphere. |
| --dotaz | Použije dotazovací jazyk JMESPath k filtrování výstupu vráceného ze služeb zabezpečení Azure Sphere. Další informace a příklady najdete v kurzu JMESPath a dotazování výstupu příkazu Azure CLI. |
| --užvaněný | Vytiskne informace o prostředcích vytvořených v Azure Sphere během operace a dalších užitečných informací. Pokud chcete zobrazit úplné protokoly ladění, použijte parametr --debug. |
Poznámka:
Pokud používáte Azure Sphere Classic CLI, další informace o dostupných možnostech najdete v tématu Globální parametry .
Příklad
Příklad určení skupiny zařízení podle ID:
azsphere device-group show --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Příklad určení skupiny zařízení podle názvu:
azsphere device-group show --device-group DW100/Marketing
Měl by se zobrazit výstup podobný tomuto:
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
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
Aktualizuje existující skupinu zařízení identifikovanou podle ID nebo názvu produktu a páru názvů skupin zařízení.
Povinné parametry
| Parametr | Typ | Popis |
|---|---|---|
| -g, --device-group | String | Určuje skupinu zařízení, pro kterou se mají aktualizovat podrobnosti. Můžete zadat ID skupiny zařízení nebo název skupiny zařízení. Pokud chcete použít název skupiny zařízení, musíte zadat název produktu i název skupiny zařízení ve <product-name/device-group-name> formátu. |
Volitelné parametry
| Parametr | Typ | Popis |
|---|---|---|
| -c, --allow-crash-dumps-collection | String | Nastavte souhlas pro shromažďování výpisů stavu systému od Microsoftu pro skupinu zařízení. Výchozí hodnota je Off. Povolené hodnoty: Off a On. Pomocí parametru --regional-data-boundary určete, kam se mají ukládat soubory s výpisem stavu systému. Další informace najdete v tématu Konfigurace výpisů stavu systému. |
| -a, --application-update | ApplicationUpdatePolicyType | Určuje zásady aktualizace aplikace pro skupinu zařízení. Povolené hodnoty: No3rdPartyAppUpdates, UpdateAlla NoUpdates. Výchozí hodnota je UpdateAll. Tato NoUpdates zásada je aktuálně vyhrazená jenom pro interní použití. |
| -d, --new-description | String | Určuje volitelný text pro popis skupiny zařízení. Maximální délka je 100 znaků. |
| -n, --new-name | String | Určuje nový název skupiny zařízení. Název může obsahovat pouze alfanumerické znaky. Pokud název obsahuje mezery, uzavřete ho do uvozovek. Název skupiny zařízení nesmí překročit 50 znaků, nerozlišuje velká a malá písmena a musí být v rámci produktu jedinečný. |
| -f, --os-feed | String | Určuje informační kanál operačního systému pro skupinu zařízení. Možné hodnoty jsou Retail a RetailEval. |
| -t, --tenant | IDENTIFIKÁTOR GUID nebo název | Určuje tenanta, ve které se má tato operace provést. Přepíše výchozího vybraného tenanta. Můžete zadat BUĎ ID tenanta, nebo název tenanta. |
| -r, --regional-data-boundary | String | Hranice místních dat pro tento obrázek. Povolené hodnoty: EU, None. Výchozí hodnota je None. Pokud není zadaná žádná hodnota, použije se výchozí hodnota. Další informace najdete v tématu Konfigurace výpisů stavu systému – Aspekty pivacy |
Globální parametry
Pro Rozhraní příkazového řádku Azure Sphere jsou k dispozici následující globální parametry:
| Parametr | Popis |
|---|---|
| --ladicí | Zvyšuje úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. Pokud narazíte na chybu, při odesílání zprávy o chybě zadejte výstup vygenerovaný pomocí příznaku --debug. |
| -h, --help | Vytiskne referenční informace rozhraní příkazového řádku o příkazech a jejich argumentech a seznamech dostupných podskupin a příkazů. |
| --only-show-errors | Zobrazuje pouze chyby a potlačuje upozornění. |
| -o, --output | Změní formát výstupu. Dostupné výstupní formáty jsou json, jsonc (barevné JSON), tsv (hodnoty oddělené tabulátory), tabulka (tabulky ASCII čitelné pro člověka) a yaml. Ve výchozím nastavení je výstup rozhraní příkazového řádku ve formátu table. Další informace o dostupných formátech výstupu najdete v tématu Formát výstupu pro příkazy Rozhraní příkazového řádku Azure Sphere. |
| --dotaz | Použije dotazovací jazyk JMESPath k filtrování výstupu vráceného ze služeb zabezpečení Azure Sphere. Další informace a příklady najdete v kurzu JMESPath a dotazování výstupu příkazu Azure CLI. |
| --užvaněný | Vytiskne informace o prostředcích vytvořených v Azure Sphere během operace a dalších užitečných informací. Pokud chcete zobrazit úplné protokoly ladění, použijte parametr --debug. |
Poznámka:
Pokud používáte Azure Sphere Classic CLI, další informace o dostupných možnostech najdete v tématu Globální parametry .
Příklad
Příklad určení skupiny zařízení podle ID:
azsphere device-group update --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd --new-description "Marketing device group"
Příklad určení skupiny zařízení podle názvu:
azsphere device-group update --device-group DW100/Marketing --new-description "Marketing device group"
Měl by se zobrazit výstup podobný tomuto:
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------
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
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------