Share via

Migreren van klassieke CLI naar Azure Sphere CLI

  • Artikel

Als u nog steeds de klassieke Cli van Azure Sphere gebruikt, raden we u aan te migreren naar de nieuwe Azure Sphere CLI. Momenteel kunnen beide versies van de CLI naast elkaar worden geïnstalleerd en gebruikt, maar de klassieke CLI wordt niet meer bijgewerkt of onderhouden en wordt op een toekomstige datum (niet vóór eind 2022) uit de SDK verwijderd. We raden u aan om vertrouwd te raken met deze verschillen en uw processen en scripts vóór eind 2022 te migreren om onderbrekingen te voorkomen.

Als u wilt bijwerken naar de nieuwste SDK, raadpleegt u De Azure Sphere SDK installeren op Linux of Een Azure Sphere SDK voor Windows installeren.

Als u Azure Sphere CLI in Windows wilt gebruiken, gebruikt u PowerShell of een standaard Windows-opdrachtprompt. Voor Linux gebruikt u een willekeurige opdrachtshell. Zie Azure Sphere CLI uitvoeren voor meer informatie.

In Windows kan de buiten gebruik gesteld aangepaste opdrachtprompt voor klassieke Azure Sphere-ontwikkelaars (beschikbaar als snelkoppeling in het startmenu onder Azure Sphere) alleen worden gebruikt met de klassieke Azure Sphere-CLI. Zie Klassieke Cli van Azure Sphere uitvoeren voor meer informatie.

Belangrijkste verschillen

  • In de klassieke Azure Sphere-CLI kunnen meerdere parameters worden gebruikt om elk objecttype te identificeren. In Azure Sphere CLI wordt één parameter gebruikt om elk objecttype te identificeren. Dit betekent dat u de naam of id kunt gebruiken om de parameterwaarde op te geven. Dit is geïmplementeerd voor de --deviceparameters , --tenant, --producten --device-group .

    Objecttype Azure Sphere CLI Klassieke Azure Sphere CLI (wordt buiten gebruik gesteld)
    Apparaat --device --deviceid, --deviceipof --devicelocation
    Apparaatgroep --device-group --devicegroupid Of --devicegroupname
    Product --product --productid Of --productname
    Huurder --tenant --tenantid

  • Korte vorm voor opdrachten wordt ondersteund in de klassieke versie. In Azure Sphere CLI raden we u aan de functie Tab-voltooiing of interactieve functie te gebruiken om de lijst met beschikbare opdrachten weer te geven. In de klassieke CLI kunt u bijvoorbeeld de opdracht of azsphere dev edv gebruikenazsphere device enable-development, terwijl u in de nieuwe Azure Sphere CLI automatisch aanvullen kunt gebruiken om de azsphere device enable-development opdracht snel te typen.

  • Sommige opdrachten staan meerdere waarden toe voor één parameter. In Azure Sphere CLI kunt u één parameter opgeven, gevolgd door een lijst met waarden gescheiden door spaties en in de klassieke Azure Sphere-CLI wordt de lijst met waarden gescheiden door komma's. Bijvoorbeeld:

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

  • In de nieuwe CLI wordt de standaardtenant niet automatisch geselecteerd wanneer een tenant wordt gemaakt. U moet de opdracht azsphere tenant select uitvoeren om de standaardtenant te selecteren die moet worden gebruikt voor de huidige gebruiker op de pc. Dit is om ervoor te zorgen dat de standaardtenant de juiste tenant is om te gebruiken bij het uitvoeren van een eenmalige bewerking die u niet ongedaan kunt maken, zoals het claimen van het apparaat.

    Wanneer u scripts gebruikt, kunt u de standaardtenant selecteren met behulp van de --tenant <tenant ID or tenant name> parameter.

    Stel de standaardtenant aan het begin van het script in met behulp van:

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

    U kunt ook de standaardtenant overschrijven of de vereiste tenant opgeven bij het uitvoeren van de opdracht. Bijvoorbeeld:

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

  • De --device-group parameter identificeert de apparaatgroep. De id van de apparaatgroep levert een GUID, waarmee de apparaatgroep in alle producten uniek wordt geïdentificeerd. U kunt ook de productnaam en het naampaar van de apparaatgroep gebruiken in de <indeling product-naam>/<apparaatgroep-naam> . Dit paar namen identificeert op unieke wijze een apparaatgroep voor een bepaald product.

  • De volgende opdrachten waren samengestelde opdrachten in de klassieke CLI. Dit betekent dat één opdracht meerdere taken heeft uitgevoerd. In de nieuwe CLI moet u de twee opdrachten uitvoeren.

    • In de klassieke CLI heeft de opdracht azsphere device-group deployment create het installatiekopieënpakket geüpload en een nieuwe implementatie gemaakt.

      In de nieuwe CLI moet u het volgende doen:

      1. Upload het installatiekopieënpakket naar uw Azure Sphere-tenant met behulp van azsphere image add.
      2. Maak een nieuwe implementatie voor een apparaatgroep voor de geüploade installatiekopieën met behulp van azsphere device-group deployment create.

    • In de klassieke CLI de azsphere device capability download --select opdracht gedownload en tijdelijk geselecteerde apparaatmogelijkheid configuratie voor het gekoppelde apparaat.

      In de nieuwe CLI moet u het volgende doen:

      1. Download het mogelijkheidsbestand met behulp van azsphere device capability download.
      2. Selecteer de mogelijkheid met behulp van azsphere device capability select.

    • In de klassieke CLI is de opdracht azsphere device capability download --apply gedownload en de configuratie van de apparaatmogelijkheid voor het gekoppelde apparaat toegepast.

      In de nieuwe CLI moet u het volgende doen:

      1. Download het mogelijkheidsbestand met behulp van azsphere device capability download.
      2. Pas de mogelijkheid toe met behulp van azsphere device capability update.

  • In de klassieke CLI wordt de -o parameter of --output gebruikt om een pad en bestandsnaam op te geven waarop een bestand moet worden opgeslagen. In de nieuwe Azure Sphere CLI worden contextspecifieke parameters gebruikt, bijvoorbeeld --destination om invoer- en uitvoerpaden op te geven.

  • In de klassieke CLI wordt de -d parameter of --debug gebruikt in de opdracht azsphere device app start om de toepassing te starten in de foutopsporingsmodus. In de nieuwe Azure Sphere CLI wordt de --debug-mode parameter gebruikt om de toepassing in de foutopsporingsmodus te starten en wordt de --debug parameter gebruikt als een globale parameter om de uitgebreidheid van logboekregistratie te vergroten om alle foutopsporingslogboeken weer te geven.

  • In de klassieke CLI is er geen controle over de uitvoerindeling. In Azure Sphere CLI wordt de -o parameter of --output gebruikt om de uitvoerindeling op te geven waarin de CLI-uitvoer moet worden opgemaakt.

  • Vanaf versie 21.02 zijn expliciete versienummers verwijderd uit de Azure Sphere CLI-productnamen. Deze wijziging elimineert verwarring bij het verwijzen naar de verschillende versies van het product.

    • Azure Sphere CLI v2 en hoger worden nu alleen 'Azure Sphere CLI' genoemd.
    • Eerdere Azure Sphere CLI-versies (CLI v1 en lager) worden nu 'klassieke Azure Sphere CLI' genoemd.

  • Als u scripts gebruikt, zijn deze mogelijk niet compatibel met de nieuwe Azure Sphere CLI vanwege de hierboven beschreven verschillen. Breng de vereiste updates aan om de scripts correct uit te voeren in de nieuwe CLI.

Zie ook