Dela via

Migrera från klassisk CLI till Azure Sphere CLI

  • Artikel

Om du fortfarande använder azure sphere-klassiska CLI rekommenderar vi att du migrerar till nya Azure Sphere CLI. För närvarande kan båda versionerna av CLI installeras och användas sida vid sida, men den klassiska CLI uppdateras eller underhålls inte längre och kommer att tas bort från SDK vid ett senare tillfälle (inte före slutet av 2022). Vi uppmuntrar dig att bekanta dig med dessa skillnader och migrera dina processer och skript före slutet av 2022 för att undvika störningar.

Information om hur du uppdaterar till det senaste SDK:t finns i Installera Azure Sphere SDK på Linux eller Installera ett Azure Sphere SDK för Windows.

Om du vill använda Azure Sphere CLI i Windows använder du PowerShell eller en vanlig Windows-kommandotolk. För Linux använder du valfritt kommandogränssnitt. Mer information finns i Köra Azure Sphere CLI.

I Windows kan den gamla anpassade Azure Sphere Classic Developer Command Prompt (som finns som genväg på Start-menyn under Azure Sphere) endast användas med Azure Sphere-klassiska CLI. Mer information finns i Kör Azure Sphere klassiska CLI.

Viktiga skillnader

  • I Azure Sphere klassiska CLI kan flera parametrar användas för att identifiera varje objekttyp. I Azure Sphere CLI används en enskild parameter för att identifiera varje objekttyp. Det innebär att du kan använda antingen namnet eller ID:t för att ange parametervärdet. Detta har implementerats för parametrarna --device, --tenant, --productoch --device-group .

    Objekttyp Azure Sphere CLI Azure Sphere klassisk CLI (dras tillbaka)
    Enhet --device --deviceid, --deviceipeller --devicelocation
    Enhetsgrupp --device-group --devicegroupid Eller --devicegroupname
    Produkt --product --productid Eller --productname
    Hyresgästen --tenant --tenantid

  • Kort formulär för kommandon stöds i den klassiska versionen. I Azure Sphere CLI rekommenderar vi att du använder tabbslutfunktionen eller den interaktiva funktionen för att visa listan med tillgängliga kommandon. I det klassiska CLI kan du till exempel använda antingen azsphere device enable-development eller azsphere dev edv kommando, medan du i den nya Azure Sphere CLI kan använda Komplettera automatiskt för att snabbt skriva azsphere device enable-development kommandot.

  • Vissa kommandon tillåter flera värden för en enskild parameter. I Azure Sphere CLI kan du ange en enskild parameter följt av en lista med värden avgränsade med blanksteg och i azure sphere-klassiska CLI avgränsas listan med värden med kommatecken. Till exempel:

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

  • I det nya CLI väljs inte standardklientorganisationen automatiskt när en klientorganisation skapas. Du måste köra azsfärklientorganisationens valkommando för att välja den standardklientorganisation som ska användas för den aktuella användaren på datorn. Detta är för att säkerställa att standardklientorganisationen är rätt klientorganisation att använda när du utför en engångsåtgärd som du inte kan ångra, till exempel göra anspråk på enheten.

    När du använder skript kan du välja standardklientorganisationen med parametern --tenant <tenant ID or tenant name> .

    Ange standardklientorganisationen i början av skriptet med hjälp av:

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

    Du kan också skriva över standardklientorganisationen eller ange den klientorganisation som krävs när kommandot körs. Till exempel:

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

  • Parametern --device-group identifierar enhetsgruppen. Enhetsgrupp-ID tillhandahåller en GUID, som unikt identifierar enhetsgruppen för alla produkter. Du kan också använda namnparet för produktnamn och enhetsgrupp i <formatet produktnamn>/<enhet-grupp-namn> . Det här namnparet identifierar unikt en enhetsgrupp för en viss produkt.

  • Följande kommandon var sammansatta kommandon i den klassiska CLI. Det innebär att ett kommando har utfört flera uppgifter. I det nya CLI måste du köra de två kommandona.

    • I den klassiska distributionen av CLI skapades avbildningspaketet och en ny distribution skapades.

      I nya CLI måste du:

      1. Ladda upp avbildningspaketet till Azure Sphere-klienten med hjälp av azsfärbildtillägg.
      2. Skapa en ny distribution för en enhetsgrupp för uppladdade avbildningar med hjälp av distribution av azsfärenheter.

    • I den klassiska versionen av CLI laddas azsfärenhetens funktionsnedladdning ned – välj kommando nedladdat och tillfälligt valt enhetsfunktionskonfiguration för den anslutna enheten.

      I nya CLI måste du:

      1. Ladda ned funktionsfilen med hjälp av azsfärenhetens funktionsnedladdning.
      2. Välj funktionen genom att välja azsfärenhet.

    • I den klassiska versionen av CLI laddas azsfärenhetens funktionsnedladdning ned – kommandot Apply laddas ned och tillämpas på enhetens funktionskonfiguration för den anslutna enheten.

      I nya CLI måste du:

      1. Ladda ned funktionsfilen med hjälp av azsfärenhetens funktionsnedladdning.
      2. Använd funktionen med hjälp av azsfärenhetsfunktionsuppdatering.

  • I den klassiska CLI används parametern -o eller --output för att ange en sökväg och ett filnamn där en fil ska sparas. I nya Azure Sphere CLI används sammanhangsspecifika parametrar, till exempel --destination för att ange indata- och utdatasökvägar.

  • I den klassiska CLI -d--debug används eller parametern i startkommandot för azsfärenhetsappen för att starta programmet i felsökningsläge. I nya Azure Sphere CLI används parametern --debug-mode för att starta programmet i felsökningsläge och parametern --debug används som en global parameter för att öka utförligheten för loggning för att visa alla felsökningsloggar.

  • I det klassiska CLI finns det ingen kontroll över utdataformatet. I Azure Sphere CLI används parametern -o eller --output för att ange i vilket utdataformat CLI-utdata ska formateras.

  • Från version 21.02 och framåt har explicita versionsnummer tagits bort från produktnamnen för Azure Sphere CLI. Den här ändringen eliminerar förvirringen när du refererar till de olika versionerna av produkten.

    • Azure Sphere CLI v2 och senare kallas nu endast "Azure Sphere CLI".
    • Tidigare Versioner av Azure Sphere CLI (CLI v1 och lägre) kallas nu för "Azure Sphere classic CLI".

  • Om du använder skript kanske de inte är kompatibla med nya Azure Sphere CLI på grund av skillnaderna som beskrivs ovan. Gör nödvändiga uppdateringar för att skripten ska köras korrekt i nya CLI.

Se även