Přehled rozšíření Azure Sphere pro Azure CLI

Nástroj příkazového řádku pro správu připojených zařízení Azure Sphere a cloudových nasazení se distribuuje jako rozšíření Azure CLI.

Instalace Azure CLI a rozšíření Azure Sphere

Získání rozšíření Azure Sphere pro Azure CLI:

1. Pokud jste to ještě neudělali, nainstalujte Azure CLI.

2. Pokud chcete přidat rozšíření Azure Sphere, spusťte následující příkaz:

   az extension add --name azure-sphere
   

Abyste se mohli přihlásit k předplatnému Azure, které chcete použít ke správě zařízení Azure Sphere, musíte se přihlásit pomocí Azure CLI .

Po instalaci rozšíření se jeho umístění najde pod hodnotou $AZURE_EXTENSION_DIR proměnné prostředí. Pokud tato proměnná není nastavená, ve výchozím nastavení je $HOME/.azure/cliextensions hodnota v Linuxu a macOS a %USERPROFILE%\.azure\cliextensions ve Windows.

Tip

Po přihlášení se zobrazí seznam předplatných přidružených k vašemu účtu Azure. Ujistěte se, že jste vybrali předplatné s požadovanými oprávněními pomocí az account set příkazu, aby rozšíření Azure Sphere fungovalo správně. Další informace o výběru předplatného najdete v tématu Použití více předplatných Azure.

Správa rozšíření Azure Sphere

Pokud chcete zobrazit nainstalované verze rozšíření Azure CLI, použijte příkaz :

az version

Pokud chcete aktualizovat rozšíření Azure Sphere na nejnovější verzi, použijte:

az extension update --name azure-sphere

Pokud chcete odinstalovat rozšíření Azure Sphere, použijte:

az extension remove --name azure-sphere

Běžné příkazy rozhraní příkazového řádku Azure Sphere

Příkazy Azure Sphere můžete použít zadáním az sphere příkazu z příkazového řádku Windows nebo PowerShellu. V Linuxu můžete použít libovolné rozhraní příkazového řádku (CLI). Rozhraní příkazového řádku má úplné dokončování karet pro příkazy v prostředí Bash.

V této tabulce jsou uvedeny některé běžné příkazy Azure Sphere a odkazy na jejich referenční dokumentaci.

Příkaz	Popis
az sphere catalog	Spravujte katalog.
az sphere ca-certificate	Správa certifikátů v katalogu
az sphere deployment	Správa nasazení v katalogu
az sphere device	Správa zařízení Azure Sphere
az sphere device-group	Umožňuje spravovat skupiny zařízení v katalogu.
az sphere image	Správa obrázků v katalogu
az sphere product	Spravujte produkty v katalogu.
az sphere get-support-data	Shromážděte diagnostická data o konfiguraci systému, cloudu a zařízení.

Azure CLI umožňuje nastavit možnosti konfigurace , které zjednodušují používání příkazů rozhraní příkazového řádku Azure Sphere, a to poskytnutím výchozích hodnot pro parametry, jako jsou --resource-group, --subscriptionnebo --catalog.

Příkazy závislé na zařízení

Příkaz funguje s místně připojeným zařízením Azure Sphere. Pokud se pokusíte příkaz spustit bez připojeného zařízení, zobrazí se chyba. Další informace o příkazech zařízení najdete v tématu 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álně dostupné argumenty

Pro rozšíření Azure Sphere jsou k dispozici následující globální parametry:

Parametr	Popis
--debug	Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
--help -h	Zobrazí zprávu nápovědy.
--only-show-errors	Zobrazuje jenom chyby a potlačí upozornění.
--output -o	Výstupní formát. Povolené hodnoty: json, jsonc, none, table, tsv, , yaml, . yamlc Výchozí hodnota: json.
--query	Řetězec dotazu JMESPath Další informace a příklady najdete v tématu http://jmespath.org/ .
--subscription	: Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí příkazu az account set -s NAME_OR_ID.
--verbose	Zvyšte úroveň podrobností protokolování. Použijte --debug pro úplné protokoly ladění.