Översikt över Azure Sphere-tillägget för Azure CLI

Artikel
07/08/2024

Kommandoradsverktyget för att hantera Azure Sphere-anslutna enheter och molndistributioner distribueras som ett Azure CLI-tillägg.

Installera Azure CLI och Azure Sphere-tillägget

Så här hämtar du Azure Sphere-tillägget för Azure CLI:

Installera Azure CLI om du inte har gjort det ännu.
Om du vill lägga till Azure Sphere-tillägget kör du följande kommando:
```
az extension add --name azure-sphere
```

Du måste logga in med Azure CLI för att logga in på den Azure-prenumeration som du vill använda för att hantera Azure Sphere-enheter.

När ett tillägg har installerats finns dess plats under värdet för gränssnittsvariabeln $AZURE_EXTENSION_DIR . Om den här variabeln är odefinierad blir värdet som standard $HOME/.azure/cliextensions på Linux och macOS, och %USERPROFILE%\.azure\cliextensions på Windows.

Dricks

När du har loggat in visas en lista över prenumerationer som är associerade med ditt Azure-konto. Se till att du väljer prenumerationen med de behörigheter som krävs med kommandot az account set för att Azure Sphere-tillägget ska fungera korrekt. Mer information om val av prenumeration finns i Använda flera Azure-prenumerationer.

Hantera Azure Sphere-tillägget

Om du vill se de installerade versionerna av Azure CLI-tillägg använder du kommandot:

az version

Om du vill uppdatera Azure Sphere-tillägget till den senaste versionen använder du:

az extension update --name azure-sphere

Om du vill avinstallera Azure Sphere-tillägget använder du:

az extension remove --name azure-sphere

Vanliga Azure Sphere CLI-kommandon

Du kan använda Azure Sphere-kommandon genom att az sphere skriva från antingen Windows-kommandotolken eller PowerShell. I Linux kan du använda valfritt kommandoradsgränssnitt (CLI). CLI har en funktion för tabbifyllning för kommandon under Bash-gränssnittet.

Den här tabellen innehåller några vanliga Azure Sphere-kommandon och länkar till deras referensdokumentation.

Kommando	beskrivning
`az sphere catalog`	Hantera katalogen.
`az sphere ca-certificate`	Hantera certifikat i katalogen.
`az sphere deployment`	Hantera distributioner i katalogen.
`az sphere device`	Hantera Azure Sphere-enheter.
`az sphere device-group`	Hantera enhetsgrupper i katalogen.
`az sphere image`	Hantera avbildningar i katalogen.
`az sphere product`	Hantera produkter i katalogen.
`az sphere get-support-data`	Samla in diagnostikdata om system-, moln- och enhetskonfigurationer.

Med Azure CLI kan du konfigurera konfigurationsalternativ som förenklar användningen av Azure Sphere CLI-kommandon genom att ange standardvärden för parametrar som --resource-group, --subscriptioneller --catalog.

Enhetsberoende kommandon

Kommandot fungerar med en lokalt ansluten Azure Sphere-enhet. Om du försöker köra kommandot utan en ansluten enhet får du ett felmeddelande. Mer information om enhetskommandon finns i 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

Globalt tillgängliga argument

Följande globala parametrar är tillgängliga för Azure Sphere-tillägget:

Parameter	Description
`--debug`	Öka loggningsverositeten för att visa alla felsökningsloggar.
`--help -h`	Visar hjälpmeddelandet.
`--only-show-errors`	Visar bara fel och undertrycker varningar.
`--output` `-o`	Utdataformat. Tillåtna värden: `json`, `jsonc`, `none`, `table`, `tsv`, `yaml`, `yamlc`. Standard: `json`.
`--query`	JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
`--subscription`	: Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med .`az account set -s NAME_OR_ID`
`--verbose`	Öka loggningsverbositeten. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Dela via