Interaktiver Azure Sphere CLI-Modus (Vorschau)

Artikel
09/27/2024

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.

Azure Sphere CLI unterstützt den interaktiven Modus, der eine interaktive Umgebung zum Ausführen von Azure Sphere CLI-Befehlen bietet, die ideal für neue Benutzer geeignet sind, die Funktionen, Befehlsstrukturen und Ausgabeformate der CLI zu erlernen. Sie können den interaktiven Modus mit dem interaktiven Azsphere-Befehl in einer Befehlszeilenschnittstelle mit PowerShell, Windows-Eingabeaufforderung oder Bash-Shell starten. Die Eingabeaufforderung ändert sich, azsphere>> um anzugeben, dass Sie jetzt Befehle in der interaktiven Shell ausführen.

Interaktiver Azure Sphere-Modus

Wichtig

Dieses Feature befindet sich in der Vorschau. Sie kann in einem zukünftigen Release geändert oder entfernt werden.

Konfigurieren

Im interaktiven Modus werden optional Beschreibungen zu Befehlen und Parametern sowie Befehlsbeispiele angezeigt.

Option	Beschreibung
F1	Aktiviert oder deaktiviert Beschreibungen und Beispiele.
F2	Aktiviert oder deaktiviert die Anzeige von Parameterstandardeinstellungen.
F3	Schaltet die Anzeige einiger Tastengesten um.
[STRG+D]	Beendet den interaktiven Modus.

Interaktiver Azure Sphere-Modus F1

Mengenbereich

Im interaktiven Modus können Sie Befehle auf eine bestimmte Gruppe von Befehlen anwenden. Wenn Sie nur mit device certificate Befehlen arbeiten möchten, können Sie folgendes verwenden, um den richtigen Bereich festzulegen, damit Sie nicht mit allen nachfolgenden Befehlen eingeben device certificate müssen.

Wenn Sie z. B. den Bereich auf Folgendes %%device certificatefestlegen:

azsphere>> %%device certificate
defaulting: device
defaulting: certificate
azsphere device certificate>>

Um die Bereichseingabe $ %% .. zu entfernen und alle Bereichsdefinitionseingaben zu entfernen, %%

Beispiele

Im interaktiven Modus werden Beispiele für einige Befehle kontextbezogen aufgeführt, während Sie die Befehle eingeben. Wenn der Befehl zu viele Beispiele enthält, die in das Terminalfenster passen, können Sie alle Beispiele durchblättern, indem Sie durch den Beispielbereich mit STRG+Y und STRG+N für "nach oben" bzw. "unten" scrollen.

Der interaktive Modus bietet mehrere Möglichkeiten zum Erstellen und Ausführen des Befehls. Die Beispielnummer wird im Beispielbereich angegeben. Sie können einen bestimmten auswählen, der im Beispielbereich angezeigt werden soll. Zum Beispiel:

Interaktiver Azure Sphere-Modus: mehrere Möglichkeiten

Automatische Vervollständigung

Im interaktiven Modus wird das Ergebnis für den eingegebenen Befehl angezeigt. Es stellt ein Dropdown-Listenfeld für autoVervollständigen, automatisch zwischengespeicherte Vorschläge und dynamische Dokumentation bereit, einschließlich Beispiele für die Verwendung der einzelnen Befehle. Der Abschluss des Parameterwerts wird für die --application-updateParameter , --debug-mode, , --device, --device-group, --enable-rt-core-debugging, --full--force, --product--none--role--state--style--os-feed--manual-start--temporary--tenant--targeted-scan--typeund --user Parameter unterstützt.

Interaktiver Azure Sphere-Modus: AutoVervollständigen

Häufig verwendete Befehle

Der interaktive Modus verfolgt zuvor eingegebene Befehle und die am häufigsten verwendeten Befehle. Der Befehl wird angezeigt, wenn die Anfangszeichen in die Eingabeaufforderungsschnittstelle eingegeben werden.

Exitcode

Mit $ der Option können Sie den Beendigungscode des letzten ausgeführten Befehls anzeigen, um zu überprüfen, ob er ordnungsgemäß ausgeführt wurde. Zum Beispiel:

azsphere>> $
Success: 0

Befehle außerhalb des interaktiven Modus

Der interaktive Azure Sphere CLI-Modus ermöglicht es einem Benutzer, Befehle außerhalb der Azure Sphere CLI auszuführen, ohne den interaktiven Modus mithilfe #[command] der Befehlszeilenschnittstelle zu beenden. Zum Beispiel:

azsphere>> #git --version
git version 2.28.0.windows.1

Vorheriger Befehl 'Abfrage'

Sie können eine JMESPath-Abfrage für die Ergebnisse des letzten Befehls ausführen, den Sie ausgeführt haben, ?? indem Sie eine JMESPath-Abfrage verwenden. Beispielsweise können Sie nach dem Auflisten aller Produkte die Abfrage ausführen, um nur die Produktnamen aufzulisten.

azsphere>> azsphere product list
 ------------------------------------ ------------------------------------ --------------- --------------------
 Id                                   TenantId                             Name            Description
 ==============================================================================================================
 a2cd64be-adc2-4bfd-8f34-7d8c90293893 143adbc9-1bf0-4be2-84a2-084a331d81cb MyFridgeProduct None
 ------------------------------------ ------------------------------------ --------------- --------------------
 e5fe65f7-0df5-481e-9f4c-44b1a00d2d60 143adbc9-1bf0-4be2-84a2-084a331d81cb CoffeeMaker     None
 ------------------------------------ ------------------------------------ --------------- --------------------

Die Ausgabe für die jmespath-Abfrage lautet:

azsphere>> ??"[].{Productname:name}"
[
  {
    "Productname": "MyFridgeProduct"
  },
  {
    "Productname": "CoffeeMaker"
  }
]

Teilen über