Teilen über

Migrieren von der klassischen CLI zur Azure Sphere-CLI

  • Artikel

Wichtig

Dies ist die Dokumentation zu Azure Sphere (Legacy). Azure Sphere (Legacy) wird am 27. September 2027 eingestellt, und Benutzer müssen bis zu diesem Zeitpunkt zu Azure Sphere (integriert) migrieren. Verwenden Sie die Versionsauswahl oberhalb des Inhaltsverzeichniss, um die Dokumentation zu Azure Sphere (Integriert) anzuzeigen.

Wenn Sie weiterhin die klassische Azure Sphere CLI verwenden, empfehlen wir, zur neuen Azure Sphere CLI zu migrieren. Derzeit können beide Versionen der CLI installiert und nebeneinander verwendet werden, aber die klassische CLI wird nicht mehr aktualisiert oder gewartet und wird zu einem zukünftigen Datum (nicht vor Ende 2022) aus dem SDK entfernt. Wir empfehlen Ihnen, sich mit diesen Unterschieden vertraut zu machen und Ihre Prozesse und Skripts vor Ende 2022 zu migrieren, um Unterbrechungen zu vermeiden.

Informationen zur Aktualisierung auf das neueste SDK finden Sie unter Installieren des Azure Sphere SDK unter Linux bzw. Installieren eines Azure Sphere SDK für Windows.

Um Azure Sphere CLI unter Windows zu verwenden, verwenden Sie PowerShell oder eine windows-Standard-Eingabeaufforderung. Verwenden Sie für Linux eine beliebige Befehlsshell. Weitere Informationen finden Sie unter Azure Sphere CLI ausführen.

Unter Windows kann die bald eingestellte benutzerdefinierte Azure Sphere Classic Developer Command Prompt (verfügbar als Verknüpfung im Startmenü unter Azure Sphere) nur mit der klassischen Azure Sphere-CLI verwendet werden. Weitere Informationen finden Sie unter Klassische Azure Sphere CLI ausführen.

Wesentliche Unterschiede

  • In der klassischen Azure Sphere CLI können mehrere Parameter verwendet werden, um jeden Objekttyp zu identifizieren. In Azure Sphere CLI wird ein einzelner Parameter verwendet, um jeden Objekttyp zu identifizieren. Dies bedeutet, dass Sie entweder den Namen oder die ID verwenden können, um den Parameterwert anzugeben. Dies wurde für die --deviceParameter , , --tenantund --product--device-group dies implementiert.

    Objekttyp Azure Sphere-CLI Klassische Azure Sphere-CLI (wird eingestellt)
    Sicherungsmedium --device --deviceid, --deviceipoder --devicelocation
    Gerätegruppe --device-group --devicegroupid oder --devicegroupname
    Produkt --product --productid oder --productname
    Mandant --tenant --tenantid

  • Kurzform für Befehle wird in der klassischen Version unterstützt. In Azure Sphere CLI empfehlen wir, die Registerkartenabschluss- oder interaktive Funktion zu verwenden, um die Liste der verfügbaren Befehle anzuzeigen. In der klassischen CLI können Sie z. B. einen befehl azsphere device enable-development verwenden azsphere dev edv , während Sie in der neuen Azure Sphere CLI autoVervollständigen verwenden können, um den azsphere device enable-development Befehl schnell einzugeben.

  • Einige Befehle ermöglichen mehrere Werte für einen einzelnen Parameter. In Azure Sphere CLI können Sie einen einzelnen Parameter gefolgt von einer Liste von Werten angeben, die durch Leerzeichen getrennt sind, und in der klassischen Azure Sphere CLI werden die Werteliste durch Kommas getrennt. Zum Beispiel:

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

  • In der neuen CLI wird der Standardmandant nicht automatisch ausgewählt, wenn ein Mandant erstellt wird. Sie müssen den Befehl "azsphere tenant select " ausführen, um den Standardmandanten auszuwählen, der für den aktuellen Benutzer auf dem PC verwendet werden soll. Dadurch wird sichergestellt, dass der Standardmandant der richtige ist, der beim Ausführen eines einmaligen Vorgangs verwendet werden kann, der nicht wie der Anspruch auf das Gerät rückgängig gemacht werden kann.

    Wenn Sie Skripts verwenden, können Sie den Standardmandanten mit dem --tenant <tenant ID or tenant name> Parameter auswählen.

    Legen Sie den Standardmandanten am Anfang des Skripts fest, indem Sie Folgendes verwenden:

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

    Sie können den Standardmandanten auch überschreiben oder den erforderlichen Mandanten angeben, wenn Sie den Befehl ausführen. Zum Beispiel:

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

  • Der --device-group Parameter identifiziert die Gerätegruppe. Die Gerätegruppen-ID stellt eine GUID bereit, die die Gerätegruppe für alle Produkte eindeutig identifiziert. Alternativ können Sie das Produktnamen- und Gerätegruppennamenpaar im <Produktnamen>-/<Gerätegruppennamenformat> verwenden. Durch diese Namenskombination wird eine Gerätegruppe für ein bestimmtes Produkt eindeutig identifiziert.

  • Die folgenden Befehle waren zusammengesetzte Befehle in der klassischen CLI. Dies bedeutet, dass ein Befehl mehrere Aufgaben ausgeführt hat. In der neuen CLI müssen Sie die beiden Befehle ausführen.

    • In der klassischen CLI hat die Azsphere Device-Group-Bereitstellung den Befehl zum Hochladen des Imagepakets hochgeladen und eine neue Bereitstellung erstellt.

      In der neuen CLI müssen Sie:

      1. Laden Sie das Bildpaket in Ihren Azure Sphere-Mandanten hoch, indem Sie azsphere image add verwenden.
      2. Erstellen Sie eine neue Bereitstellung für eine Gerätegruppe für die hochgeladenen Images mithilfe der Azsphere-Gerätegruppenbereitstellung.

    • In der klassischen CLI laden Sie den Azsphere-Gerätefunktions-Download --Select-Befehl heruntergeladen und vorübergehend ausgewählte Gerätefunktionskonfiguration für das angeschlossene Gerät.

      In der neuen CLI müssen Sie:

      1. Laden Sie die Funktionsdatei mithilfe des Azsphere-Gerätefunktionsdownloads herunter.
      2. Wählen Sie die Funktion mithilfe der Azsphere-Gerätefunktion aus.

    • In der klassischen CLI laden Sie den Azsphere Device Capability Download --apply-Befehl heruntergeladen und angewendet die Gerätefunktionskonfiguration für das angeschlossene Gerät.

      In der neuen CLI müssen Sie:

      1. Laden Sie die Funktionsdatei mithilfe des Azsphere-Gerätefunktionsdownloads herunter.
      2. Wenden Sie die Funktion mithilfe des Azsphere-Gerätefunktionsupdates an.

  • In der klassischen CLI wird der -o --output Oder-Parameter verwendet, um einen Pfad und Dateinamen anzugeben, unter dem eine Datei gespeichert werden soll. In der neuen Azure Sphere CLI werden kontextspezifische Parameter verwendet, z --destination . B. zum Angeben von Eingabe- und Ausgabepfaden.

  • In der klassischen CLI wird der -d Startbefehl --debug der Azsphere-Geräte-App verwendet, um die Anwendung im Debugmodus zu starten. In der neuen Azure Sphere CLI wird der --debug-mode Parameter verwendet, um die Anwendung im Debugmodus zu starten, und der --debug Parameter wird als globaler Parameter verwendet, um die Ausführlichkeit der Protokollierung zu erhöhen, um alle Debugprotokolle anzuzeigen.

  • In der klassischen CLI gibt es keine Kontrolle über das Ausgabeformat. In Azure Sphere CLI wird der -o Parameter verwendet --output , um das Ausgabeformat anzugeben, in dem die CLI-Ausgabe formatiert werden soll.

  • Ab Version 21.02 wurden explizite Versionsnummern aus den Azure Sphere CLI-Produktnamen entfernt. Diese Änderung beseitigt Verwirrung bei der Bezugnahme auf die verschiedenen Versionen des Produkts.

    • Azure Sphere CLI v2 und höher werden jetzt nur als "Azure Sphere CLI" bezeichnet.
    • Frühere Azure Sphere CLI-Versionen (CLI v1 und niedriger) werden jetzt als "Klassische Azure Sphere CLI" bezeichnet.

  • Wenn Sie Skripts verwenden, sind sie aufgrund der oben erläuterten Unterschiede möglicherweise nicht mit der neuen Azure Sphere CLI kompatibel. Nehmen Sie erforderliche Updates vor, damit die Skripts in der neuen CLI ordnungsgemäß ausgeführt werden.

Siehe auch