Gerät

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.

Verwaltet Azure Sphere-Geräte.

Vorgang	Beschreibung
app	Ändert den Status von Anwendungen auf einem Gerät.
capability	Verwaltet Gerätefunktionen.
Zertifikat	Verwaltet den Gerätezertifikatspeicher.
claim	Beansprucht ein zuvor nicht beanspruchtes Gerät für den Azure Sphere-Mandanten.
enable-cloud-test	Richtet ein Gerät ein, um das Debuggen zu deaktivieren und Updates zu empfangen.
enable-development	Richtet ein Gerät für das lokale Debuggen ein.
Abbildung	Verwaltet Bilder für ein Gerät.
list	Zeigt alle Geräte im Mandanten an.
list-attached	Listet die angeschlossenen Geräte auf.
Fertigungszustand	Verwaltet den Fertigungszustand des angeschlossenen Geräts.
network	Stellt Informationen zum Status der Netzwerkschnittstellen auf dem Gerät bereit.
recover	Verwendet speziellen Wiederherstellungsmodus, um neue Firmware auf das Gerät zu laden.
rescan-attached	Überprüft angeschlossene Geräte als Problembehandlungshilfe (nur Windows).
restart	Startet das angeschlossene Gerät neu.
show	Zeigt Details zur Updatekonfiguration des Geräts an.
show-attached	Zeigt Details zum angeschlossenen Gerät vom Gerät selbst an.
show-count	Zeigt die Gesamtzahl der Geräte in einem Mandanten an.
show-deployment-status	Zeigt den Status des neuesten Bereitstellungsupdates an.
show-os-version	Zeigt die Betriebssystemversion des lokalen Geräts an.
Querladen	Lädt ein Bild auf das angeschlossene Gerät.
Aktualisierung	Aktualisiert ein Gerät, indem es in einer bestimmten Gerätegruppe platziert wird.
wifi	Verwaltet die WLAN-Konfiguration für das Gerät.

app

Verwaltet Anwendungen auf dem Gerät.

Viele der App-Optionen erfordern die AppDevelopment-Funktion, die mit azsphere Device Enable-Development erworben werden kann. Um eine SDK-signierte Anwendung oder eine für die Produktion signierte Anwendung starten, beenden oder debuggen zu können, muss das Gerät über die Funktion appDevelopment verfügen.

Sie können azsphere device stop verwenden und azsphere device app start to restart a running real-timefähigen application to determine which real-time core it is running on.

Vorgang	Beschreibung
show-memory-stats	Zeigt die Speicherstatistiken für Anwendungen auf dem angeschlossenen Gerät an.
show-quota	Zeigt die Speichermenge an, die von der aktuellen Anwendung auf dem Gerät genutzt wird.
show-status	Gibt den Status der aktuellen Anwendung auf dem Gerät zurück.
start	Startet die Anwendung, die auf das Gerät geladen wird.
stop	Beendet die Anwendung, die auf dem Gerät ausgeführt wird.

app show-memory-stats

Zeigt die Speicherstatistiken für Anwendungen auf dem angeschlossenen Gerät an. Dieser Befehl ist nur verfügbar, wenn die AppDevelopment-Gerätefunktion konfiguriert ist. Zusätzliche Informationen werden angezeigt, wenn die Speicherzuweisungsnachverfolgung im Heap konfiguriert ist.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device app show-memory-stats
 -------------- -------------
 Name           Usage (bytes)
 ============================
 Total          434176
 User Mode      147456
 Peak User Mode 147456
 -------------- -------------

app show-quota

Zeigt die Menge an veränderlichem Speicher an, die auf dem angefügten Gerät zugeteilt ist und verwendet wird.

Sie legen das veränderbare Speicherkontingent im Anwendungsmanifest fest, und das Azure Sphere-Betriebssystem erzwingt Kontingente, wenn es Sektoren für die Datei zuweist. Wenn Sie den Wert MutableStorage verringern, ändert sich die Menge an Speicher daher nicht, aber der gemeldete zugeteilte Wert unterscheidet sich. Wenn die Anwendung beispielsweise bereits 16 KB verwendet hat und Sie den MutableStorage Wert auf 8 KB ändern, meldet der Befehl, dass die Anwendung 16 KB von 8 KB zugeordnet verwendet. Die Daten verbleiben auf dem Gerät.

Optionale Parameter

Parameter	Typ	Beschreibung
-i, --component-id	GUID	Gibt die ID der Komponente an, für die Kontingentinformationen abgerufen werden sollen. Wenn nicht angegeben, werden Kontingentinformationen für alle Komponenten angezeigt.
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device app show-quota
ae4714aa-03aa-492b-9663-962f966a9cc3: 0KB out of 8KB of mutable storage used.

app show-status

Zeigt den aktuellen Status der Anwendungen auf dem Gerät an.

Optionale Parameter

Parameter	Typ	Beschreibung
-i, --component-id	GUID	Gibt die ID der Komponente an, deren Status angezeigt werden soll. Wenn diese Angabe nicht erfolgt, wird der Status aller Komponenten angezeigt.
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device app show-status
9ce57001-90eb-45e1-bd0a-4fc07b0c85c9
App state: running

app start

Startet Anwendungen auf dem Gerät.

Optionale Parameter

Parameter	Typ	Beschreibung
--debug-mode	Boolean	Startet die Anwendung für das Debuggen. Dies `--component-id` muss bereitgestellt werden.
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.
-i, --component-id	GUID	Gibt die ID der zu startenden Komponente an. Wenn diese Angabe nicht erfolgt, werden alle Anwendungen gestartet.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device app start
836cbcf1-0b4d-45ab-963a-eadcd5017b6a
App state: running
Core     : High-level

app stop

Beendet die Anwendungen auf dem Gerät.

Optionale Parameter

Parameter	Typ	Beschreibung
-i, --component-id	GUID	Gibt die ID der zu beendenden Komponente an. Wenn diese Angabe nicht erfolgt, werden alle Anwendungen beendet.
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device app stop
836cbcf1-0b4d-45ab-963a-eadcd5017b6a
App state: stopped

capability

Verwaltet Gerätefunktionen. Anhand der Gerätefunktionen werden die Vorgänge bestimmt, die auf einem einzelnen Azure Sphere-Gerät durchgeführt werden können.

Die Gerätefunktionen werden als Datei aus dem Azure Sphere Security Service mithilfe des Downloadbefehls der Azsphere-Gerätefunktion heruntergeladen. Sie können die Gerätefunktionskonfiguration auf das angefügte Azure Sphere-Gerät anwenden, indem Sie den Befehl "Azsphere Device Capability Update" verwenden und eine Wartungssitzung mithilfe des Auswahlbefehls für azsphere-Geräte erstellen. Weitere Informationen zu Gerätefunktionen finden Sie unter Gerätefunktionen und -kommunikation.

Vorgang	Beschreibung
Download	Lädt eine Gerätefunktionskonfiguration aus dem Azure Sphere Security Service herunter.
select	Wählt eine heruntergeladene Funktionsdatei aus, die für eine Wartungssitzung verwendet werden soll.
show-attached	Zeigt die Funktionskonfiguration für das angeschlossene Gerät an.
Aktualisierung	Wendet eine Gerätefunktionskonfiguration auf das angeschlossene Gerät an.

capability download

Lädt eine Gerätefunktionskonfiguration über den Azure Sphere-Sicherheitsdienst herunter.

Mit der Funktion appDevelopment können Sie SDK-signierte Anwendungen querladen und jede Anwendung auf dem Gerät starten, beenden, debuggen oder löschen. Ohne die Funktion appDevelopment können nur cloudgeladene Anwendungen geladen werden. Starten, Beenden, Debuggen und Löschen sind nicht zulässig. Die Funktion appDevelopment wird im Rahmen des Befehls azsphere device enable-development angewendet.

Das Herunterladen der Funktion fieldServicing führt zu einer Datei, in der die Funktion für ein einzelnes Azure Sphere-Gerät enthalten ist. Die Datei mit der Funktion fieldServicing wird auf Ihren lokalen Computer heruntergeladen und kann zusammen mit dem Befehl azsphere device capability select verwendet werden.

Erforderliche Parameter

Parameter	Typ	Beschreibung
--type	Funktionstyp	Gibt den Typ der herunterzuladenden Gerätefunktion an. Zulässige Werte sind appDevelopment, fieldServicing und none. Verwenden Sie none, um die Funktion appDevelopment oder fieldServicing zu entfernen.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll. Dieser Parameter ist erforderlich, wenn mehrere Geräte angeschlossen sind oder wenn kein Gerät angeschlossen ist. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können eine Geräte-ID für ein nicht angefügtes Gerät angeben oder die IP-Adresse oder die lokale Verbindungs-ID eines angeschlossenen Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.
--Bestimmungsort	String	Gibt den Pfad und Dateinamen an, unter dem die Funktionskonfiguration gespeichert werden soll. Geben Sie einen absoluten oder relativen Pfad an. Wenn Sie keinen Pfad angeben, speichert der Befehl die Datei im lokalen Verzeichnis unter Verwendung der Benennungskonventionsfunktionstyp erste acht Zeichen der Geräte-ID.cap>.<<>
-t, --tenant	GUID oder Name	Gibt den Mandanten an, in dem dieser Vorgang ausgeführt werden soll. Überschreibt den ausgewählten Standardmandanten. Sie können entweder die Mandanten-ID oder den Mandantennamen angeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device capability download --type appDevelopment
The appdevelopment capability was saved as:
 --------------------------------------------
 Result
 ============================================
 C:\capability-file\appdevelopment-<first eight characters of device ID>.cap
 --------------------------------------------

capability select

Wählt eine Funktionsdatei für die Verwendung mit dem angeschlossenen Azure Sphere-Gerät aus.

Der Befehl azsphere device capability select kann mit beliebigen Funktionen verwendet werden, aber am häufigsten wird er zusammen mit der Funktion fieldServicing eingesetzt, um eine Wartungssitzung zu aktivieren. Alle Benutzerrollen haben Zugriff auf den Befehl azsphere device capability select.

Bei Verwendung der Funktion fieldServicing ist die Kommunikation zwischen dem Azure Sphere-Gerät und dem lokalen Computer mit der Funktionsdatei aktiviert. Die Funktionsdatei fieldServicing wird für eine Sitzung zwischen dem lokalen Computer und dem Azure Sphere-Gerät verwendet, und jedem Befehl der Sitzung wird eine Meldung vorangestellt, um die genutzte Funktionsdatei anzugeben.

Verwenden Sie azsphere device capability select --none, um eine Wartungssitzung zu beenden.

Optionale Parameter

Parameter	Typ	Beschreibung
--capability-file	String	Gibt den Pfad und dateinamen für die auszuwählende Gerätefunktionskonfigurationsdatei an. Sie können einen relativen oder absoluten Pfad angeben.
-n, --none	-	Löscht alle zuvor ausgewählten Gerätefunktionskonfigurationen.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device capability select --capability-file appdevcap
The capability session uses C:\capability-file\appdevcap.

capability show-attached

Zeigt die Funktionskonfiguration an, die auf dem angeschlossenen Gerät gespeichert ist.

Hinweis

Der Befehl zeigt die mit einer Funktionsdatei konfigurierten Funktionen und einige, aber nicht alle Funktionen an, die standardmäßig auf Boards vorhanden sind.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device capability show-attached
 --------------------
 DeviceCapabilities
 ====================
 EnableFieldServicing
 --------------------

azsphere device capability show-attached
 --------------------
 DeviceCapabilities
 ====================
 EnableAppDevelopment
 --------------------

capability update

Wendet eine Gerätefunktionskonfiguration auf das angeschlossene Gerät an.

Erforderliche Parameter

Parameter	Typ	Beschreibung
--capability-file	String	Gibt den Pfad und Dateinamen der anzuwendenden Gerätefunktionsdatei an. Sie können einen relativen oder absoluten Pfad angeben.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll. Dieser Parameter ist erforderlich, wenn mehrere Geräte angeschlossen sind oder wenn kein Gerät angeschlossen ist. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können eine Geräte-ID für ein nicht angefügtes Gerät angeben oder die IP-Adresse oder die lokale Verbindungs-ID eines angeschlossenen Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device capability update --capability-file appdevcap.bin
Using selected capability file: C:\capability-file\appdevcap.bin
The capability file C:\capability-file\appdevcap.bin was added on the device. The device will restart.

Zertifikat

Dient zum Verwalten der Zertifikate auf dem angeschlossenen Gerät

Vorgang	Beschreibung
add	Fügt dem Zertifikatspeicher auf dem angefügten Gerät ein Zertifikat hinzu.
Löschen	Löscht ein Zertifikat aus dem Zertifikatspeicher des angefügten Geräts.
list	Listet die Zertifikat-IDs auf, die im Zertifikatspeicher des angefügten Geräts verfügbar sind.
show	Zeigt Details eines Zertifikats im Zertifikatspeicher des angefügten Geräts an.
show-quota	Zeigt den verfügbaren freien Speicherplatz im Zertifikatspeicher des angefügten Geräts an.

certificate add

Fügt dem Zertifikatspeicher des angefügten Geräts ein Zertifikat hinzu.

Die Zertifikate der Stammzertifizierungsstelle und die Clientzertifikate müssen das PEM-Format aufweisen, um auf das Azure Sphere-Gerät geladen werden zu können. Sie müssen das Stammzertifizierungsstellenzertifikat vom entsprechenden Server abrufen, zusammen mit dem Clientzertifikat und dem privaten Schlüssel (und optional einem Kennwort für Ihren privaten Schlüssel) für Ihr Gerät. Jedes Zertifikat muss vom entsprechenden Server in Ihrem EAP-TLS-Netzwerk generiert und signiert werden. Ihr Netzwerkadministrator oder Sicherheitsteam kann die Details liefern, die Sie für das Abrufen der Zertifikate benötigen. Weitere Informationen zum Abrufen des Stammzertifizierungsstellenzertifikats finden Sie unter Abrufen und Bereitstellen von Zertifikaten für EAP-TLS-Netzwerke.

Achtung

Da Zertifikat-IDs systemweit für Clientzertifikate und Zertifikate der Stammzertifizierungsstelle gelten, kann ein azsphere-Befehl oder ein Funktionsaufruf, der ein neues Zertifikat hinzufügt, ein Zertifikat überschreiben, das mit einem früheren Befehl oder Funktionsaufruf hinzugefügt wurde. Dies kann Netzwerkverbindungsfehler verursachen. Es wird dringend empfohlen, klare Verfahren zum Aktualisieren von Zertifikaten zu entwickeln und Zertifikat-IDs sorgfältig auszuwählen.

Weitere Informationen finden Sie unter Zertifikat-IDs.

Erforderliche Parameter

Parameter	Typ	Beschreibung
-i, --cert-id	String	Gibt den Bezeichner des hinzuzufügenden Zertifikats an. Ein Zeichenfolgenbezeichner (max. 16 Zeichen). Gültige Zeichen umfassen Großbuchstaben (A-Z), Kleinbuchstaben (a-z), Zahlen (0-9), Unterstrich (_), Punkt (.) und Bindestrich (-). Dieser Bezeichner wird auch in WLAN-Konfigurationen für EAP-TLS-Netzwerke verwendet.
--cert-type	String	Gibt den Typ des hinzuzufügenden Zertifikats an, entweder Client oder Rootca.
-p, --public-key-file	String	Gibt den Pfad zu einer PEM-Datei mit öffentlichem Schlüsselzertifikat an. Sie können einen relativen oder absoluten Pfad angeben.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.
--private-key-file	String	Gibt den Pfad zu einer Client-DATEI für private Schlüsselzertifikate .pem an. Erforderlich beim Hinzufügen eines Zertifikats vom Typclient. Sie können einen relativen oder absoluten Pfad angeben.
-w, --private-key-password	String	Gibt ein optionales Kennwort für den privaten Clientschlüssel an. Das Kennwort ist erforderlich, wenn ein verschlüsselter privater Schlüssel für das Clientzertifikat hinzugefügt wird.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device certificate add --cert-id certroot --cert-type rootca --public-key-file publiccert.pem
Certificate 'certroot' successfully added.

azsphere device certificate add --cert-id certclient --cert-type client --private-key-file privatekey.pem --private-key-password 1234 --public-key-file publiccert.pem
Certificate 'certclient' successfully added.

certificate delete

Löscht ein Zertifikat aus dem Zertifikatspeicher des angefügten Geräts.

Erforderliche Parameter

Parameter	Typ	Beschreibung
-c, --certificate oder --cert-id [Zurückstellen]	String	Gibt den Bezeichner des zu löschenden Zertifikats an. Das `--cert-id` Argument wird eingestellt und wird in einer zukünftigen Version entfernt. Weitere Informationen finden Sie unter Wichtige Änderungen (Einstellungsfeatures) in Azure Sphere CLI.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device certificate delete --certificate certclient

certificate list

Listet die im Zertifikatspeicher des Geräts verfügbaren Zertifikate auf.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device certificate list
 -----------
 Identifiers
 ===========
 rootCert
 -----------

certificate show

Zeigt Details zu einem einzelnen Zertifikat im Zertifikatspeicher des Geräts an

Erforderliche Parameter

Parameter	Typ	Beschreibung
-c, --certificate oder --cert-id [Zurückstellen]	String	Gibt den Bezeichner des Zertifikats an, für das die Details angezeigt werden sollen. Das `--cert-id` Argument wird eingestellt und wird in einer zukünftigen Version entfernt. Weitere Informationen finden Sie unter Wichtige Änderungen (Einstellungsfeatures) in Azure Sphere CLI.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device certificate show --certificate certclient
---------- ------------------- ------------------- ----------------------------------- -----------------------------------
 Id         StartDate           EndDate             SubjectName                         IssuerName
 ==========================================================================================================================
 certclient 06/08/2019 19:15:48 06/08/2069 19:25:44 /DC=local/DC=azsphere/CN=azsphereca /DC=local/DC=azsphere/CN=azsphereca
 ---------- ------------------- ------------------- ----------------------------------- -----------------------------------

certificate show-quota

Zeigt den verfügbaren freien Speicherplatz im Zertifikatspeicher des angefügten Geräts an.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device certificate show-quota
--------------
Available space (bytes)
==============
24514
--------------

claim

Beansprucht ein zuvor nicht beanspruchtes Gerät für den aktuellen Azure Sphere-Mandanten.

Wichtig

Stellen Sie vor dem Beanspruchen des Geräts sicher, dass Sie beim richtigen Azure Sphere-Mandanten angemeldet sind. Ein Gerät kann nur einmal beansprucht werden. Sobald ein Gerät beansprucht wurde, kann es nicht mehr in einen anderen Mandanten verschoben werden.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll. Dieser Parameter ist erforderlich, wenn mehrere Geräte angeschlossen sind oder wenn kein Gerät angeschlossen ist. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können eine Geräte-ID für ein nicht angefügtes Gerät angeben oder die IP-Adresse oder die lokale Verbindungs-ID eines angeschlossenen Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.
-t, --tenant	GUID oder Name	Gibt den Mandanten an, in dem dieser Vorgang ausgeführt werden soll. Überschreibt den ausgewählten Standardmandanten. Sie können entweder die Mandanten-ID oder den Mandantennamen angeben.
--force	Boolean	Erzwingt, dass ein Gerät im ausgewählten Azure Sphere-Mandanten des aktuellen Benutzers beansprucht wird.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device claim
warn: You are claiming a device to the following tenant:
warn: a323c263-2aa3-2559-aabb-a3fc32631900 (Tenant1)
warn: Do you want to claim the device ID 352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968 to this tenant?
warn: You cannot change the Azure Sphere tenant this device is claimed to once this action has completed.
Enter 'yes' to continue. Enter anything else to exit.
> yes
Claiming device.
Successfully claimed device ID '352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968' into tenant 'Tenant1' with ID 'a323c263-2aa3-2559-aabb-a3fc32631900'.

enable-cloud-test

Bereitet das angeschlossene Gerät für das Testen des Cloudladens vor, indem die Anwendungsentwicklung deaktiviert wird, alle vorhandenen Anwendungen gelöscht und cloudgeladene Anwendungsupdates aktiviert werden.

Damit dieser Vorgang ausgeführt werden kann, muss ein Gerät mit dem PC verbunden sein, und die Ausführung erfolgt nur für das angeschlossene Gerät.

Insbesondere enable-cloud-test:

Entfernt die AppDevelopment-Funktion für das angefügte Gerät.
Weist das Gerät einer Gerätegruppe zu, die cloudgeladene Anwendungsupdates ermöglicht.
Startet das Gerät neu.

Die spezifischen Aufgaben, die enable-cloud-test ausführt, sind davon abhängig, ob bereits ein Produkt und eine Gerätegruppe für dieses Gerät zugewiesen wurden.

Wenn azsphere device enable-cloud-test ohne Parameter ausgeführt wird, wird das Gerät in der Feldtestgerätegruppe des aktuellen Produkts des Geräts platziert. Dies ist eine der Standardgerätegruppen, die automatisch für jedes Produkt erstellt werden, wodurch Anwendungsupdates ermöglicht werden. Es wird ein Fehler zurückgegeben, wenn das Gerät nicht über ein Produkt verfügt oder eine Feldtestgerätegruppe darin nicht vorhanden ist.

Wenn ein Produkt angegeben ist, wird das Gerät in der Gerätegruppe "Feldtest" dieses Produkts platziert. Wenn diese Gerätegruppe nicht vorhanden ist, wird ein Fehler zurückgegeben.

Wenn eine Gerätegruppe angegeben ist, wird das Gerät darin platziert. Wenn die Zielgerätegruppe keine Anwendungsupdates aktiviert, wird ein Fehler zurückgegeben.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.
-p, --product	GUID oder Name	Gibt das Zielprodukt an. Wenn dies angegeben ist, wird das Gerät in die standardmäßige Feldtestgerätegruppe dieses Produkts verschoben, es sei denn `--device-group` , es wird auch angegeben. Sie können entweder die ID oder den Namen des Azure Sphere-Produkts angeben.
-t, --tenant	GUID oder Name	Gibt den Mandanten an, in dem dieser Vorgang ausgeführt werden soll. Überschreibt den ausgewählten Standardmandanten. Sie können entweder die Mandanten-ID oder den Mandantennamen angeben.
-g, --device-group	GUID oder Name	Gibt die Gerätegruppe an, in die das Gerät verschoben wird. Sie können entweder die Gerätegruppen-ID oder den Gerätegruppennamen angeben. Um den Gerätegruppennamen zu verwenden, müssen Sie sowohl den Produktnamen als auch den Gerätegruppennamen im `<product-name/device-group-name>` Format angeben. Standardmäßig ist dies die Feldtestgerätegruppe des Produkts.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiele

Beispiel 1: Zuweisen eines Geräts zu einer vorhandenen Gerätegruppe über seine ID

In diesem Beispiel wird das angeschlossene Gerät einem vorhandenen Produkt und einer vorhandenen Gerätegruppe zugewiesen.

azsphere device enable-cloud-test --device-group '3548b179-m16f-4f64-6dme-d3c643662e76'
Your internal capabilities will be retained, including the Enable App development capability. Sideloaded images may be removed by over-the-air application updates.
Getting device group by ID '3548b179-m16f-4f64-6dme-d3c643662e76'.
Leaving any existing applications on the device.
Setting device group to 'Field Test' with ID '3548b179-m16f-4f64-6dme-d3c643662e76')
Successfully updated device's device group.
Successfully set up device for application updates.
(Device ID: 'ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABCD')

Beispiel 2: Zuweisen einer anderen Gerätegruppe für das Gerät

Dieses Beispiel ähnelt dem vorherigen Beispiel, wobei hier das vorhandene Produkt für das Gerät beibehalten wird. Hier ändert der Vorgang enable-cloud-test die Gerätegruppe, zu der das Gerät gehört, und entfernt die Funktion „appDevelopment“. Dieser Befehl ist nützlich, wenn Sie ein Gerät aus einer Entwicklungsumgebung, in der keine Anwendungsupdates zulässig sind, in eine Produktionsumgebung verschieben möchten, die Anwendungsupdates zulässt.

azsphere device enable-cloud-test --device-group "Marketing/Field Test"

Beispiel 3: Zuweisen eines Geräts mittels Produktname

In diesem Beispiel wird Cloudladen aktiviert, und das Gerät wird einem Produkt anhand des Namens zugewiesen.

azsphere device enable-cloud-test --product DW100

enable-development

Ermöglicht ein Gerät für die Entwicklung durch Querladen und Debuggen auf dem Gerät und durch Zuweisen zu einer Gerätegruppe, die Anwendungsupdates aus der Cloud deaktiviert. Standardmäßig ist dies die Gerätegruppe "Entwicklung" des Produkts des Geräts, andere Gerätegruppen können jedoch angegeben werden. Verwenden Sie nicht in Produktionsszenarien. Weitere Informationen finden Sie unter "Herstellen verbundener Geräte ".

Insbesondere enable-development:

Lädt die AppDevelopment-Funktion für das angefügte Gerät herunter und wendet sie an.
Weist das Gerät einer Gerätegruppe zu, die keine cloudgeladenen Anwendungsupdates aktiviert.
Startet das Gerät neu.

Wenn Sie den Azsphere Device Enable-Development-Befehl ohne Parameter ausführen:

Wenn das Gerät noch nicht über ein Produkt oder eine Gerätegruppe verfügt, lädt der Befehl die Funktion appDevelopment für das angeschlossene Gerät herunter, wendet sie an und startet das Gerät neu. Alle vorhandenen Apps bleiben auf dem Gerät, und das Betriebssystem wird aktualisiert. Der Installationsprozess zum Anfordern Ihres Geräts und der Schnellstart zum Erstellen einer allgemeinen Anwendung ist nicht betroffen.
Wenn das Gerät bereits über ein Produkt verfügt, verschiebt der Befehl das Gerät in die Gerätegruppe Development (Entwicklung) des Produkts. Standardmäßig sind Anwendungsupdates für diese Gruppe deaktiviert, um sicherzustellen, dass quergeladene Apps nicht überschrieben werden.

Wenn Sie den Azsphere Device Enable-Development-Befehl mit dem --product Parameter ausführen:

Platziert das Gerät in der Gerätegruppe "Entwicklung" für das Produkt. Wenn diese Gerätegruppe nicht vorhanden ist, wird ein Fehler zurückgegeben.

Wenn Sie den Azsphere Device Enable-Development-Befehl mit dem --device-group Parameter ausführen:

Platziert das Gerät in der angegebenen Gerätegruppe. Die Zielgerätegruppe darf keine Anwendungsupdates aktivieren oder ein Fehler wird zurückgegeben.

In einigen Fällen meldet azsphere device enable-development einen Fehler und schlägt vor, dass Sie das Gerät beanspruchen. Wenn Sie das Gerät bereits beansprucht haben, verwenden Sie azsphere tenant show-selected, um sicherzustellen, dass Sie bei dem Mandanten angemeldet sind, in dem Sie das Gerät beansprucht haben. Falls nicht, verwenden Sie azsphere login, um sich beim richtigen Mandanten anzumelden. Wenn Sie sicher sind, dass Sie beim entsprechenden Mandanten angemeldet sind, verwenden Sie azsphere-Geräteanspruch , um das Gerät in Anspruch zu nehmen.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.
-g, --device-group	GUID oder Name	Gibt die Gerätegruppe an, in die das Gerät verschoben wird. Wenn diese Angabe nicht erfolgt, wird das Gerät einer Standardgruppe zugewiesen. Sie können entweder die Gerätegruppen-ID oder den Gerätegruppennamen angeben. Um den Gerätegruppennamen zu verwenden, müssen Sie sowohl den Produktnamen als auch den Gerätegruppennamen im `<product-name/device-group-name>` Format angeben.
-r, --enable-rt-core-debugging	Boolean	Installiert Treiber, die zum Debuggen von Anwendungen mit Ausführung auf einem Echtzeitkern benötigt werden. Für diese Option sind Administratorberechtigungen erforderlich.
-p, --product	GUID oder Name	Gibt das Zielprodukt an. Wenn Sie diesen Wert angeben, wird das Gerät in die Standardmäßige Gerätegruppe "Entwicklung " dieses Produkts verschoben, es sei denn `--device-group` , es wird auch angegeben. Sie können entweder die ID oder den Namen des Azure Sphere-Produkts angeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device enable-development
Capability configuration has been successfully cleared.
PS C:\Users\v-shypr> azsphere device enable-development
Getting device group 'Development' for product 'DW100'.
The device already has the 'Enable App development' capability. No changes will be applied to its existing capabilities.
Setting device group to 'Development' with ID '7f860cc1-4949-4000-a541-9a988ba4c3cd'.
Successfully disabled application updates.
Installing debugging server to device.
Deploying 'C:\Program Files (x86)\Microsoft Azure Sphere SDK\DebugTools\gdbserver.imagepackage' to the attached device.
Image package 'C:\Program Files (x86)\Microsoft Azure Sphere SDK\DebugTools\gdbserver.imagepackage' has been deployed to the attached device.
Previous device capabilities retained. Ensure that you have the correct development capabilities installed before continuing.
Successfully set up device for application development, and disabled application updates.
(Device ID: '352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968')

image

Gibt Informationen zu den Images zurück, die auf dem angeschlossenen Gerät installiert oder darauf ausgerichtet sind.

Vorgang	Beschreibung
list-installed	Enthält Details zu den Images, die derzeit auf dem angeschlossenen Gerät installiert sind.
list-targeted	Stellt Details zu den Images bereit, die auf das angeschlossene Gerät ausgerichtet sind.

image list-installed

Listet die Images auf, die auf dem angeschlossenen Gerät installiert sind. Die Liste mit den Informationen enthält die Komponenten- und Image-IDs.

Hinweis

Lange Bildnamen werden mit 31 Zeichen abgeschnitten.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.
-f, --full	Boolean	Listet alle Softwareimages auf, die auf dem Gerät installiert sind. Standardmäßig werden nur Anwendungsimages, Debugger und Boardkonfigurationsimages aufgeführt.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device image list-installed
Installed images:
 --> gdbserver
   --> Image type:   Application
   --> Component ID: 8548b129-b16f-4f84-8dbe-d2c847862e78
   --> Image ID:     dc6205bd-4478-4c9b-81ad-5e41ac23ed68
 --> CrashApplicatio
   --> Image type:   Application
   --> Component ID: 9ce57001-90eb-45e1-bd0a-4fc07b0c85c9
   --> Image ID:     cc77124e-6447-4c0f-9f99-fc0ad5ef46ef

image list-targeted

Listet die Bilder auf, die in den Azure Sphere Security Service hochgeladen wurden und beim Aktualisieren des Geräts installiert werden. Weitere Informationen zum Sicherstellen, dass Ihr Azure Sphere-Gerät bereit ist, cloudbasierte Anwendungsupdates zu akzeptieren, finden Sie unter Aktivieren der cloudbasierten Bereitstellung für Ihr Gerät.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll. Dieser Parameter ist erforderlich, wenn mehrere Geräte angeschlossen sind oder wenn kein Gerät angeschlossen ist. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können eine Geräte-ID für ein nicht angefügtes Gerät angeben oder die IP-Adresse oder die lokale Verbindungs-ID eines angeschlossenen Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.
-t, --tenant	GUID oder Name	Gibt den Mandanten an, in dem dieser Vorgang ausgeführt werden soll. Überschreibt den ausgewählten Standardmandanten. Sie können entweder die Mandanten-ID oder den Mandantennamen angeben.
-f, --full	Boolean	Listet alle Bilder in Ihrem Azure Sphere-Mandanten auf.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device image list-targeted
 ----------------------- ------------------------------------ ------------------------------------ ---------------- --------------------
 Name                    ComponentId                          ImageId                              ImageType       RegionalDataBoundary 
 =======================================================================================================================================
 HelloWorld_HighLevelApp 1689d8b2-c835-2e27-27ad-e894d6d15fa9 50419cb6-a33b-4cbe-8bd0-425048664b6f Applications    None   
 ----------------------- ------------------------------------ ------------------------------------ -------------------------------------

list

Listet alle Geräte in einem Mandanten auf. Die Liste schneidet nach den ersten 500 Geräten ab.

Optionale Parameter

Parameter	Typ	Beschreibung
-t, --tenant	GUID oder Name	Gibt den Mandanten an, in dem dieser Vorgang ausgeführt werden soll. Überschreibt den ausgewählten Standardmandanten. Sie können entweder die Mandanten-ID oder den Mandantennamen angeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device list
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
 DeviceId                                                                                                                         TenantId                             ChipSku  ProductId                            DeviceGroupId
 ========================================================================================================================================================================================================================================================
 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 4f48d618-09f7-45dc-a5a4-1433cabbee91 6f52bead-700d-4289-bdc2-2f11f774270e
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
 ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABCD a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 4f48d618-09f7-45dc-a5a4-1433cabbee91 6f52bead-700d-4289-bdc2-2f11f774270e
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------

Sie können den --query Parameter verwenden, um die für diesen Befehl angezeigte Ausgabe anzupassen. Weitere Informationen finden Sie unter Abfrage CLI-Befehlsausgabe.

Das folgende Beispiel zeigt, wie Sie nur die Geräte-ID und Produkt-ID auswählen:

azsphere device list --query '[].{DeviceId:deviceId, ProductId:productId}'
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
 DeviceId                                                                                                                         ProductId
 =====================================================================================================================================================================
 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 4f48d618-09f7-45dc-a5a4-1433cabbee91
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
 ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABCD 4f48d618-09f7-45dc-a5a4-1433cabbee91
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------

Tipp

Führen Sie die Azsphere-Produktpräsentation --produkt-ID>< aus, um den Produktnamen oder die azsphere device-group show --device-group <devicegroup-ID> anzuzeigen, um den Gerätegruppennamen anzuzeigen.

list-attached

Listet die Geräte auf, die an den lokalen PC angeschlossen sind.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device list-attached
1 device attached:
--> Device ID: 352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968
  --> Is responsive: yes
  --> IP address: 192.128.48.1
  --> Connection path: 21143

Fertigungszustand

Verwaltet den Fertigungszustand des angeschlossenen Geräts.

Vorgang	Beschreibung
show	Zeigt den Fertigungszustand des angeschlossenen Geräts an.
Aktualisierung	Aktualisiert den Fertigungsstatus des angeschlossenen Geräts.

Achtung

Änderungen am Fertigungszustand sind dauerhaft und können nicht rückgängig gemacht werden.

manufacturing-state show

Zeigt den Fertigungszustand des angeschlossenen Geräts an.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device manufacturing-state show
------------------
ManufacturingState
==================
Module1Complete
------------------

manufacturing-state update

Aktualisiert den Fertigungsstatus des angeschlossenen Geräts. Weitere Informationen finden Sie unter Festlegen des Geräteherstellungszustands.

Achtung

Änderungen am Fertigungszustand sind dauerhaft und können nicht rückgängig gemacht werden.

Erforderliche Parameter

Parameter	Typ	Beschreibung
-s, --state	Fertigungszustände	Gibt den für das Gerät festzulegenden Fertigungszustand an. Mögliche Zustände umfassen `DeviceComplete` und `Module1Complete`.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device manufacturing-state update --state Module1Complete
Updating manufacturing state to Module1Complete.
Restarting device for changes to take effect.
The device was successfully restarted.

network

Stellt Informationen zum Status der Netzwerkschnittstellen auf dem angeschlossenen Gerät bereit.

Vorgang	Beschreibung
enable	Aktiviert eine Netzwerkschnittstelle auf dem angeschlossenen Gerät.
disable	Deaktiviert eine Netzwerkschnittstelle auf dem angeschlossenen Gerät.
list-firewall-rules	Listet die Firewallregeln für das angefügte Gerät auf.
Listenschnittstellen	Listet die Netzwerkschnittstellen für das angefügte Gerät auf.
proxy	Verwaltet die Netzwerkproxyeinstellungen.
Show-Diagnostics	Zeigt die Netzwerkdiagnose für ein oder alle Drahtlosnetzwerke auf dem angeschlossenen Gerät an.
show-status	Zeigt den Netzwerkstatus für das angeschlossene Gerät an.
Update-Schnittstelle	Aktualisiert eine Netzwerkschnittstellenkonfiguration für das Gerät.

Netzwerkaktiv

Aktiviert eine Netzwerkschnittstelle auf dem angeschlossenen Gerät.

Hinweis

Dieser Befehl wird für die Konfiguration von Ethernet eth0 und wlan0 Verbindungen unterstützt. Wenn Sie konfigurieren lo oder azspheresvc.

Erforderliche Parameter

Parameter	Typ	Beschreibung
--Schnittstelle	Zeichenfolge	Gibt die zu aktivierende Schnittstelle an.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device network enable --interface wlan0
Network interface configuration is successfully applied to the device.
Run the command 'azsphere device network list-interfaces' to view details of the network interfaces for the attached device.

Netzwerk deaktivieren

Deaktiviert eine Netzwerkschnittstelle auf dem angeschlossenen Gerät.

Hinweis

Dieser Befehl wird für die Konfiguration von Ethernet eth0 und wlan0 Verbindungen unterstützt. Wenn Sie konfigurieren lo oder azspheresvc.

Erforderliche Parameter

Parameter	Typ	Beschreibung
--Schnittstelle	Zeichenfolge	Gibt die zu aktivierende Schnittstelle an.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device network disable --interface wlan0
Network interface configuration is successfully applied to the device.
Run the command 'azsphere device network list-interfaces' to view details of the network interfaces for the attached device.

Netzwerklisten-Firewall-Regeln

Listet die Firewallregeln für das angefügte Gerät auf.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Die folgenden Regeln werden angezeigt:

Name des Firewall-Regelsatzs: Zeigt den Namen des Firewall-Regelsatzblocks an.
- Die Werte sind PREROUTING, POSTROUTING, INPUT, FORWARD und OUTPUT.
Is Ruleset Valid: Displays the status of the ruleset. Die Werte sind True oder False.
Regeln für Firewallregeln: Zeigt die Werte für die folgenden Regeln an:
- Quell-IP: Zeigt die IP-Adresse des sendenden Computers an.
- Quellformat: Zeigt die Netzwerkmaske des sendenden Computers an.
- Ziel-IP: Zeigt die IP-Adresse des Zielcomputers an.
- Zielmaske: Zeigt die Netzwerkmaske des Destomationscomputers an.
- UID: Zeigt die auf die Regel angewendete Benutzeridentifikation an. 4294967295 (0xFFFFFFFF) bedeutet, dass keine UID angewendet wurde und daher für alle gilt.
- Aktion: Zeigt die auszuführende Aktion an. Die Werte können akzeptiert oder abgelegt werden.
- Name der Schnittstelle IN: Zeigt den Namen der Eingabeschnittstelle an. Beispiel: wlan0.
- Interface OUT-Name: Zeigt den Namen der Ausgabeschnittstelle an. Beispiel: wlan0.
- Status: Zeigt den Verbindungsstatus an. Die Werte sind keine, eingerichtet oder verknüpft.
- TCP-Maske: Zeigt das Array von TCP-Masken an. Die Werte sind fin, syn, rst, psh, ack und urg.
- TCP Cmp: Zeigt das Array von TCP-Flags an. Die Werte sind urg, ack, psh, rst, syb und fin.
- TCP Inv: Boolean gibt an, dass der Sinn der TCP-Flags invertiert werden soll. Die Werte sind True oder False.
- Protokoll: Zeigt das Protokoll der Firewallregel an. Die Werte sind icmp, igmp, tcp, udp.
- Quellportbereich: Zeigt den Portbereich von der Quelle an, die den Datenverkehr sendet. Der Wert kann zwischen 0 und 65535 sein.
- Zielportbereich: Zeigt den Portbereich an, der den Datenverkehr empfängt. Der Wert kann zwischen 0 und 65535 sein.
- Pakete: Zeigt die Anzahl der Pakete an.
- Bytes: Zeigt die Anzahl der Bytes an.

Eine kurze Zusammenfassung der Kennzeichen ist wie folgt aufgeführt:

URG: Dringendes Zeigerfeld signifikant
ACK: Bestätigungsfeld signifikant
PSH: Push-Funktion
RST: Zurücksetzen der Verbindung
SYN: Sequenznummern synchronisieren
FIN: Keine weiteren Daten vom Absender

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device network list-firewall-rules
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 Ruleset     IsValid SourceIp     SourceMask      DestinationIp   DestinationMask UID        Action InterfaceInName TcpInv Protocol SourcePortRange DestinationPortRange Packets Bytes  TcpMask TcpCmp
 =====================================================================================================================================================================================================
 PREROUTING  False   None         None            None            None            None       None   None            None   None     None            None                 None    None   None    None
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 INPUT       True    <value>      <value>         <value>         <value>         <value>     accept                 False  any      0-65535         0-65535              0       0      None    None
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 INPUT       True    <value>      <value>         <value>         <value>         <value>     accept                 True   tcp      0-65535         0-65535              823     394754 syn,ack syn
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 INPUT       True    192.168.35.1 <value>         <value>         <value>         <value>     accept azspheresvc     False  any      0-65535         0-65535              15      780    None    None
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 INPUT       True    <value>      <value>         <value>         <value>         <value>     accept                 False  udp      53-53           0-65535              0       0      None    None
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 INPUT       True    <value>      <value>         <value>         <value>         <value>     accept                 False  udp      53-53           0-65535              0       0      None    None
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 INPUT       True    <value>      <value>         <value>         <value>         <value>     accept                 False  udp      53-53           0-65535              0       0      None    None
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------

Netzwerklistenschnittstellen

Listet die Netzwerkschnittstellen für das angefügte Gerät auf.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device network list-interfaces
 ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
 InterfaceName InterfaceUp ConnectedToNetwork IpAcquired IpAddresses   ConnectedToInternet IpAssignment HardwareAddress
 ========================================================================================================================
 azspheresvc   True        False              False      <value>       False               None         None
 ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
 eth0          True        True               True       <value>       True                dynamic      <value>
 ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
 lo            True        False              False      <value>       False               None         None
 ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
 wlan0         True        True               True       <value>       True                dynamic      <value>
 ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------

Netzwerkproxy

Verwaltet die Proxyadressenverwendung für die Netzwerkverbindung. Weitere Informationen zum Konfigurieren eines Azure Sphere-Geräts für die Verbindung mit dem Internet über einen Proxyserver finden Sie unter "Verbinden über einen Proxyserver".

Hinweis

Derzeit werden nur HTTP-Proxys unterstützt.

Vorgang	Beschreibung
Proxy übernehmen	Konfiguriert den Netzwerkproxy auf dem angefügten Gerät.
Proxylöschung	Löscht die Proxyverbindung auf dem angefügten Gerät.
Proxypräsentation	Zeigt die Proxyverbindung auf dem angeschlossenen Gerät an.

Proxy übernehmen

Konfiguriert den Netzwerkproxy auf dem angefügten Gerät.

Erforderliche Parameter

Parameter	Typ	Beschreibung
-a, --address	String	Gibt die Netzwerkadresse des zu verwendenden Proxys an.
-t, --authentication	String	Gibt den zu verwendenden Authentifizierungstyp an. Zulässige Werte: `anonymous` oder `basic`. Wenn für den Proxy ein Benutzername und ein Kennwort erforderlich sind, legen Sie dies auf `basic`,, andernfalls verwenden Sie `anonymous`.
-r, --port	Ganzzahl	Gibt den Port für die zu verwendende Netzwerkadresse an. Der Wert muss gleich oder kleiner als 65535 sein.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.
--ermöglichen	String	Gibt an, ob der Proxy aktiviert werden soll. Sie müssen entweder `--enable` oder `--disable`.
--abschalten	String	Gibt an, ob der Proxy deaktiviert werden soll. Sie müssen entweder `--enable` oder `--disable`.
-n, --no-proxy-adressen	String	Gibt ein Array von durch Leerzeichen getrennten Netzwerkadressen an, die das Gerät für die Proxyverbindung vermeiden sollte.
-p, --password	String	Gibt das Kennwort für die Proxyauthentifizierung an, das nur für die Standardauthentifizierung verwendet wird. Maximale Länge: 64 Zeichen.
-u, --username	String	Gibt den Benutzernamen für die Proxyauthentifizierung an. Wird nur für die Standardauthentifizierung verwendet. Maximale Länge: 64 Zeichen.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device network proxy apply --address contoso.com --authentication anonymous --port 8080 --enable
 ----------- ------- ----- ------------------ ----------------
 Address     Enabled Port  AuthenticationType NoProxyAddresses
 =============================================================
 contoso.com True   8080  anonymous
 ----------- ------- ----- ------------------ ----------------

Proxylöschung

Löscht die Proxyverbindung auf dem angefügten Gerät.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device network proxy delete

Proxypräsentation

Zeigt die Proxyverbindung auf dem angeschlossenen Gerät an.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device network proxy show
 ----------- ------- ----- ------------------ ----------------
 Address     Enabled Port  AuthenticationType NoProxyAddresses
 =============================================================
 contoso.com True   8080  anonymous
 ----------- ------- ----- ------------------ ----------------

Netzwerkpräsentationsdiagnose

Zeigt die Diagnose für ein oder alle WLAN-Netzwerke auf dem angeschlossenen Gerät an.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.
-n, --network	Ganzzahl	Gibt die ID des WLAN-Netzwerks an, für das Diagnosen angezeigt werden sollen.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device network show-diagnostics
 ------------------------- --------- ----- ------------- --------------- --------
 Timestamp                 NetworkId Ssid  ConfigState   ConnectionState Error
 ================================================================================
 2021-06-16T20:51:29+00:00 0         <value> temp-disabled disconnected    WrongKey
 ------------------------- --------- ----- ------------- --------------- --------

Netzwerkanzeigestatus

Zeigt den Netzwerkstatus für das angeschlossene Gerät an.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device network show-status
 --------------------------- --------------- -----
 DeviceAuthenticationIsReady NetworkTimeSync Proxy
 =================================================
 True                        complete        ready
 --------------------------- --------------- -----

Netzwerkaktualisierungsschnittstelle

Aktualisiert die Ethernet-Netzwerkschnittstelle für das Gerät. Weitere Informationen zum Festlegen der MAC-Adresse für das Gerät finden Sie unter Konfigurieren des Geräts für Ethernet.

Hinweis

Dieser Befehl wird für die Konfiguration von Ethernet-Verbindungen eth0 unterstützt. Es wird ein Fehler zurückgegeben, wenn Sie konfigurieren looder wlan0azspheresvc .

Erforderliche Parameter

Parameter	Typ	Beschreibung
--hardware-address	String	Gibt die Hardwareadresse an, die für das Gerät in einem der folgenden Formate festgelegt werden soll: `AA:BB:33:DD:EE:FF` oder `aa:bb:33:dd:ee:ff`.
--Schnittstelle oder --interface-name [Einstellung]	String	Gibt den Namen der zu konfigurierenden Schnittstelle an. Führen Sie Azsphere-Gerätelistenschnittstellen aus, um Details der Netzwerkschnittstellen für das angeschlossene Gerät anzuzeigen. Das `--interface-name` Argument wird eingestellt und wird in einer zukünftigen Version entfernt. Weitere Informationen finden Sie unter Wichtige Änderungen (Einstellungsfeatures) in Azure Sphere CLI.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device network update-interface --interface eth0 --hardware-address ba:98:76:54:32:10

recover

Ersetzt die Systemsoftware auf dem Gerät.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Geben Sie die ID, DIE IP-Adresse oder die lokale Verbindungs-ID des Geräts an.
-c, --capability	String	Gibt das Gerätefunktionsimage an, das während der Wiederherstellung auf das Gerät angewendet werden soll.
-i, --images	String	Gibt den Pfad zu einem Ordner an, der die Imagepakete enthält, die auf das Gerät geschrieben werden sollen. Bei der Wiederherstellung werden standardmäßig die Images im SDK verwendet, es sei denn, mit diesem Flag wird ein alternativer Pfad angegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

Beispiel 1:

azsphere device recover
Downloading recovery images...
Download complete.
Starting device recovery. Please note that this may take up to 10 minutes.
Board found. Sending recovery bootloader.
Erasing flash.
Sending 17 images. (5443272 bytes to send)
Sent 1 of 17 images. (5440896 of 5443272 bytes remaining)
Sent 2 of 17 images. (5414844 of 5443272 bytes remaining)
Sent 3 of 17 images. (5311892 of 5443272 bytes remaining)
Sent 4 of 17 images. (5311500 of 5443272 bytes remaining)
Sent 5 of 17 images. (5041520 of 5443272 bytes remaining)
Sent 6 of 17 images. (5024908 of 5443272 bytes remaining)
Sent 7 of 17 images. (4994856 of 5443272 bytes remaining)
Sent 8 of 17 images. (2397456 of 5443272 bytes remaining)
Sent 9 of 17 images. (885796 of 5443272 bytes remaining)
Sent 10 of 17 images. (861220 of 5443272 bytes remaining)
Sent 11 of 17 images. (758608 of 5443272 bytes remaining)
Sent 12 of 17 images. (135796 of 5443272 bytes remaining)
Sent 13 of 17 images. (70048 of 5443272 bytes remaining)
Sent 14 of 17 images. (41164 of 5443272 bytes remaining)
Sent 15 of 17 images. (32768 of 5443272 bytes remaining)
Sent 16 of 17 images. (16384 of 5443272 bytes remaining)
Sent 17 of 17 images. (0 of 5443272 bytes remaining)
Finished writing images; rebooting board.
Device ID: 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968
Device recovered successfully.

Beispiel 2:

azsphere device recover --capability "C:\Users\capability file\capability_352FE1F_5.bin"
Downloading recovery images...
Download complete.
Starting device recovery. Please note that this may take up to 10 minutes.
Board found. Sending recovery bootloader.
Erasing flash.
Sending 16 images. (5474668 bytes to send)
Sent 1 of 16 images. (5447384 of 5474668 bytes remaining)
Sent 2 of 16 images. (5343788 of 5474668 bytes remaining)
Sent 3 of 16 images. (5343396 of 5474668 bytes remaining)
Sent 4 of 16 images. (5073416 of 5474668 bytes remaining)
Sent 5 of 16 images. (5056612 of 5474668 bytes remaining)
Sent 6 of 16 images. (5026240 of 5474668 bytes remaining)
Sent 7 of 16 images. (2479376 of 5474668 bytes remaining)
Sent 8 of 16 images. (889892 of 5474668 bytes remaining)
Sent 9 of 16 images. (865316 of 5474668 bytes remaining)
Sent 10 of 16 images. (754512 of 5474668 bytes remaining)
Sent 11 of 16 images. (135796 of 5474668 bytes remaining)
Sent 12 of 16 images. (70048 of 5474668 bytes remaining)
Sent 13 of 16 images. (41164 of 5474668 bytes remaining)
Sent 14 of 16 images. (32768 of 5474668 bytes remaining)
Sent 15 of 16 images. (16384 of 5474668 bytes remaining)
Sent 16 of 16 images. (0 of 5474668 bytes remaining)
Finished writing images; rebooting board.
Device ID: 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968
Device recovered successfully.

rescan-attached

Überprüft die angeschlossenen Geräte erneut, indem alle ihre FTDI-Anschlüsse gezählt werden und die Gesamtanzahl der angeschlossenen Geräte angezeigt wird. Verwenden Sie diesen Befehl, wenn Sie Probleme mit der Geräteverbindung unter Windows beheben. Dieser Befehl wird nur unter Windows ausgeführt.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

 azsphere device rescan-attached
 -----------
 Count
 ===========
 2
 -----------

restart

Startet das angeschlossene Gerät neu.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device restart
Restarting device.
Device restarted successfully.

show

Zeigt Details eines angefügten Geräts in Ihrem Azure Sphere-Mandanten an.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll. Dieser Parameter ist erforderlich, wenn mehrere Geräte angeschlossen sind oder wenn kein Gerät angeschlossen ist. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können eine Geräte-ID für ein nicht angefügtes Gerät angeben oder die IP-Adresse oder die lokale Verbindungs-ID eines angeschlossenen Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.
-t, --tenant	GUID oder Name	Gibt den Mandanten an, in dem dieser Vorgang ausgeführt werden soll. Überschreibt den ausgewählten Standardmandanten. Sie können entweder die Mandanten-ID oder den Mandantennamen angeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device show
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
 DeviceId                                                                                                                         TenantId                             ChipSku  ProductId                            DeviceGroupId
 ========================================================================================================================================================================================================================================================
 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------

Sie können den --query Parameter verwenden, um die für diesen Befehl angezeigte Ausgabe anzupassen. Weitere Informationen finden Sie unter Abfrage CLI-Befehlsausgabe.

Das folgende Beispiel zeigt, wie Sie nur die Geräte-ID und Produkt-ID auswählen:

azsphere device show --device 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968  --query '{DeviceId:deviceId, ProductId:productId}'
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
 DeviceId                                                                                                                         ProductId
 =====================================================================================================================================================================
 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 6f52bead-700d-4289-bdc2-2f11f774270e
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------

show-attached

Zeigt Informationen zum angeschlossenen Gerät über das Gerät selbst an. Diese Details unterscheiden sich von den Informationen, die der Azure Sphere Security Service für das Gerät speichert.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device show-attached
Device ID: 352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968
IP address: 192.128.48.1
Connection path: 21143

show-deployment-status

Zeigt den Bereitstellungsstatus von Anwendungs- und Betriebssystemupdates für das Gerät an.

Verwenden Sie diesen Befehl, um herauszufinden, welche Version des Azure Sphere-Betriebssystems auf Ihrem Gerät ausgeführt wird oder ob das aktuelle Bereitstellungsupdate abgeschlossen wurde.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.
-t, --tenant	GUID oder Name	Gibt den Mandanten an, in dem dieser Vorgang ausgeführt werden soll. Überschreibt den ausgewählten Standardmandanten. Sie können entweder die Mandanten-ID oder den Mandantennamen angeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device show-deployment-status
Your device is running Azure Sphere OS version <version-number>.
The Azure Sphere Security Service is targeting this device with Azure Sphere OS version <version-number>.
Your device has the expected version of the Azure Sphere OS: <version-number>.

In diesem Beispiel <stellt die Versionsnummer> die aktuelle Betriebssystemversion dar.

show-count

Zeigt die Anzahl der Geräte im aktuellen Mandanten an.

Optionale Parameter

Parameter	Typ	Beschreibung
-t, --tenant	GUID oder Name	Gibt den Mandanten an, in dem dieser Vorgang ausgeführt werden soll. Überschreibt den ausgewählten Standardmandanten. Sie können entweder die Mandanten-ID oder den Mandantennamen angeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

 azsphere device show-count
 ------
 Result
 ======
 2
 ------

show-os-version

Zeigt die aktuelle Betriebssystemversion auf dem angeschlossenen Gerät an.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device show-os-version
Your device is running Azure Sphere OS version <version-number>

In diesem Beispiel <stellt die Versionsnummer> die aktuelle Betriebssystemversion dar.

Querladen

Verwaltet die Anwendung auf dem Gerät.

Einige Querladenoptionen erfordern zusätzliche Funktionen, sobald sich das Gerät im Fertigungszustand "DeviceComplete" befindet. Mit der FieldServicing-Funktion können Sie temporäre produktionssignierte Images bereitstellen und löschen und dauerhafte produktionssignierte Images bereitstellen. Mit der AppDevelopment-Funktion können Sie sowohl signierte als auch SDK-signierte Images bereitstellen und löschen.

Vorgang	Beschreibung
Löschen	Löscht die aktuelle Anwendung vom Gerät.
deploy	Lädt eine Anwendung auf das Gerät.
set-deployment-timeout	Legt den Timeoutzeitraum für die Bereitstellung in Sekunden fest.
Show-deployment-timeout	Zeigt den Timeoutzeitraum der Bereitstellung in Sekunden an.

Beachten Sie, dass die Parameter in show-statusshow-quota stopstartden Azsphere-Geräte-App-Befehl verschoben wurden.

sideload delete

Löscht Anwendungen vom Gerät.

Dieser Befehl ist nur verfügbar, wenn die AppDevelopment-Gerätefunktion konfiguriert ist.

Optionale Parameter

Parameter	Typ	Beschreibung
-i, --component-id	GUID	Gibt die ID der Anwendung an, die vom Gerät gelöscht werden soll. Wenn diese Angabe nicht erfolgt, werden alle Anwendungen gelöscht.
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device sideload delete
Component '54acba7c-7719-461a-89db-49c807e0fa4d' deleted.

sideload deploy

Lädt eine Anwendung auf das angeschlossene Gerät und startet die Anwendung.

Dieser Befehl kann nicht ausgeführt werden, wenn das Anwendungsmanifest eine Ressource anfordert, die von einer Anwendung verwendet wird, die bereits auf dem Gerät vorhanden ist. Verwenden Sie in diesem Fall azsphere device sideload delete, um die vorhandene Anwendung zu löschen, und wiederholen Sie dann den Vorgang zum Querladen. Der Befehl zum Querladen des Azsphere-Geräts löscht sowohl High-Level-Anwendungen als auch Echtzeitanwendungen. Wenn Sie eine Anwendung löschen und die andere verlassen möchten, geben Sie die Komponenten-ID der zu löschenden Anwendung an.

Derselbe Befehl wird verwendet, um sowohl allgemeine Anwendungen als auch echtzeitfähige Anwendungen bereitzustellen.

Hinweis

Ein Geräteneustart wird ausgelöst, wenn eine neue Anwendung, die Peripheriegeräte verwendet, installiert wird und die folgenden Bedingungen erfüllt sind:

Der Fertigungszustand des Geräts ist auf DeviceComplete festgelegt.
Die AppDevelopment-Funktion ist auf dem Gerät nicht vorhanden. Weitere Informationen finden Sie unter "Sperrung der Peripheriegeräte".

Wenn ein Geräteneustart initiiert wird, warten Sie, bis der Neustart abgeschlossen ist und das Gerät reaktionsfähig wird.

Erforderliche Parameter

Parameter	Typ	Beschreibung
-p, --image-package	String	Gibt den Pfad und den Dateinamen des Imagepakets an, das auf das Gerät geladen werden soll.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.
-m, --manual-start	Boolean	Gibt an, dass die Anwendung nach dem Laden nicht automatisch gestartet werden soll.
--force	Boolean	Erzwingt die Bereitstellung eines Images, für das eine Beta-API genutzt wird, die unter Umständen nicht mehr unterstützt wird.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device sideload deploy --image-package C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage
Deploying 'C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage' to the attached device.
Image package 'C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage' has been deployed to the attached device.

Querladen von Set-deployment-timeout

Legt den Timeoutwert der Bereitstellung in Sekunden für das Querladen von Images auf dem Gerät fest.

Erforderliche Parameter

Parameter	Typ	Beschreibung
-v, --value	Ganzzahl	Gibt die Dauer in Sekunden an, bevor ein Querladen-Befehl zu einem Zeitüberschreitungsausfall wird. Der Wert muss eine positive ganze Zahl sein.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device sideload set-deployment-timeout --value 60
 ------------------
 Deployment timeout
 ==================
 60
 ------------------

Querladen von Show-Deployment-Timeout

Zeigt den aktuellen Timeoutwert der Bereitstellung in Sekunden für das Querladen von Images auf dem Gerät an.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device sideload show-deployment-timeout
 ------------------
 Deployment timeout
 ==================
 60
 ------------------

aktualisieren

Verschiebt das Gerät in eine andere Gerätegruppe in Ihrem Azure Sphere-Mandanten.

Zusätzlich zu den Gerätegruppen, die Sie in einem Produkt erstellen, werden fünf Standardgerätegruppen hinzugefügt, wenn ein Produkt erstellt wird:

Entwicklung: Akzeptiert nur Systemsoftwareupdates. Akzeptiert keine Anwendungsupdates.
Feldtest: Akzeptiert alle Updates vom Azure Sphere Security Service.
Produktion: Akzeptiert alle Updates vom Azure Sphere Security Service.
Auswertung des Produktionsbetriebssystems: Akzeptiert alle Updates vom Azure Sphere Security Service.
Field Test OS Evaluation: Akzeptiert alle Updates vom Azure Sphere Security Service.

Weitere Informationen zu grundlegenden Elementen, die an der Bereitstellung beteiligt sind, finden Sie unter "Grundlagen der Bereitstellung".

Optionale Parameter

Parameter	Typ	Beschreibung
-g, --device-group	GUID oder Name	Gibt die Gerätegruppe an, in der das Gerät verschoben werden soll. Sie können entweder die Gerätegruppen-ID oder den Gerätegruppennamen angeben. Um den Gerätegruppennamen zu verwenden, müssen Sie sowohl den Produktnamen als auch den Gerätegruppennamen im `<product-name/device-group-name>` Format angeben.
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll. Dieser Parameter ist erforderlich, wenn mehrere Geräte angeschlossen sind oder wenn kein Gerät angeschlossen ist. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können eine Geräte-ID für ein nicht angefügtes Gerät angeben oder die IP-Adresse oder die lokale Verbindungs-ID eines angeschlossenen Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.
-t, --tenant	GUID oder Name	Gibt den Mandanten an, in dem dieser Vorgang ausgeführt werden soll. Überschreibt den ausgewählten Standardmandanten. Sie können entweder die Mandanten-ID oder den Mandantennamen angeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device update --device-group AW100/Marketing
 ------------------------------------------------------------------------------------------------------ ------------------------------------ -------- ------------------------------------ ------------------------------------
 DeviceId                                                                                               TenantId                             ChipSku  ProductId                            DeviceGroupId
 ==============================================================================================================================================================================================================================
 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85 a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
 427D205E46A166B7E41135EB968
 ------------------------------------------------------------------------------------------------------ ------------------------------------ -------- ------------------------------------ ------------------------------------

Sie können den --query Parameter verwenden, um die für diesen Befehl angezeigte Ausgabe anzupassen. Weitere Informationen finden Sie unter Abfrage CLI-Befehlsausgabe.

Das folgende Beispiel zeigt, wie Sie nur die Geräte-ID und Produkt-ID auswählen:

azsphere device update --device-group AW100/Marketing  --query '{DeviceId:deviceId, ProductId:productId}'
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
 DeviceId                                                                                                                         ProductId
 =====================================================================================================================================================================
 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 6f52bead-700d-4289-bdc2-2f11f774270e
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------

wifi

Verwaltet WLAN-Konfigurationen für das angeschlossene Gerät.

Um das Gerät in einem WLAN-Netzwerk zu verwenden, müssen Sie Informationen zum Netzwerk hinzufügen und das Netzwerk auf dem Gerät aktivieren. Sie können zwar ASCII-fremde Zeichen in SSIDs eingeben, azsphere zeigt diese jedoch nicht richtig an.

Wenn Ihre Anwendung die WLAN-Konfigurations-API verwendet, müssen Sie auch die WifiConfig-Funktion in die app_manifest.json Datei der Anwendung einschließen.

Vorgang	Beschreibung
add	Fügt dem Gerät die Details eines Drahtlosnetzwerks hinzu.
disable	Deaktiviert ein Drahtlosnetzwerk auf dem Gerät.
enable	Aktiviert ein Drahtlosnetzwerk auf dem Gerät.
forget	Entfernt die Details eines Drahtlosnetzwerks vom Gerät.
list	Listet die aktuelle WLAN-Konfiguration für das Gerät auf.
reload-config	Lädt die WLAN-Konfiguration des Geräts erneut
scan	Sucht nach verfügbaren Netzwerken.
show	Zeigt Details einer WLAN-Konfiguration an
show-status	Zeigt den Status der Drahtlosschnittstelle an.

wifi add

Fügt Details eines WLAN-Netzwerks zum angeschlossenen Gerät hinzu.

Ein Gerät kann über mehrere WLAN-Verbindungen verfügen. Sie können zwar ASCII-fremde Zeichen in SSIDs eingeben, azsphere zeigt diese jedoch nicht richtig an. Sie können den --targeted-scan Parameter einschließen, um eine Verbindung mit ausgeblendeten SSIDs herzustellen. Weitere Informationen finden Sie unter Verbinden von Azure Sphere mit WLAN.

Erforderliche Parameter

Parameter	Typ	Beschreibung
-s, --ssid	String	Gibt die SSID des Netzwerks an. Bei Netzwerk-SSIDs ist die Groß-/Kleinschreibung zu beachten.

Optionale Parameter

Parameter	Typ	Beschreibung
--client-cert-id	String	[EAP-TLS] Gibt den Bezeichner (bis zu 16 Zeichen) an, der das Clientzertifikat identifiziert (sowohl den öffentlichen als auch den privaten Schlüssel enthält). Erforderlich zum Einrichten eines EAP-TLS-Netzwerks.
--client-id <user@domain>	String	[EAP-TLS] Gibt die ID an, die vom RADIUS-Server des Netzwerks für die Authentifizierung erkannt wird. Wird bei einigen EAP-TLS-Netzwerken benötigt.
--config-name	String	Gibt eine Zeichenfolge (bis zu 16 Zeichen) an, die den Namen für die Netzwerkkonfiguration angibt.
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.
--root-ca-cert-id	String	[EAP-tLS] Gibt den Bezeichner (bis zu 16 Zeichen) an, der das Stammzertifizierungsstellenzertifikat des Servers für EAP-TLS-Netzwerke identifiziert, in dem das Gerät den Server authentifiziert.
--targeted-scan	Boolean	Versucht, eine Verbindung mit einem Netzwerk herzustellen, auch wenn keine Übertragung stattfindet oder es durch Netzwerküberlastung verborgen ist.
-p, --psk	String	Gibt den WPA-/WPA2-Schlüssel für das neue Netzwerk an. Auslassen, um die SSID als offenes Netzwerk hinzuzufügen. Wenn Ihr Schlüssel ein kaufmännisches Und-Zeichen (&) enthält, setzen Sie den Schlüssel in Anführungszeichen.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device wifi add --ssid MyNetwork --psk MyPassword
Successfully added network:
 ----- -------- ------------------ --------------- ------------- ------------
 ID    SSID     ConfigurationState ConnectionState SecurityState TargetedScan
 ============================================================================
 1     MyNetwork enabled            unknown         psk           False
 ----- -------- ------------------ --------------- ------------- ------------

Wenn die Netzwerk-SSID oder der Schlüssel eingebettete Leerzeichen oder ein kaufmännisches Und-Zeichen aufweist, schließen Sie die SSID oder den Schlüssel in einfache Anführungszeichen ein. Wenn die SSID oder der Schlüssel ein Anführungszeichen enthält, versehen Sie das Anführungszeichen mit einem umgekehrten Schrägstrich als Escapezeichen. Umgekehrte Schrägstriche müssen nicht escapen, wenn sie Teil eines Werts sind. Weitere Informationen finden Sie unter Anführungszeichen und Escapezeichen. Zum Beispiel:

azsphere device wifi add --ssid "New SSID" --psk "key \'value\' with quotes"

wifi disable

Deaktiviert ein WLAN-Netzwerk auf dem angeschlossenen Gerät.

Erforderliche Parameter

Parameter	Typ	Beschreibung
-i, --id	Ganzzahl	Gibt die ID des zu deaktivierenden Netzwerks an.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device wifi disable --id 0
Successfully disabled network:
----- -------- ------------------ --------------- ------------- ------------
ID    SSID     ConfigurationState ConnectionState SecurityState TargetedScan
============================================================================
0     MyNetwork disabled           disconnected    psk           False
----- -------- ------------------ --------------- ------------- ------------

wifi enable

Aktiviert ein WLAN-Netzwerk auf dem angeschlossenen Gerät.

Um von einem Netzwerk zu einem anderen zu wechseln, wenn sich beide in Reichweite befinden, deaktivieren Sie das aktuell verbundene Netzwerk, bevor Sie das neue Netzwerk aktivieren.

Erforderliche Parameter

Parameter	Typ	Beschreibung
-i, --id	Ganzzahl	Gibt die ID des zu aktivierenden Netzwerks an.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device wifi enable --id 0
Successfully enabled network:
 ----- -------- ------------------ --------------- ------------- ------------
 ID    SSID     ConfigurationState ConnectionState SecurityState TargetedScan
 ============================================================================
 0     MyNetwork enabled            disconnected    psk           False
 ----- -------- ------------------ --------------- ------------- ------------

wifi forget

Entfernt Details eines WLAN-Netzwerks vom angeschlossenen Gerät.

Erforderliche Parameter

Parameter	Typ	Beschreibung
-i, --id	Ganzzahl	Gibt die ID des zu löschenden Netzwerks an.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device wifi forget --id 0
Successfully forgotten network.

wifi list

Listet die aktuelle WLAN-Konfiguration für das angeschlossene Gerät auf.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device wifi list
 ----- --------- ------------------ --------------- ------------- ------------
 ID    SSID      ConfigurationState ConnectionState SecurityState TargetedScan
 =============================================================================
 0     MyNetwork1 enabled            connected       psk           False
 ----- ---------  ------------------ --------------- ------------- ------------
 1     MyNetwork2 enabled            disconnected    psk           False
 ----- ---------  ------------------ --------------- ------------- ------------
 2     MyNetwork3 enabled            disconnected    eaptls        False
 ----- ---------  ------------------ --------------- ------------- ------------

wifi reload-config

Lädt die WLAN-Netzwerkkonfiguration auf dem angeschlossenen Gerät neu. Verwenden Sie diesen Befehl, nachdem Sie ein Zertifikat (Azsphere-Gerätezertifikat) hinzugefügt oder entfernt haben, um sicherzustellen, dass EAP-TLS-Netzwerke den neuesten Inhalt des Zertifikatspeichers verwenden.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device wifi reload-config
Wi-Fi configuration was successfully reloaded.

wifi scan

Suchen Sie nach verfügbaren WLAN-Netzwerken, die für das angeschlossene Gerät sichtbar sind. Der Befehl gibt bis zu 64 WLAN-Netzwerke zurück, die Anzahl der angezeigten WLAN-Netzwerke kann jedoch durch Umgebungsfaktoren wie die Dichte der Zugriffspunkte im Bereich eingeschränkt werden.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device wifi scan
----------------- ------------- ----------------- ----------- ---------
SSID              SecurityState BSSID             SignalLevel Frequency
=======================================================================
MyNetwork0        psk           <value>           -66         2442
----------------- ------------- ----------------- ----------- ---------
MyNetwork1        psk           <value>           -75         2442
----------------- ------------- ----------------- ----------- ---------
MyNetwork2        psk           <value>           -86         2412
----------------- ------------- ----------------- ----------- ---------

wifi show

Zeigt Details eines WLAN-Netzwerks auf dem angeschlossenen Gerät an.

Erforderliche Parameter

Parameter	Typ	Beschreibung
-i, --id	Ganzzahl	Gibt die ID der anzuzeigenden Netzwerkkonfiguration an.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device wifi show --id 0
 ----- --------- ------------------ --------------- ------------- ------------
 ID    SSID      ConfigurationState ConnectionState SecurityState TargetedScan
 =============================================================================
 0     MyNetwork enabled            disconnected    psk           False
 ----- --------- ------------------ --------------- ------------- ------------

wifi show-status

Zeigt den Status der WLAN-Schnittstelle auf dem angeschlossenen Gerät an.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	String	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt werden. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, DIE IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können jeweils nur ein Gerät unter Linux verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

 azsphere device wifi show-status
 ----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------
 SSID  ConfigurationState ConnectionState SecurityState Frequency Mode    KeyManagement WpaState  IpAddress     MacAddress
 ================================================================================================================================
<value> enabled            connected       psk           2412      station WPA2-PSK      COMPLETED <value>      <value>
 ----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------

Freigeben über

Gerät

app

app show-memory-stats

Optionale Parameter

Beispiel

app show-quota

Optionale Parameter

Beispiel

app show-status

Optionale Parameter

Beispiel

app start

Optionale Parameter

Beispiel

app stop

Optionale Parameter

Beispiel

capability

capability download

Erforderliche Parameter

Optionale Parameter

Beispiel

capability select

Optionale Parameter

Beispiel

capability show-attached

Optionale Parameter

Beispiel

capability update

Erforderliche Parameter

Optionale Parameter

Beispiel

Zertifikat

certificate add

Erforderliche Parameter

Optionale Parameter

Beispiel

certificate delete

Erforderliche Parameter

Optionale Parameter

Beispiel

certificate list

Optionale Parameter

Beispiel

certificate show

Erforderliche Parameter

Optionale Parameter

Beispiel

certificate show-quota

Optionale Parameter

Beispiel

claim

Optionale Parameter

Beispiel

enable-cloud-test

Optionale Parameter

Beispiele

enable-development

Optionale Parameter

Beispiel

image

image list-installed

Optionale Parameter

Beispiel

image list-targeted

Optionale Parameter

Beispiel

list

Optionale Parameter

Beispiel

list-attached

Beispiel

Fertigungszustand

manufacturing-state show

Optionale Parameter

Beispiel

manufacturing-state update

Erforderliche Parameter

Optionale Parameter