Az Azure CLI-hez készült Azure Sphere-bővítmény áttekintése

Az Azure Sphere-hez csatlakoztatott eszközök és felhőtelepítések kezelésére szolgáló parancssori eszköz Azure CLI-bővítményként van elosztva.

Az Azure CLI és az Azure Sphere bővítmény telepítése

Az Azure CLI-hez készült Azure Sphere-bővítmény beszerzése:

1. Ha még nem tette meg, telepítse az Azure CLI-t .

2. Az Azure Sphere-bővítmény hozzáadásához futtassa a következő parancsot:

   az extension add --name azure-sphere
   

Az Azure Sphere-eszközök kezeléséhez használni kívánt Azure-előfizetésbe való bejelentkezéshez be kell jelentkeznie az Azure CLI-vel .

A bővítmény telepítése után a rendszerhéjváltozó értéke alatt található a $AZURE_EXTENSION_DIR helye. Ha ez a változó nincs beállítva, akkor az alapértelmezett értéke $HOME/.azure/cliextensions a Linux és macOS rendszereken, és %USERPROFILE%\.azure\cliextensions a Windows rendszereken.

Tipp.

Bejelentkezés után megjelenik az Azure-fiókjához társított előfizetések listája. Győződjön meg arról, hogy a megfelelő működéshez az az account set Azure Sphere-bővítmény parancsával válassza ki a szükséges engedélyekkel rendelkező előfizetést. További információ az előfizetés kiválasztásáról: Több Azure-előfizetés használata.

Az Azure Sphere-bővítmény kezelése

Az Azure CLI-bővítmények telepített verzióinak megtekintéséhez használja a következő parancsot:

az version

Ha az Azure Sphere-bővítményt a legújabb verzióra szeretné frissíteni, használja a következőt:

az extension update --name azure-sphere

Az Azure Sphere-bővítmény eltávolításához használja a következőt:

az extension remove --name azure-sphere

Gyakori Azure Sphere CLI-parancsok

Az Azure Sphere-parancsokat a Windows parancssorából vagy a PowerShellből való beírással az sphere használhatja. Linuxon bármilyen parancssori felületet (CLI) használhat. A CLI teljes körű parancssori kiegészítési funkcióval rendelkezik a bash felületen lévő parancsokhoz.

Ez a táblázat felsorol néhány gyakori Azure Sphere-parancsot és hivatkozásokat a referenciadokumentációjukra.

Parancs	Leírás
az sphere catalog	A katalógus kezelése.
az sphere ca-certificate	Tanúsítványok kezelése a katalógusban.
az sphere deployment	Az üzemelő példányok kezelése a katalógusban.
az sphere device	Azure Sphere-eszközök kezelése.
az sphere device-group	Eszközcsoportok kezelése a katalógusban.
az sphere image	Képek kezelése a katalógusban.
az sphere product	Termékek kezelése a katalógusban.
az sphere get-support-data	Diagnosztikai adatok gyűjtése a rendszerről, a felhő- és az eszközkonfigurációkról.

Az Azure CLI lehetővé teszi olyan konfigurációs beállítások beállítását, amelyek leegyszerűsítik az Azure Sphere CLI-parancsok használatát azáltal, hogy alapértelmezett értékeket adnak meg az olyan paraméterekhez, mint az --resource-group, --subscriptionvagy --catalog.

Eszközfüggő parancsok

A parancs helyileg csatlakoztatott Azure Sphere-eszközzel működik. Ha eszköz csatlakoztatása nélkül próbálja meg a parancsot, hibaüzenet jelenik meg. További információ az eszközparancsokról: az sphere device

• az sphere device claim
• az sphere device recover
• az sphere device restart
• az sphere device show-attached
• az sphere device show-os-version
• az sphere device app show-memory-status
• az sphere device app show-quota
• az sphere device app show-status
• az sphere device app start
• az sphere device app stop
• az sphere device capability show-attached
• az sphere device capability update
• az sphere device certificate add
• az sphere device certificate delete
• az sphere device certificate list
• az sphere device certificate show
• az sphere device certificate show-quota
• az sphere device image list-installed
• az sphere image-package show
• az sphere device manufacturing-state show
• az sphere device manufacturing-state update
• az sphere device network proxy apply
• az sphere device network proxy delete
• az sphere device network proxy show
• az sphere device network disable
• az sphere device network enable
• az sphere device network list-firewall-rules
• az sphere device network list-interfaces
• az sphere device network show-diagnostics
• az sphere device network show-status
• az sphere device network update-interface
• az sphere device sideload delete
• az sphere device sideload deploy
• az sphere device wifi add
• az sphere device wifi disable
• az sphere device wifi enable
• az sphere device wifi forget
• az sphere device wifi list
• az sphere device wifi reload-config
• az sphere device wifi scan
• az sphere device wifi show
• az sphere device wifi show-status

Globálisan elérhető argumentumok

Az Azure Sphere-bővítményhez a következő globális paraméterek érhetők el:

Paraméter	Leírás
--debug	Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
--help -h	A súgóüzenetet jeleníti meg.
--only-show-errors	Csak a hibákat jeleníti meg, és letiltja a figyelmeztetéseket.
--output -o	Kimeneti formátum. Engedélyezett értékek: json, jsonc, none, table, tsv, yaml. yamlc Alapértelmezett: 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. A --debug használata a teljes hibakeresési naplók megjelenítéséhez.