eszközcsoport
Fontos
Ez az Azure Sphere (örökölt) dokumentációja. Az Azure Sphere (örökölt) 2027. szeptember 27-én nyugdíjba vonul, és a felhasználóknak ekkorra az Azure Sphere-be (integrált) kell migrálniuk. Az Azure Sphere (integrált) dokumentációjának megtekintéséhez használja a TOC felett található Verzióválasztót.
Eszközcsoportokat hoz létre és kezel.
Az eszközcsoportokat azonosító (ID) vagy terméknév és eszközcsoportnév pár kezeli.
| Művelet | Leírás |
|---|---|
| létrehozás | Új eszközcsoportot hoz létre. |
| list | Listázhatja az Azure Sphere-bérlő összes eszközcsoportját. |
| törlés | Egy meglévő eszközcsoport törlése. |
| felfejlődés | Az eszközcsoporton belüli központi telepítéseket kezeli. |
| eszköz | Az eszközcsoportban lévő eszközök listája. |
| mutat | Az eszközcsoportra vonatkozó információkat jeleníti meg. |
| frissít | Módosít egy meglévő eszközcsoportot. |
létrehozás
Létrehoz egy eszközcsoportot a megadott termékhez megadott névvel. Az eszközcsoport rendszerezi azokat az eszközöket, amelyek azonos termékkel rendelkeznek, és ugyanazokat az alkalmazásokat fogadják a felhőből.
Kötelező paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| -p, --product | GUID vagy név | Megadja azt a terméket, amelybe ezt az eszközcsoportot hozzá szeretné adni. Megadhatja az Azure Sphere-termék azonosítóját vagy nevét. |
| -n, --name | Sztring | Megadja az eszközcsoport nevét. A név csak alfanumerikus karaktereket tartalmazhat. Ha a név szóközöket tartalmaz, tegye idézőjelek közé. Az eszközcsoport neve nem haladhatja meg az 50 karaktert, a kis- és nagybetűk nem érzékenek, egyedinek kell lenniük a terméken belül. |
Választható paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| -a, --application-update | Enumeráció | Meghatározza az eszközcsoportra alkalmazandó alkalmazásfrissítési szabályzatot. Elfogadott értékek: No3rdPartyAppUpdates, UpdateAllés NoUpdates. Az alapértelmezett szint a UpdateAll. A NoUpdates szabályzat jelenleg csak belső használatra van fenntartva. |
| -f, --os-feed | Enumeráció | Megadja az operációsrendszer-frissítésekhez használandó operációsrendszer-hírcsatorna típusát. Elfogadott értékek: Retail, RetailEval. |
| -t, --tenant | GUID vagy név | Megadja a bérlőt, amelyben végrehajtja ezt a műveletet. Felülbírálja az alapértelmezett kijelölt bérlőt. Megadhatja a bérlőazonosítót vagy a bérlő nevét. |
| -d, --description | Sztring | Megadja az eszközcsoport leírásához szükséges opcionális szöveget. A maximális hossz 100 karakter. Ha a leírás szóközöket tartalmaz, tegye idézőjelek közé. |
| -r, --regional-data-boundary | Sztring | A rendszerkép regionális adathatára. Engedélyezett értékek: EU, None. Az alapértelmezett érték None. Ha nincs megadva érték, a rendszer az alapértelmezett értéket használja. További információ: Összeomlási memóriaképek konfigurálása – Pivacy-szempontok |
Globális paraméterek
Az Azure Sphere CLI-hez a következő globális paraméterek érhetők el:
| Paraméter | Leírás |
|---|---|
| --Debug | Növeli a naplózás részletességét az összes hibakeresési napló megjelenítéséhez. Ha hibát talál, akkor a --debug jelölővel létrehozott kimenetet küldje el a hibajelentéssel együtt. |
| -h, --help | A parancssori felület hivatkozási információit nyomtatja ki a parancsokról és azok argumentumairól, valamint felsorolja az elérhető alcsoportokat és parancsokat. |
| --only-show-errors | Csak a hibákat jeleníti meg, és letiltja a figyelmeztetéseket. |
| -o, --output | Módosítja a kimeneti formátumot. A rendelkezésre álló kimeneti formátumok a json, jsonc (színezett JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) és yaml. Alapértelmezés szerint a CLI a következő kimenetet használja: table. Az elérhető kimeneti formátumokról további információt az Azure Sphere CLI-parancsok kimeneti formátuma című témakörben talál. |
| --lekérdezés | A JMESPath lekérdezési nyelv használatával szűri az Azure Sphere Security Services által visszaadott kimenetet. További információkért és példákért tekintse meg a JMESPath-oktatóanyagot és az Azure CLI-parancskimenet lekérdezését. |
| --bőbeszédű | Kinyomtatja az Azure Sphere-ben egy művelet során létrehozott erőforrásokra vonatkozó információkat és egyéb hasznos információkat. A --debug használata a teljes hibakeresési naplók megjelenítéséhez. |
Feljegyzés
Ha klasszikus Azure Sphere cli-t használ, a rendelkezésre álló lehetőségekről további információt a globális paraméterekben talál.
Példa
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
Listázhatja az Azure Sphere-bérlő összes eszközcsoportját.
Választható paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| -t, --tenant | GUID vagy név | Megadja a bérlőt, amelyben végrehajtja ezt a műveletet. Felülbírálja az alapértelmezett kijelölt bérlőt. Megadhatja a bérlőazonosítót vagy a bérlő nevét. |
Globális paraméterek
Az Azure Sphere CLI-hez a következő globális paraméterek érhetők el:
| Paraméter | Leírás |
|---|---|
| --Debug | Növeli a naplózás részletességét az összes hibakeresési napló megjelenítéséhez. Ha hibát talál, akkor a --debug jelölővel létrehozott kimenetet küldje el a hibajelentéssel együtt. |
| -h, --help | A parancssori felület hivatkozási információit nyomtatja ki a parancsokról és azok argumentumairól, valamint felsorolja az elérhető alcsoportokat és parancsokat. |
| --only-show-errors | Csak a hibákat jeleníti meg, és letiltja a figyelmeztetéseket. |
| -o, --output | Módosítja a kimeneti formátumot. A rendelkezésre álló kimeneti formátumok a json, jsonc (színezett JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) és yaml. Alapértelmezés szerint a CLI a következő kimenetet használja: table. Az elérhető kimeneti formátumokról további információt az Azure Sphere CLI-parancsok kimeneti formátuma című témakörben talál. |
| --lekérdezés | A JMESPath lekérdezési nyelv használatával szűri az Azure Sphere Security Services által visszaadott kimenetet. További információkért és példákért tekintse meg a JMESPath-oktatóanyagot és az Azure CLI-parancskimenet lekérdezését. |
| --bőbeszédű | Kinyomtatja az Azure Sphere-ben egy művelet során létrehozott erőforrásokra vonatkozó információkat és egyéb hasznos információkat. A --debug használata a teljes hibakeresési naplók megjelenítéséhez. |
Feljegyzés
Ha klasszikus Azure Sphere cli-t használ, a rendelkezésre álló lehetőségekről további információt a globális paraméterekben talál.
Példa
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
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- --------------------------------------------------
Törlés...
Törli a megadott eszközcsoportot az Azure Sphere-bérlőben.
Az eszközcsoport csak akkor törölhető, ha:
- A felhasználó rendszergazdai engedélyekkel rendelkezik a bérlőhöz.
- Az eszközcsoport üres, és nincsenek benne eszközök. Az azsphere eszközcsoport eszközlista parancsa felsorolja az eszközcsoport összes eszközét. Futtassa az azsphere-eszközfrissítés --device-group parancsot az eszköz másik eszközcsoportba való áthelyezéséhez.
Kötelező paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| -g, --device-group | Sztring | Megadja a törölni kívánt eszközcsoportot. Megadhatja az eszközcsoport azonosítóját vagy az eszközcsoport nevét. Az eszközcsoport nevének használatához meg kell adnia a termék nevét és az eszközcsoport nevét is.<product-name/device-group-name> |
Választható paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| -t, --tenant | GUID vagy név | Megadja a bérlőt, amelyben végrehajtja ezt a műveletet. Felülbírálja az alapértelmezett kijelölt bérlőt. Megadhatja a bérlőazonosítót vagy a bérlő nevét. |
Globális paraméterek
Az Azure Sphere CLI-hez a következő globális paraméterek érhetők el:
| Paraméter | Leírás |
|---|---|
| --Debug | Növeli a naplózás részletességét az összes hibakeresési napló megjelenítéséhez. Ha hibát talál, akkor a --debug jelölővel létrehozott kimenetet küldje el a hibajelentéssel együtt. |
| -h, --help | A parancssori felület hivatkozási információit nyomtatja ki a parancsokról és azok argumentumairól, valamint felsorolja az elérhető alcsoportokat és parancsokat. |
| --only-show-errors | Csak a hibákat jeleníti meg, és letiltja a figyelmeztetéseket. |
| -o, --output | Módosítja a kimeneti formátumot. A rendelkezésre álló kimeneti formátumok a json, jsonc (színezett JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) és yaml. Alapértelmezés szerint a CLI a következő kimenetet használja: table. Az elérhető kimeneti formátumokról további információt az Azure Sphere CLI-parancsok kimeneti formátuma című témakörben talál. |
| --lekérdezés | A JMESPath lekérdezési nyelv használatával szűri az Azure Sphere Security Services által visszaadott kimenetet. További információkért és példákért tekintse meg a JMESPath-oktatóanyagot és az Azure CLI-parancskimenet lekérdezését. |
| --bőbeszédű | Kinyomtatja az Azure Sphere-ben egy művelet során létrehozott erőforrásokra vonatkozó információkat és egyéb hasznos információkat. A --debug használata a teljes hibakeresési naplók megjelenítéséhez. |
Feljegyzés
Ha klasszikus Azure Sphere cli-t használ, a rendelkezésre álló lehetőségekről további információt a globális paraméterekben talál.
Példa
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
üzembe helyezés
Egy eszközcsoport központi telepítéseinek kezelése.
| Művelet | Leírás |
|---|---|
| létrehozás | Új üzembe helyezést hoz létre a megadott eszközcsoporthoz. |
| list | Megjeleníti egy eszközcsoport üzembe helyezését. |
üzembe helyezés létrehozása
Új üzembe helyezést hoz létre egy eszközcsoport számára a megadott rendszerképekkel.
Az eszközcsoportot azonosító (ID) vagy terméknév és eszközcsoportnév pár alapján is azonosíthatja.
Kötelező paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| -g, --device-group | Sztring | Megadja azt az eszközcsoportot, amelyben létre kívánja hozni az üzembe helyezést. Megadhatja az eszközcsoport azonosítóját vagy az eszközcsoport nevét. Az eszközcsoport nevének használatához meg kell adnia a termék nevét és az eszközcsoport nevét is.<product-name/device-group-name> |
| -i, --images | Sztring | Megadja az üzembe helyezésbe felvenni kívánt egy vagy több rendszerkép képazonosítóit. Több képet is hozzáadhat további paraméterek hozzáadásával, vagy több képazonosító kombinálható egyetlen paraméterben egy szóközzel elválasztott listában. Futtassa az azsphere image add parancsot a képazonosító lekéréséhez. |
Választható paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| -t, --tenant | GUID vagy név | Megadja a bérlőt, amelyben végrehajtja ezt a műveletet. Felülbírálja az alapértelmezett kijelölt bérlőt. Megadhatja a bérlőazonosítót vagy a bérlő nevét. |
Globális paraméterek
Az Azure Sphere CLI-hez a következő globális paraméterek érhetők el:
| Paraméter | Leírás |
|---|---|
| --Debug | Növeli a naplózás részletességét az összes hibakeresési napló megjelenítéséhez. Ha hibát talál, akkor a --debug jelölővel létrehozott kimenetet küldje el a hibajelentéssel együtt. |
| -h, --help | A parancssori felület hivatkozási információit nyomtatja ki a parancsokról és azok argumentumairól, valamint felsorolja az elérhető alcsoportokat és parancsokat. |
| --only-show-errors | Csak a hibákat jeleníti meg, és letiltja a figyelmeztetéseket. |
| -o, --output | Módosítja a kimeneti formátumot. A rendelkezésre álló kimeneti formátumok a json, jsonc (színezett JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) és yaml. Alapértelmezés szerint a CLI a következő kimenetet használja: table. Az elérhető kimeneti formátumokról további információt az Azure Sphere CLI-parancsok kimeneti formátuma című témakörben talál. |
| --lekérdezés | A JMESPath lekérdezési nyelv használatával szűri az Azure Sphere Security Services által visszaadott kimenetet. További információkért és példákért tekintse meg a JMESPath-oktatóanyagot és az Azure CLI-parancskimenet lekérdezését. |
| --bőbeszédű | Kinyomtatja az Azure Sphere-ben egy művelet során létrehozott erőforrásokra vonatkozó információkat és egyéb hasznos információkat. A --debug használata a teljes hibakeresési naplók megjelenítéséhez. |
Feljegyzés
Ha klasszikus Azure Sphere cli-t használ, a rendelkezésre álló lehetőségekről további információt a globális paraméterekben talál.
Példa
A --device-group paraméter azonosítja az eszközcsoportot. Az eszközcsoport azonosítója egy GUID azonosítót biztosít, amely egyedileg azonosítja az eszközcsoportot az összes termékben. Másik lehetőségként a terméknév és az eszközcsoport névpárját is használhatja terméknév<>/<eszközcsoport-név> formátumban. Ez a névpár egyedileg azonosítja egy adott termék eszközcsoportját.
Példa az eszközcsoport azonosító szerinti megadására:
azsphere device-group deployment create --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd --images 5572509b-43a4-45b0-88c5-365cbf9732c1
Példa az eszközcsoport név szerinti megadására:
azsphere device-group deployment create --device-group DW100/Development --images 5572509b-43a4-45b0-88c5-365cbf9732c1
Példa több képazonosító megadására a szóközök által elválasztott értékek listájának megadásával:
azsphere device-group deployment create --device-group DW100/Development --images 5572509b-43a4-45b0-88c5-365cbf9732c1 3bbd2d2a-2870-4dde-9db8-ae50548ea7b4
A következőhöz hasonló kimenetnek kell megjelennie:
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
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
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
üzembe helyezési lista
Megjeleníti egy eszközcsoport üzembehelyezési előzményeit. Az üzembehelyezési azonosítót, az időbélyeget és a mellékelt képek listáját adja vissza. A listát a legutóbbi üzemelő példányok rendezik.
Kötelező paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| -g, --device-group | Sztring | Meghatározza azt az eszközcsoportot, amelynek az üzembe helyezési előzmények listáját meg szeretné jeleníteni. Megadhatja az eszközcsoport azonosítóját vagy az eszközcsoport nevét. Az eszközcsoport nevének használatához meg kell adnia a termék nevét és az eszközcsoport nevét is.<product-name/device-group-name> |
Választható paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| -t, --tenant | GUID vagy név | Megadja a bérlőt, amelyben végrehajtja ezt a műveletet. Felülbírálja az alapértelmezett kijelölt bérlőt. Megadhatja a bérlőazonosítót vagy a bérlő nevét. |
Globális paraméterek
Az Azure Sphere CLI-hez a következő globális paraméterek érhetők el:
| Paraméter | Leírás |
|---|---|
| --Debug | Növeli a naplózás részletességét az összes hibakeresési napló megjelenítéséhez. Ha hibát talál, akkor a --debug jelölővel létrehozott kimenetet küldje el a hibajelentéssel együtt. |
| -h, --help | A parancssori felület hivatkozási információit nyomtatja ki a parancsokról és azok argumentumairól, valamint felsorolja az elérhető alcsoportokat és parancsokat. |
| --only-show-errors | Csak a hibákat jeleníti meg, és letiltja a figyelmeztetéseket. |
| -o, --output | Módosítja a kimeneti formátumot. A rendelkezésre álló kimeneti formátumok a json, jsonc (színezett JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) és yaml. Alapértelmezés szerint a CLI a következő kimenetet használja: table. Az elérhető kimeneti formátumokról további információt az Azure Sphere CLI-parancsok kimeneti formátuma című témakörben talál. |
| --lekérdezés | A JMESPath lekérdezési nyelv használatával szűri az Azure Sphere Security Services által visszaadott kimenetet. További információkért és példákért tekintse meg a JMESPath-oktatóanyagot és az Azure CLI-parancskimenet lekérdezését. |
| --bőbeszédű | Kinyomtatja az Azure Sphere-ben egy művelet során létrehozott erőforrásokra vonatkozó információkat és egyéb hasznos információkat. A --debug használata a teljes hibakeresési naplók megjelenítéséhez. |
Feljegyzés
Ha klasszikus Azure Sphere cli-t használ, a rendelkezésre álló lehetőségekről további információt a globális paraméterekben talál.
Példa
Példa az eszközcsoport azonosító szerinti megadására:
azsphere device-group deployment list --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Példa az eszközcsoport név szerinti megadására:
azsphere device-group deployment list --device-group DW100/Development
A következőhöz hasonló kimenetnek kell megjelennie:
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
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
Egy eszközcsoport eszközeit kezeli.
| Művelet | Leírás |
|---|---|
| list | Megjeleníti az eszközöket egy eszközcsoportban. |
| show-count | Az eszközcsoportban lévő eszközök számát jeleníti meg. |
eszközlista
Megjeleníti az eszközöket egy eszközcsoportban.
Kötelező paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| -g, --device-group | Sztring | Azt az eszközcsoportot adja meg, amelynek az eszközlistáját meg szeretné jeleníteni. Megadhatja az eszközcsoport azonosítóját vagy az eszközcsoport nevét. Az eszközcsoport nevének használatához meg kell adnia a termék nevét és az eszközcsoport nevét is.<product-name/device-group-name> |
Választható paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| -t, --tenant | GUID vagy név | Megadja a bérlőt, amelyben végrehajtja ezt a műveletet. Felülbírálja az alapértelmezett kijelölt bérlőt. Megadhatja a bérlőazonosítót vagy a bérlő nevét. |
Globális paraméterek
Az Azure Sphere CLI-hez a következő globális paraméterek érhetők el:
| Paraméter | Leírás |
|---|---|
| --Debug | Növeli a naplózás részletességét az összes hibakeresési napló megjelenítéséhez. Ha hibát talál, akkor a --debug jelölővel létrehozott kimenetet küldje el a hibajelentéssel együtt. |
| -h, --help | A parancssori felület hivatkozási információit nyomtatja ki a parancsokról és azok argumentumairól, valamint felsorolja az elérhető alcsoportokat és parancsokat. |
| --only-show-errors | Csak a hibákat jeleníti meg, és letiltja a figyelmeztetéseket. |
| -o, --output | Módosítja a kimeneti formátumot. A rendelkezésre álló kimeneti formátumok a json, jsonc (színezett JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) és yaml. Alapértelmezés szerint a CLI a következő kimenetet használja: table. Az elérhető kimeneti formátumokról további információt az Azure Sphere CLI-parancsok kimeneti formátuma című témakörben talál. |
| --lekérdezés | A JMESPath lekérdezési nyelv használatával szűri az Azure Sphere Security Services által visszaadott kimenetet. További információkért és példákért tekintse meg a JMESPath-oktatóanyagot és az Azure CLI-parancskimenet lekérdezését. |
| --bőbeszédű | Kinyomtatja az Azure Sphere-ben egy művelet során létrehozott erőforrásokra vonatkozó információkat és egyéb hasznos információkat. A --debug használata a teljes hibakeresési naplók megjelenítéséhez. |
Feljegyzés
Ha klasszikus Azure Sphere cli-t használ, a rendelkezésre álló lehetőségekről további információt a globális paraméterekben talál.
Példa
Példa az eszközcsoport azonosító szerinti megadására:
azsphere device-group device list --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Példa az eszközcsoport név szerinti megadására:
azsphere device-group device list --device-group DW100/Marketing
A következőhöz hasonló kimenetnek kell megjelennie:
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
DeviceId TenantId ProductId DeviceGroupId
===================================================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 143adbc9-1bf0-4be2-84a2-084a331d81cb 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
eszköz show-count
Megjeleníti az eszközcsoportban lévő eszközök számát.
Kötelező paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| -g, --device-group | Sztring | Meghatározza azt az eszközcsoportot, amelynek az eszközszámát meg szeretné jeleníteni. Megadhatja az eszközcsoport azonosítóját vagy az eszközcsoport nevét. Az eszközcsoport nevének használatához meg kell adnia a termék nevét és az eszközcsoport nevét is.<product-name/device-group-name> |
Választható paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| -t, --tenant | GUID vagy név | Megadja a bérlőt, amelyben végrehajtja ezt a műveletet. Felülbírálja az alapértelmezett kijelölt bérlőt. Megadhatja a bérlőazonosítót vagy a bérlő nevét. |
Globális paraméterek
Az Azure Sphere CLI-hez a következő globális paraméterek érhetők el:
| Paraméter | Leírás |
|---|---|
| --Debug | Növeli a naplózás részletességét az összes hibakeresési napló megjelenítéséhez. Ha hibát talál, akkor a --debug jelölővel létrehozott kimenetet küldje el a hibajelentéssel együtt. |
| -h, --help | A parancssori felület hivatkozási információit nyomtatja ki a parancsokról és azok argumentumairól, valamint felsorolja az elérhető alcsoportokat és parancsokat. |
| --only-show-errors | Csak a hibákat jeleníti meg, és letiltja a figyelmeztetéseket. |
| -o, --output | Módosítja a kimeneti formátumot. A rendelkezésre álló kimeneti formátumok a json, jsonc (színezett JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) és yaml. Alapértelmezés szerint a CLI a következő kimenetet használja: table. Az elérhető kimeneti formátumokról további információt az Azure Sphere CLI-parancsok kimeneti formátuma című témakörben talál. |
| --lekérdezés | A JMESPath lekérdezési nyelv használatával szűri az Azure Sphere Security Services által visszaadott kimenetet. További információkért és példákért tekintse meg a JMESPath-oktatóanyagot és az Azure CLI-parancskimenet lekérdezését. |
| --bőbeszédű | Kinyomtatja az Azure Sphere-ben egy művelet során létrehozott erőforrásokra vonatkozó információkat és egyéb hasznos információkat. A --debug használata a teljes hibakeresési naplók megjelenítéséhez. |
Feljegyzés
Ha klasszikus Azure Sphere cli-t használ, a rendelkezésre álló lehetőségekről további információt a globális paraméterekben talál.
Példa
Példa az eszközcsoport azonosító szerinti megadására:
azsphere device-group device show-count --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Példa az eszközcsoport név szerinti megadására:
azsphere device-group device show-count --device-group DW100/Marketing
A következőhöz hasonló kimenetnek kell megjelennie:
------
Result
======
1
------
megjelenítés
Egy eszközcsoport adatait adja vissza.
Kötelező paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| -g, --device-group | Sztring | Megadja azt az eszközcsoportot, amelynek a részleteit meg szeretné jeleníteni. Megadhatja az eszközcsoport azonosítóját vagy az eszközcsoport nevét. Az eszközcsoport nevének használatához meg kell adnia a termék nevét és az eszközcsoport nevét is.<product-name/device-group-name> |
Választható paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| -t, --tenant | GUID vagy név | Megadja a bérlőt, amelyben végrehajtja ezt a műveletet. Felülbírálja az alapértelmezett kijelölt bérlőt. Megadhatja a bérlőazonosítót vagy a bérlő nevét. |
Globális paraméterek
Az Azure Sphere CLI-hez a következő globális paraméterek érhetők el:
| Paraméter | Leírás |
|---|---|
| --Debug | Növeli a naplózás részletességét az összes hibakeresési napló megjelenítéséhez. Ha hibát talál, akkor a --debug jelölővel létrehozott kimenetet küldje el a hibajelentéssel együtt. |
| -h, --help | A parancssori felület hivatkozási információit nyomtatja ki a parancsokról és azok argumentumairól, valamint felsorolja az elérhető alcsoportokat és parancsokat. |
| --only-show-errors | Csak a hibákat jeleníti meg, és letiltja a figyelmeztetéseket. |
| -o, --output | Módosítja a kimeneti formátumot. A rendelkezésre álló kimeneti formátumok a json, jsonc (színezett JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) és yaml. Alapértelmezés szerint a CLI a következő kimenetet használja: table. Az elérhető kimeneti formátumokról további információt az Azure Sphere CLI-parancsok kimeneti formátuma című témakörben talál. |
| --lekérdezés | A JMESPath lekérdezési nyelv használatával szűri az Azure Sphere Security Services által visszaadott kimenetet. További információkért és példákért tekintse meg a JMESPath-oktatóanyagot és az Azure CLI-parancskimenet lekérdezését. |
| --bőbeszédű | Kinyomtatja az Azure Sphere-ben egy művelet során létrehozott erőforrásokra vonatkozó információkat és egyéb hasznos információkat. A --debug használata a teljes hibakeresési naplók megjelenítéséhez. |
Feljegyzés
Ha klasszikus Azure Sphere cli-t használ, a rendelkezésre álló lehetőségekről további információt a globális paraméterekben talál.
Példa
Példa az eszközcsoport azonosító szerinti megadására:
azsphere device-group show --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Példa az eszközcsoport név szerinti megadására:
azsphere device-group show --device-group DW100/Marketing
A következőhöz hasonló kimenetnek kell megjelennie:
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
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
Frissít egy meglévő eszközcsoportot, amelyet azonosító vagy terméknév és eszközcsoport-névpár azonosít.
Kötelező paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| -g, --device-group | Sztring | Megadja azt az eszközcsoportot, amelyhez frissíteni szeretné a részleteket. Megadhatja az eszközcsoport azonosítóját vagy az eszközcsoport nevét. Az eszközcsoport nevének használatához meg kell adnia a termék nevét és az eszközcsoport nevét is.<product-name/device-group-name> |
Választható paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| -c, --allow-crash-dumps-collection | Sztring | Hozzájárulás megadása az összeomlási memóriaképek Microsoft általi gyűjtéséhez az eszközcsoport számára. Az alapértelmezett szint a Off. Engedélyezett értékek: Off és On. A paraméter használatával --regional-data-boundary megadhatja, hogy hol kell tárolni az összeomlási memóriaképfájlokat. További információ: Összeomlási memóriaképek konfigurálása. |
| -a, --application-update | ApplicationUpdatePolicyType | Megadja az eszközcsoport alkalmazásfrissítési szabályzatát. Engedélyezett értékek: No3rdPartyAppUpdates, UpdateAllés NoUpdates. Az alapértelmezett szint a UpdateAll. A NoUpdates szabályzat jelenleg csak belső használatra van fenntartva. |
| -d, --new-description | Sztring | Opcionális szöveget ad meg az eszközcsoport leírásához. A maximális hossz 100 karakter. |
| -n, --new-name | Sztring | Az eszközcsoport új nevét adja meg. A név csak alfanumerikus karaktereket tartalmazhat. Ha a név szóközöket tartalmaz, tegye idézőjelek közé. Az eszközcsoport neve nem haladhatja meg az 50 karaktert, a kis- és nagybetűk érzéketlenek, és egyedinek kell lenniük a terméken belül. |
| -f, --os-feed | Sztring | Megadja az eszközcsoport operációsrendszer-hírcsatornáját. A lehetséges értékek a következők: Retail és RetailEval. |
| -t, --tenant | GUID vagy név | Megadja a bérlőt, amelyben végrehajtja ezt a műveletet. Felülbírálja az alapértelmezett kijelölt bérlőt. Megadhatja a bérlőazonosítót vagy a bérlő nevét. |
| -r, --regional-data-boundary | Sztring | A rendszerkép regionális adathatára. Engedélyezett értékek: EU, None. Az alapértelmezett érték None. Ha nincs megadva érték, a rendszer az alapértelmezett értéket használja. További információ: Összeomlási memóriaképek konfigurálása – Pivacy-szempontok |
Globális paraméterek
Az Azure Sphere CLI-hez a következő globális paraméterek érhetők el:
| Paraméter | Leírás |
|---|---|
| --Debug | Növeli a naplózás részletességét az összes hibakeresési napló megjelenítéséhez. Ha hibát talál, akkor a --debug jelölővel létrehozott kimenetet küldje el a hibajelentéssel együtt. |
| -h, --help | A parancssori felület hivatkozási információit nyomtatja ki a parancsokról és azok argumentumairól, valamint felsorolja az elérhető alcsoportokat és parancsokat. |
| --only-show-errors | Csak a hibákat jeleníti meg, és letiltja a figyelmeztetéseket. |
| -o, --output | Módosítja a kimeneti formátumot. A rendelkezésre álló kimeneti formátumok a json, jsonc (színezett JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) és yaml. Alapértelmezés szerint a CLI a következő kimenetet használja: table. Az elérhető kimeneti formátumokról további információt az Azure Sphere CLI-parancsok kimeneti formátuma című témakörben talál. |
| --lekérdezés | A JMESPath lekérdezési nyelv használatával szűri az Azure Sphere Security Services által visszaadott kimenetet. További információkért és példákért tekintse meg a JMESPath-oktatóanyagot és az Azure CLI-parancskimenet lekérdezését. |
| --bőbeszédű | Kinyomtatja az Azure Sphere-ben egy művelet során létrehozott erőforrásokra vonatkozó információkat és egyéb hasznos információkat. A --debug használata a teljes hibakeresési naplók megjelenítéséhez. |
Feljegyzés
Ha klasszikus Azure Sphere cli-t használ, a rendelkezésre álló lehetőségekről további információt a globális paraméterekben talál.
Példa
Példa az eszközcsoport azonosító szerinti megadására:
azsphere device-group update --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd --new-description "Marketing device group"
Példa az eszközcsoport név szerinti megadására:
azsphere device-group update --device-group DW100/Marketing --new-description "Marketing device group"
A következőhöz hasonló kimenetnek kell megjelennie:
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------
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
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------