Megosztás a következőn keresztül:

az iot edge devices

  • Referencia

Feljegyzés

Ez a hivatkozás az Azure CLI azure-iot bővítményének része (2.46.0-s vagy újabb verzió). A bővítmény automatikusan telepíti az az iot edge-eszközök parancsának első futtatásakor. További információ a bővítményekről.

Parancsok az IoT Edge-eszközök kezeléséhez.

Parancsok

Name Description Típus Állapot
az iot edge devices create

Több peremhálózati eszköz létrehozása és konfigurálása egy IoT Hubon.

 Mellék Kísérleti

az iot edge devices create

Kísérleti

Ez a parancs kísérleti és fejlesztés alatt áll. Referencia- és támogatási szintek: https://aka.ms/CLI_refstatus

Több peremhálózati eszköz létrehozása és konfigurálása egy IoT Hubon.

Ez a művelet elfogadja a beágyazott eszközargumentumokat vagy a peremhálózati eszközök konfigurációs fájlját YAML vagy JSON formátumban. A beágyazott parancsok (például "--device-auth") elsőbbséget élveznek, és felülbírálják a konfigurációs fájl tulajdonságait, ha meg vannak adva. A mintakonfigurációs fájl itt található: https://aka.ms/aziotcli-edge-devices-config Tekintse át a példákat és a paraméterek leírását a művelet teljes kihasználásának részleteiért.

az iot edge devices create [--auth-type {key, login}]
                           [--cfg]
                           [--clean {false, true}]
                           [--dct]
                           [--dea]
                           [--device]
                           [--device-auth {shared_private_key, x509_thumbprint}]
                           [--hub-name]
                           [--login]
                           [--out]
                           [--rc]
                           [--resource-group]
                           [--rk]
                           [--root-pass]
                           [--vis {false, true}]
                           [--yes {false, true}]

Példák

Néhány peremeszköz létrehozása szimmetrikus kulcs-hitelesítéssel (alapértelmezett)

az iot edge devices create -n {hub_name} --device id=device_1 --device id=device_2

A peremhálózati eszközök egyszerű listájának létrehozása önaláírt tanúsítványhitelesítéssel, különböző peremhálózati tulajdonságkonfigurációkkal, beágyazott argumentumok használatával.

az iot edge devices create -n {hub_name} --device-auth x509_thumbprint --default-edge-agent "mcr.microsoft.com/azureiotedge-agent:1.4"
--device id=device_1 hostname={FQDN}
--device id=device_2 edge_agent={agent_image}
--device id=parent hostname={FQDN} edge_agent={agent_image} container_auth={path_or_json_string}

Törölje a központ összes meglévő eszközidentitását, és hozzon létre új eszközöket egy konfigurációs fájl alapján (folyamatjelző sávokkal és vizualizációs kimenettel).

az iot edge devices create -n {hub_name} --cfg path/to/config_yml_or_json -c -v

Hozzon létre egy beágyazott peremhálózati eszközöket egyéni modultelepítésekkel – amelyek 2 szülőeszközt tartalmaznak 1 gyermekeszközzel, beágyazott argumentumok használatával. Megadja az eszköztanúsítvány-csomagok kimeneti elérési útját is.

az iot edge devices create -n {hub_name} --out {device_bundle_path}
--device id=parent_1 deployment=/path/to/parentDeployment_1.json
--device id=child_1 parent=parent_1 deployment=/path/to/child_deployment_1.json
--device id=parent_2 deployment=/path/to/parentDeployment_2.json
--device id=child_2 parent=parent_2 deployment=/path/to/child_deployment_2.json

Hozzon létre egy egyszerű beágyazott peremhálózati eszközkonfigurációt egy meglévő legfelső szintű hitelesítésszolgáltatóval x509-hitelesítés használatával, és adjon meg egy egyéni eszközcsomag kimeneti elérési útját.

az iot edge devices create -n {hub_name} --out {device_bundle_path}
--root-cert "root_cert.pem" --root-key "root_key.pem" --device-auth x509_thumbprint
--device id=parent1
--device id=child1 parent=parent1

Opcionális paraméterek

--auth-type

Azt jelzi, hogy a műveletnek automatikusan le kell-e származtatnia egy szabályzatkulcsot, vagy az aktuális Azure AD-munkamenetet kell-e használnia. Ha a hitelesítési típus bejelentkezés, és az erőforrás-állomásnév meg van adva, az erőforrás-keresés kihagyva lesz, hacsak nem szükséges. Az alapértelmezett beállítást a következővel az configure --defaults iothub-data-auth-type=<auth-type-value>konfigurálhatja: .

Elfogadott értékek: key, login
Alapértelmezett érték: key
--cfg --config --config-file

Az eszközök konfigurációs fájljának elérési útja. Mintakonfigurációs fájl: https://aka.ms/aziotcli-edge-devices-config.

--clean -c

Az új eszközök létrehozása előtt törli a célközpont összes eszközét.

Elfogadott értékek: false, true
Alapértelmezett érték: False
--dct --device-config-template

Az IoT Edge config.toml fájl elérési útja az edge-eszközök konfigurációinak alapjául.

--dea --default-agent --default-edge-agent

A létrehozott Edge-eszközök alapértelmezett peremhálózati ügynöke, ha nincs külön megadva.

--device -d

Szóközzel elválasztott kulcs=a létrehozandó peremeszköz tulajdonságainak megfelelő értékpárok. A következő kulcsértékek támogatottak: id (device_id), deployment (beágyazott json vagy fájl elérési útja), hostname, parent (device_id), edge_agent (kép URL-címe) és container_auth (beágyazott json vagy fájl elérési útja). -- az eszköz 1 vagy több alkalommal használható. Tekintse át a teljes paraméterhasználatra vonatkozó súgó példákat – ezek a paraméterek a megfelelő értékekre is hivatkoznak a mintakonfigurációs fájlban: https://aka.ms/aziotcli-edge-devices-config.

--device-auth --device-auth-type

Eszköz–központ engedélyezési mechanizmus.

Elfogadott értékek: shared_private_key, x509_thumbprint
--hub-name -n

IoT Hub neve vagy állomásneve. Kötelező, ha a --login nincs megadva.

--login -l

Ez a parancs egy művelet végrehajtására jogosult entitást kapcsolati sztring támogat. Az "az login" használatával elkerülheti a munkamenet-bejelentkezést. Ha egy entitás kapcsolati sztring és név is meg van adva, a kapcsolati sztring elsőbbséget élvez. Ha a --hub-name nincs megadva, kötelező megadni.

--out --output-path

Címtár elérési útja a kimeneti eszközkonfigurációs csomagokhoz. Ha ez az érték nincs megadva, a rendszer nem hoz létre fájlkimenetet.

--rc --root-cert

A nyilvános kulcs főtanúsítványának elérési útja beágyazott peremhálózati eszköz tanúsítványainak aláírásához.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

--rk --root-key

A titkos kulcs gyökérkulcsának elérési útja a beágyazott peremhálózati eszköz tanúsítványainak aláírásához.

--root-pass --rp

Gyökérkulcs jelszava.

--vis --visualize -v

Megjeleníti az eszközök vizualizációit és a különböző feladatok előrehaladását (eszközlétrehozás, szülők beállítása, konfigurációk frissítése stb.).

Elfogadott értékek: false, true
Alapértelmezett érték: False
--yes -y

Ne kérje a megerősítést, ha a --clean kapcsoló a meglévő központi eszközök törlésére szolgál.

Elfogadott értékek: false, true
Alapértelmezett érték: False
Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
Alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.