Sdílet prostřednictvím

Přehled rozhraní příkazového řádku Azure Sphere

  • Článek

Důležité

Toto je dokumentace k Azure Sphere (starší verze). Azure Sphere (starší verze) se vyřazuje 27. září 2027 a uživatelé musí do této doby migrovat do Azure Sphere (integrované). K zobrazení dokumentace k Azure Sphere (integrované) použijte selektor verzí umístěný nad obsahem.

Azure Sphere CLI je sada příkazů, které slouží ke správě prostředků Azure Sphere.

K dispozici jsou následující příkazy:

Poznámka:

Příkaz register-user je teď zastaralý.

Azure Sphere CLI a Azure Sphere Classic CLI

Rozhraní příkazového řádku Azure Sphere je nainstalované společně s existujícím rozhraním příkazového řádku ve Windows i Linuxu, takže máte přístup k oběma rozhraním. Klasické rozhraní příkazového řádku Azure Sphere funguje i nadále, jak je vždy k dispozici.

Použití Rozhraní příkazového řádku Azure Sphere:

  • Ve Windows použijte PowerShell nebo standardní příkazový řádek windows.
  • V Linuxu použijte libovolné příkazové prostředí. Pokud během instalace sady SDK nastavíte rozhraní příkazového řádku Azure Sphere jako výchozí, zadejte příkaz azsphere nebo příkaz azsphere_v2 , pokud jako výchozí nastavíte Azure Sphere Classic CLI.

Podrobnosti o funkcích a příkazech podporovaných rozhraním příkazového řádku Azure Sphere najdete v rozhraní příkazového řádku Azure Sphere.

Důležité

  • Ve Windows je možné zástupce příkazového řádku Azure Sphere Classic pro vývojáře vyřazuje z provozu jenom s klasickým rozhraním příkazového řádku Azure Sphere.

Formát příkazového řádku

Příkazový řádek azsphere má následující formát:

azsphere [command] [subcommand] operation [parameters]

Obecně platí, že příkazy a podpříkazy jsou podstatná jména a operace jsou sloveso, takže kombinace identifikuje akci i objekt akce. Většina příkazů a operací má celé jméno i zkratku. Příkaz zařízení je například zkrácený d.

Většina parametrů má dlouhý název i zkratku. Na příkazovém řádku zaveďte dlouhý název se dvěma spojovníky a zkratkou s jedním spojovníkem. Například následující dva příkazy jsou ekvivalentní:

azsphere device wifi add --ssid MyNetwork --psk mynetworkkey

azsphere device wifi add -s MyNetwork -p mynetworkkey

Některé příkazy umožňují pro jeden parametr více hodnot. V Rozhraní příkazového řádku Azure Sphere můžete zadat jeden parametr následovaný seznamem hodnot oddělených mezerami a v klasickém rozhraní příkazového řádku Azure Sphere je seznam hodnot oddělený čárkami. Příklad:

azsphere image-package pack-application --package-directory myDirectory --destination myImagePackage --executables filepath-1 filepath-2

Uvozovky a řídicí znaky

Při práci s příkazy Rozhraní příkazového řádku Azure Sphere mějte na paměti, jak vaše prostředí používá uvozovky a řídicí znaky. Pokud podporujete skripty používané v různých prostředích, musíte pochopit, jak se liší.

Příklad:

Příkazy závislé na cloudu

Následující příkazy azsphere vyžadují cloudové připojení a přihlaste se ke službě zabezpečení Azure Sphere:

  • ca-certificate
  • skupina zařízení
  • get-support-data
  • image
  • Přihlásit
  • logout
  • product
  • role
  • show-user
  • klient

Kromě toho následující příkazy azsphere device také vyžadují cloudové připojení:

azsphere device command Komentáře
schopnost Vyžaduje službu zabezpečení Azure Sphere ke stažení funkcí zařízení.
tvrzení
enable-cloud-test
enable-development
image
list
zotavit se Vyžaduje připojení k internetu, ale nepřihlašuje se ke službě zabezpečení Azure Sphere.
ukázat
show-count
show-deployment-status
show-os-version Vyžaduje připojení k internetu, ale nepřihlašuje se ke službě zabezpečení Azure Sphere.
update

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

Následující příkazy azsphere device vyžadují použití funkce zařízení pro zařízení ve stavu výroby DeviceComplete:

Operation Popis
Aplikace Správa aplikací na připojeném zařízení
schopnost Správa konfigurací funkcí zařízení Vyžaduje se pro aktualizaci funkcí.
certifikát Správa úložiště certifikátů zařízení
image Správa imagí zařízení
výrobní stát Správa stavu výroby připojených zařízení Vyžaduje se pro aktualizaci výrobního stavu.
restart Restartujte připojené zařízení.
show-deployment-status Zobrazí stav nasazení operačního systému a aplikací na připojeném zařízení.
show-os-version Zobrazte verzi operačního systému na připojeném zařízení.
zkušební načtení Nasaďte a spravujte aplikace na připojeném zařízení. Vyžaduje se pro odstranění zkušebního načtení a odstranění zkušebního načtení.
Wi-Fi Umožňuje spravovat konfigurace Wi-Fi pro připojené zařízení.

Pokud se pokusíte tyto příkazy spustit bez možnosti, zobrazí se chybová zpráva s oznámením, že azsphere device enable-development chcete spustit nebo použít azsphere device capability ke stažení a výběru souboru schopností pro zařízení.