Sdílet prostřednictvím

Migrace z klasického rozhraní příkazového řádku na Azure Sphere CLI

  • Č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.

Pokud stále používáte Azure Sphere Classic CLI, doporučujeme migrovat na nové rozhraní příkazového řádku Azure Sphere. V současné době je možné nainstalovat a používat obě verze rozhraní příkazového řádku vedle sebe, ale klasické rozhraní příkazového řádku už není aktualizováno ani udržováno a v budoucnu bude ze sady SDK odebráno (nejdříve po konci roku 2022). Doporučujeme vám seznámit se s těmito rozdíly a migrovat procesy a skripty před koncem roku 2022, abyste se vyhnuli přerušení.

Pokud chcete provést aktualizaci na nejnovější sadu SDK, přečtěte si téma Instalace sady Azure Sphere SDK v systému Linux nebo Instalace sady Azure Sphere SDK pro Windows.

Pokud chcete použít Azure Sphere CLI ve Windows, použijte PowerShell nebo standardní příkazový řádek Windows. V systému Linux můžete použít libovolné prostředí příkazového řádku. Další informace najdete v tématu Spuštění Azure Sphere CLI.

V systému Windows se dá končící vlastní klasický příkazový řádek pro vývojáře Azure Sphere (k dispozici jako zástupce v nabídce Start v části Azure Sphere) používat pouze s klasickým rozhraním příkazového řádku Azure Sphere. Další informace najdete v tématu Spuštění klasického rozhraní příkazového řádku Azure Sphere.

Klíčové rozdíly

  • V Klasickém rozhraní příkazového řádku Azure Sphere je možné použít více parametrů k identifikaci jednotlivých typů objektů. V Rozhraní příkazového řádku Azure Sphere se k identifikaci jednotlivých typů objektů používá jeden parametr. To znamená, že k zadání hodnoty parametru můžete použít název nebo ID. Toto bylo implementováno pro --deviceparametry , --tenant, --producta --device-group parametry.

    Object type Azure Sphere CLI Klasické rozhraní příkazového řádku Azure Sphere (ukončované)
    Zařízení --device --deviceid, --deviceip nebo --devicelocation
    Skupina zařízení --device-group --devicegroupid nebo --devicegroupname
    Produkt --product --productid nebo --productname
    Tenant --tenant --tenantid

  • Krátký formulář pro příkazy je podporován v klasické verzi. V Rozhraní příkazového řádku Azure Sphere doporučujeme k zobrazení seznamu dostupných příkazů použít funkci Dokončování tabulátoru nebo interaktivní funkce. V klasickém rozhraní příkazového řádku můžete například použít příkaz azsphere device enable-development nebo azsphere dev edv příkaz, zatímco v novém rozhraní příkazového řádku Azure Sphere můžete k rychlému zadání azsphere device enable-development příkazu použít automatické dokončování.

  • 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

  • V novém rozhraní příkazového řádku se při vytvoření tenanta automaticky nevybere výchozí tenant. Pokud chcete vybrat výchozího tenanta pro aktuálního uživatele na počítači, musíte spustit příkaz azsphere tenant select . Tím zajistíte, že výchozí tenant je ten správný, který se má použít při jednorázové operaci, kterou nemůžete vrátit zpět, jako je deklarace zařízení.

    Při použití skriptů můžete pomocí parametru vybrat výchozího tenanta --tenant <tenant ID or tenant name> .

    Nastavte výchozího tenanta na začátku skriptu pomocí:

    azsphere tenant select --tenant <tenant ID or tenant name>

    Můžete také přepsat výchozího tenanta nebo určit požadovaného tenanta při spuštění příkazu. Příklad:

    azsphere get-support-data --destination logs.zip --tenant <tenant ID or tenant name>

  • Parametr --device-group identifikuje skupinu zařízení. ID skupiny zařízení poskytuje identifikátor GUID, který jednoznačně identifikuje skupinu zařízení ve všech produktech. Alternativně můžete použít dvojici název produktu a název skupiny zařízení ve <formátu product-name>/<device-group-name> . Tato dvojice názvů jednoznačně identifikuje skupinu zařízení pro konkrétní produkt.

  • Následující příkazy byly složené příkazy v klasickém rozhraní příkazového řádku. To znamená, že jeden příkaz provedl více úloh. V novém rozhraní příkazového řádku je potřeba spustit dva příkazy.

    • V klasickém rozhraní příkazového řádku příkaz azsphere device-group deployment create nahrál balíček image a vytvořil nové nasazení.

      V novém rozhraní příkazového řádku potřebujete:

      1. Nahrajte balíček image do tenanta Azure Sphere pomocí příkazu azsphere image add.
      2. Vytvořte nové nasazení pro skupinu zařízení pro nahrané image pomocí příkazu azsphere device-group deployment create.

    • V klasickém rozhraní příkazového řádku nástroj azsphere device capability download --select command downloaded and temporarily selected device capability configuration for the attached device.

      V novém rozhraní příkazového řádku potřebujete:

      1. Stáhněte si soubor schopností pomocí příkazu azsphere device capability download.
      2. Tuto možnost vyberte pomocí příkazu azsphere device capability select.

    • V klasickém rozhraní příkazového řádku nástroj azsphere device capability download --apply command downloaded and applied the device capability configuration for the attached device.

      V novém rozhraní příkazového řádku potřebujete:

      1. Stáhněte si soubor schopností pomocí příkazu azsphere device capability download.
      2. Tuto funkci můžete použít pomocí aktualizace funkcí zařízení azsphere.

  • V klasickém rozhraní příkazového řádku -o se používá k --output určení cesty a názvu souboru, do kterého chcete soubor uložit. V novém rozhraní příkazového řádku Azure Sphere se používají kontextové parametry, jako --destination je zadání vstupních a výstupních cest.

  • V klasickém rozhraní příkazového řádku -d se k spuštění aplikace zařízení azsphere používá příkaz nebo parametr ke spuštění aplikace v režimu --debug ladění. V novém rozhraní příkazového řádku --debug-mode Azure Sphere se tento parametr používá ke spuštění aplikace v režimu ladění a --debug tento parametr se používá jako globální parametr ke zvýšení podrobností protokolování, aby se zobrazily všechny protokoly ladění.

  • V klasickém rozhraní příkazového řádku neexistuje žádná kontrola nad výstupním formátem. V Rozhraní příkazového řádku Azure Sphere se tento parametr --output používá k určení výstupního formátu, -o ve kterém se má formátovat výstup rozhraní příkazového řádku.

  • Z verze 21.02 byly explicitní čísla verzí odebrána z názvů produktů Azure Sphere CLI. Tato změna eliminuje nejasnosti v odkazování na různé verze produktu.

    • Azure Sphere CLI v2 a novější se teď označují jenom jako Azure Sphere CLI.
    • Dřívější verze Rozhraní příkazového řádku Azure Sphere (CLI v1 a nižší) se teď označují jako Azure Sphere Classic CLI.

  • Pokud používáte skripty, nemusí být kompatibilní s novým rozhraním příkazového řádku Azure Sphere kvůli výše popsaným rozdílům. Proveďte požadované aktualizace skriptů, aby se správně spouštěly v novém rozhraní příkazového řádku.

Viz také