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

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

Installera Azure CLI och Azure Sphere-tillägget

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

1. Installera Azure CLI om du ännu inte har gjort det.

2. 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 variabeln $AZURE_EXTENSION_DIR skal. Om den här variabeln tas bort är $HOME/.azure/cliextensions värdet som standard på Linux och macOS och %USERPROFILE%\.azure\cliextensions i Windows.

Tips

När du har loggat in visas en lista över prenumerationer som är kopplade till ditt Azure-konto. Se till att du väljer prenumerationen med de behörigheter som krävs med az account set kommandot 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

Common Azure Sphere CLI-kommandon

Du kan använda Azure Sphere-kommandon genom att az sphere skriva från antingen Windows kommandotolk eller PowerShell. På Linux kan du använda valfritt kommandoradsgränssnitt (CLI). CLI har fullständig tab-avslutning 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.

Kommandot	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 bilder 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 standardinställningar för parametrar som --resource-group, --subscriptioneller --catalog.

Enhetsberoende kommandon

Kommandot fungerar med en lokalt ansluten Azure Sphere-enhet. Om du försöker använda 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:

Parametern	Beskrivning
--debug	Öka utförligheten för loggning för att visa alla felsökningsloggar.
--help -h	Visar hjälpmeddelandet.
--only-show-errors	Visar bara fel och ignorerar 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.
--subscription	: Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID
--verbose	Öka utförligheten för loggning. Används --debug för fullständiga felsökningsloggar.