Gerät

Artikel
09/07/2023

Verwaltet Azure Sphere-Geräte.

Vorgang	Beschreibung
App	Ändert die status von Anwendungen auf einem Gerät.
Fähigkeit	Verwaltet Gerätefunktionen.
Zertifikat	Verwaltet den Gerätezertifikatspeicher.
Anspruch	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.
Bild	Verwaltet Images für ein Gerät.
Liste	Zeigt alle Geräte im Mandanten an.
list-attached	Listen die angeschlossenen Geräte.
Fertigungszustand	Verwaltet den Fertigungsstatus des angeschlossenen Geräts.
Netzwerk	Stellt Informationen zur status von Netzwerkschnittstellen auf dem Gerät bereit.
Wiederherstellen	Verwendet einen speziellen Wiederherstellungsmodus, um neue Firmware auf das Gerät zu laden.
Rescan-attached	Überprüft angeschlossene Geräte erneut als Problembehandlungshilfe (nur Windows).
Neu starten	Startet das angeschlossene Gerät neu.
Zeigen	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 die status des letzten Bereitstellungsupdates an.
show-os-version	Zeigt die Betriebssystemversion des lokalen Geräts an.
Querladen	Lädt ein Bild auf das angeschlossene Gerät.
aktualisieren	Updates ein Gerät, indem Es in einer bestimmten Gerätegruppe platziert wird.
WLAN	Verwaltet die Wi-Fi-Konfiguration für das Gerät.

App

Verwaltet Anwendungen auf dem Gerät.

Viele der App-Optionen erfordern die appDevelopment-Funktion , die mithilfe von azsphere device enable-development abgerufen werden kann. Um eine mit dem SDK signierte Anwendung oder eine in der Produktion signierte Anwendung zu starten, zu beenden oder zu debuggen, muss das Gerät über die AppDevelopment-Funktion verfügen.

Sie können azsphere device app stop und azsphere device app start verwenden, um eine ausgeführte Echtzeitanwendung neu zu starten, um zu bestimmen, auf welchem Echtzeitkern sie ausgeführt wird.

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 verwendet wird.
show-status	Gibt die status der aktuellen Anwendung auf dem Gerät zurück.
Starten	Startet die Anwendung, die auf dem Gerät geladen wird.
Stoppen	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. Weitere Informationen werden angezeigt, wenn die Speicherbelegungsnachverfolgung für den Heap konfiguriert ist.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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 änderbarem Speicher an, der auf dem angeschlossenen Gerät zugewiesen und verwendet wird.

Sie legen das änderbare Speicherkontingent im Anwendungsmanifest fest, und das Azure Sphere-Betriebssystem erzwingt Kontingente, wenn es Sektoren für die Datei zuweist. Wenn Sie den MutableStorage Wert verringern, ändert sich daher die Menge des verwendeten Speichers nicht, aber der gemeldete zugeordnete Wert unterscheidet sich. Wenn die Anwendung beispielsweise bereits 16 KB verwendet hat und Sie den MutableStorage Wert in 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	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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 die aktuelle status der Anwendungen auf dem Gerät an.

Optionale Parameter

Parameter	Typ	Beschreibung
-i, --component-id	GUID	Gibt die ID der Komponente an, für die status angezeigt werden soll. Wenn nicht angegeben, wird status aller Komponenten angezeigt.
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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 zum Debuggen. Die `--component-id` muss bereitgestellt werden.
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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 nicht angegeben, werden alle Anwendungen gestartet.

Globale Parameter

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

Parameter	Beschreibung
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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 beenden

Beendet die Anwendungen auf dem Gerät.

Optionale Parameter

Parameter	Typ	Beschreibung
-i, --component-id	GUID	Gibt die ID der komponente an, die beendet werden soll. Wenn nicht angegeben, werden alle Anwendungen beendet.
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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

Fähigkeit

Verwaltet Gerätefunktionen. Gerätefunktionen bestimmen die Vorgänge, die auf einem einzelnen Azure Sphere-Gerät ausgeführt werden können.

Die Gerätefunktionen werden mithilfe des Befehls azsphere device capability download als Datei aus dem Azure Sphere-Sicherheitsdienst heruntergeladen. Sie können die Gerätefunktionskonfiguration mit dem Befehl azsphere device capability update auf das angefügte Azure Sphere-Gerät anwenden, und Sie können eine Wartungssitzung mit dem Befehl azsphere device capability select erstellen. Weitere Informationen zu Gerätefunktionen finden Sie unter Gerätefunktionen und -kommunikation.

Vorgang	Beschreibung
Herunterladen	Lädt eine Gerätefunktionskonfiguration aus dem Azure Sphere-Sicherheitsdienst herunter.
Auswählen	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.
aktualisieren	Wendet eine Gerätefunktionskonfiguration auf das angeschlossene Gerät an.

Funktionsdownload

Lädt eine Gerätefunktion aus dem Azure Sphere-Sicherheitsdienst herunter.

Mit der AppDevelopment-Funktion können Sie SDK-signierte Anwendungen querladen und anwendungen auf dem Gerät starten, beenden, debuggen oder löschen. Ohne die AppDevelopment-Funktion können nur in die Cloud geladene Anwendungen geladen werden, und Das Starten, Beenden, Debuggen und Löschen ist verboten. Die AppDevelopment-Funktion wird als Teil des Befehls azsphere device enable-development angewendet.

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

Erforderliche Parameter

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

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	Schnur	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 angeschlossenes Gerät angeben oder die IP-Adresse oder lokale Verbindungs-ID eines angeschlossenen Geräts angeben. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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.
--Ziel	Schnur	Gibt den Pfad und Dateinamen an, unter dem die Funktionskonfiguration gespeichert werden soll. Schließen Sie einen absoluten oder relativen Pfad ein. Wenn Sie keinen Pfad angeben, speichert der Befehl die Datei im lokalen Verzeichnis unter Verwendung der Benennungskonvention <funktionstyp>< first acht Zeichen von device 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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
 --------------------------------------------

Funktionsauswahl

Wählt eine Funktionsdatei aus, die mit dem angefügten Azure Sphere-Gerät verwendet werden soll.

Der Befehl azsphere device capability select kann mit jeder Funktion verwendet werden, wird aber am häufigsten mit der fieldServicing-Funktion verwendet, um eine Wartungssitzung zu aktivieren. Jede Benutzerrolle hat Zugriff auf den Befehl azsphere device capability select .

Wenn Sie die fieldServicing-Funktion verwenden, wird die Kommunikation zwischen dem Azure Sphere-Gerät und dem lokalen Computer aktiviert, der die Funktionsdatei enthält. Die fieldServicing-Funktionsdatei wird für eine Sitzung zwischen dem lokalen Computer und dem Azure Sphere-Gerät verwendet, und jedem Befehl in der Sitzung wird eine Meldung vorangestellt, die die verwendete Funktionsdatei angibt.

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

Optionale Parameter

Parameter	Typ	Beschreibung
--capability-file	Schnur	Gibt den Pfad und den Dateinamen der auszuwählenden Konfigurationsdatei der Gerätefunktion 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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 auf dem angeschlossenen Gerät gespeicherte Funktionskonfiguration an.

Hinweis

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

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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
 --------------------

Funktionsupdate

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

Erforderliche Parameter

Parameter	Typ	Beschreibung
--capability-file	Schnur	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	Schnur	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 angeschlossenes Gerät angeben oder die IP-Adresse oder lokale Verbindungs-ID eines angeschlossenen Geräts angeben. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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

Verwaltet Zertifikate auf dem angefügten Gerät.

Vorgang	Beschreibung
Hinzufügen	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.
Liste	Listen die Zertifikat-IDs, die im Zertifikatspeicher des angefügten Geräts verfügbar sind.
Zeigen	Zeigt Details zu einem Zertifikat im Zertifikatspeicher des angefügten Geräts an.
show-quota	Zeigt den verfügbaren freien Speicherplatz im Zertifikatspeicher des angefügten Geräts an.

Zertifikat hinzufügen

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

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

Vorsicht

Da Zertifikat-IDs sowohl für Client- als auch für Stammzertifizierungsstellenzertifikate systemweit sind, kann ein azsphere-Befehl oder ein Funktionsaufruf, der ein neues Zertifikat hinzufügt, ein Zertifikat überschreiben, das von einem früheren Befehl oder Funktionsaufruf hinzugefügt wurde, was zu Netzwerkverbindungsfehlern führen kann. Es wird dringend empfohlen, eindeutige Prozeduren für die Zertifikataktualisierung zu entwickeln und Zertifikat-IDs sorgfältig auszuwählen.

Weitere Informationen finden Sie unter Zertifikat-IDs .

Erforderliche Parameter

Parameter	Typ	Beschreibung
-i, --cert-id	Schnur	Gibt den Bezeichner des hinzuzufügenden Zertifikats an. Ein Zeichenfolgenbezeichner (bis zu 16 Zeichen). Gültige Zeichen sind Großbuchstaben (A-Z), Kleinbuchstaben (a-z), Zahlen (0-9), Unterstriche (_), Punkt (.) und Bindestriche (-). Dieser Bezeichner wird auch in Wi-Fi-Konfigurationen für EAP-TLS-Netzwerke verwendet.
--cert-type	Schnur	Gibt den Typ des hinzuzufügenden Zertifikats an, entweder client oder rootca.
-p, --public-key-file	Schnur	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	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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	Schnur	Gibt den Pfad zu einer PEM-Datei des Zertifikats für den privaten Clientschlüssel an. Erforderlich beim Hinzufügen eines Zertifikats vom Typ Client. Sie können einen relativen oder absoluten Pfad angeben.
-w, --private-key-password	Schnur	Gibt ein optionales Kennwort für den privaten Clientschlüssel an. Das Kennwort ist erforderlich, wenn Sie einen verschlüsselten privaten Clientzertifikatschlüssel hinzufügen.

Globale Parameter

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

Parameter	Beschreibung
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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.

Zertifikat löschen

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

Erforderliche Parameter

Parameter	Typ	Beschreibung
-c, --certificate Oder --cert-id [Eingestellt]	Schnur	Gibt den Bezeichner des zu löschenden Zertifikats an. Das `--cert-id` Argument wird eingestellt und in einer zukünftigen Version entfernt. Weitere Informationen finden Sie unter Wichtige Änderungen (Außerbetriebnahme von Features) in der Azure Sphere-CLI.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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

Zertifikatliste

Listen die zertifikate, die im Zertifikatspeicher des Geräts verfügbar sind.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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
 -----------

Zertifikat anzeigen

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

Erforderliche Parameter

Parameter	Typ	Beschreibung
-c, --certificate Oder --cert-id [Eingestellt]	Schnur	Gibt den Bezeichner des Zertifikats an, für das die Details angezeigt werden sollen. Das `--cert-id` Argument wird eingestellt und in einer zukünftigen Version entfernt. Weitere Informationen finden Sie unter Wichtige Änderungen (Außerbetriebnahme von Features) in der Azure Sphere-CLI.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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
 ---------- ------------------- ------------------- ----------------------------------- -----------------------------------

zertifikat show-quota

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

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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
--------------

Anspruch

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

Wichtig

Bevor Sie das Gerät anfordern, stellen Sie sicher, dass Sie beim richtigen Azure Sphere-Mandanten angemeldet sind. Ein Gerät kann nur einmal beansprucht werden. Nach dem Anspruch kann ein Gerät nicht in einen anderen Mandanten verschoben werden.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	Schnur	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 angeschlossenes Gerät angeben oder die IP-Adresse oder lokale Verbindungs-ID eines angeschlossenen Geräts angeben. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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.
--Kraft	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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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

Liest das angefügte Gerät zum Testen des Ladens in die Cloud ein, indem die Anwendungsentwicklung deaktiviert, vorhandene Anwendungen gelöscht und in die Cloud geladene Anwendungsupdates aktiviert werden.

Es erfordert, dass ein Gerät an den PC angeschlossen ist und nur auf dem angeschlossenen Gerät betrieben wird.

Insbesondere enable-cloud-test:

Entfernt die AppDevelopment-Funktion für das angeschlossene Gerät.
Weist das Gerät einer Gerätegruppe zu, die in die Cloud geladene Anwendungsupdates ermöglicht.
Startet das Gerät neu.

Die spezifischen Aufgaben, die enable-cloud-test ausführt, hängen davon ab, ob diesem Gerät bereits ein Produkt und eine Gerätegruppe zugewiesen wurden.

Wenn azsphere device enable-cloud-test ohne Parameter ausgeführt wird, wird das Gerät in der Gerätegruppe Feldtest des aktuellen Produkts des Geräts platziert. Dies ist eine der Standardgerätegruppen, die automatisch für jedes Produkt erstellt werden, wodurch Anwendungsupdates aktiviert werden. Ein Fehler wird zurückgegeben, wenn das Gerät über kein Produkt verfügt oder eine Feldtest-Gerätegruppe nicht darin 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	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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 Standardgerätegruppe feldtest dieses Produkts verschoben, sofern nicht `--device-group` ebenfalls 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 Namen der Gerätegruppe angeben. Um den Gerätegruppennamen zu verwenden, müssen Sie sowohl den Produktnamen als auch den Namen der `<product-name/device-group-name>` Gerätegruppe im Format angeben. Standardmäßig ist dies die Gerätegruppe feldtest des Produkts.

Globale Parameter

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

Parameter	Beschreibung
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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 anhand seiner 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. Gerät einer anderen Gerätegruppe zuweisen

Dieses Beispiel ähnelt dem vorherigen Beispiel, behält aber das vorhandene Produkt für das Gerät bei. Hier ändert der Vorgang enable-cloud-test die Gerätegruppe, zu der das Gerät gehört, und entfernt die AppDevelopment-Funktion. Dieser Befehl ist nützlich, um ein Gerät aus einer Entwicklungsumgebung zu verschieben, die keine Anwendungsupdates in eine Produktionsumgebung ermöglicht.

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

Beispiel 3. Gerät anhand des Produktnamens zuweisen

In diesem Beispiel wird das Laden in die Cloud aktiviert und das Gerät einem Produkt anhand des Namens zugewiesen.

azsphere device enable-cloud-test --product DW100

Enable-Development

Aktiviert ein Gerät für die Entwicklung, indem das Querladen und Debuggen auf dem Gerät aktiviert und es einer Gerätegruppe zugewiesen wird, die Anwendungsupdates aus der Cloud deaktiviert. Standardmäßig ist dies die Gerätegruppe "Entwicklung" des Geräteprodukts, aber es können andere Gerätegruppen angegeben werden. Verwenden Sie nicht in Fertigungsszenarien. Weitere Informationen finden Sie unter Herstellen verbundener Geräte .

Insbesondere aktivieren Sie die Entwicklung:

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

Wenn Sie den Befehl azsphere device enable-development ohne Parameter ausführen:

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

Wenn Sie den Befehl azsphere device enable-development mit dem --product Parameter ausführen:

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

Wenn Sie den Befehl azsphere device enable-development mit dem --device-group Parameter ausführen:

Places das Gerät in der angegebenen Gerätegruppe angegeben wird. Die Zielgerätegruppe darf keine Anwendungsupdates aktivieren, andernfalls wird ein Fehler zurückgegeben.

In einigen Fällen meldet azsphere device enable-development einen Fehler und schlägt vor, dass Sie das Gerät in Anspruch nehmen. 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. Wenn 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 device claim , um das Gerät in Anspruch zu nehmen.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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 keine Angabe erfolgt, wird das Gerät einer Standardgruppe zugewiesen. Sie können entweder die Gerätegruppen-ID oder den Namen der Gerätegruppe angeben. Um den Gerätegruppennamen zu verwenden, müssen Sie sowohl den Produktnamen als auch den Namen der `<product-name/device-group-name>` Gerätegruppe im Format angeben.
-r, --enable-rt-core-debugging	Boolean	Installiert Treiber, die zum Debuggen von Anwendungen erforderlich sind, die auf einem Echtzeitkern ausgeführt werden. Diese Option erfordert Administratorberechtigungen.
-p, --product	GUID oder Name	Gibt das Zielprodukt an. Wenn Sie diesen Wert angeben, wird das Gerät in die Standardgerätegruppe Entwicklung dieses Produkts verschoben, sofern nicht `--device-group` ebenfalls 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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')

Bild

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

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

Imageliste installiert

Listen die Images, die auf dem angeschlossenen Gerät installiert sind. Die Liste der Informationen enthält die Komponenten- und Bild-IDs.

Hinweis

Lange Bildnamen werden um 31 Zeichen abgeschnitten.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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	Listen alle Softwareimages, die auf dem Gerät installiert sind. Standardmäßig listet nur Anwendungsimages, Debugger und Boardkonfigurationsimages auf.

Globale Parameter

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

Parameter	Beschreibung
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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

Bildliste als Ziel

Listen die Images, die in den Azure Sphere-Sicherheitsdienst hochgeladen wurden und installiert werden, wenn das Gerät aktualisiert wird. 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	Schnur	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 angeschlossenes Gerät angeben oder die IP-Adresse oder lokale Verbindungs-ID eines angeschlossenen Geräts angeben. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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	Listen alle Images in Ihrem Azure Sphere-Mandanten.

Globale Parameter

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

Parameter	Beschreibung
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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   
 ----------------------- ------------------------------------ ------------------------------------ -------------------------------------

Liste

Listen alle Geräte in einem Mandanten. Die Liste wird nach den ersten 500 Geräten abgeschnitten.

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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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 der CLI-Befehlsausgabe.

Das folgende Beispiel zeigt, wie Sie nur die Geräte-ID und die 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 azsphere product show --product-product-ID <> aus, um den Produktnamen anzuzeigen, oder azsphere device-group show --device-group <devicegroup-ID>, um den Namen der Gerätegruppe anzuzeigen.

list-attached

Listen die geräte, die an den lokalen PC angeschlossen sind.

Globale Parameter

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

Parameter	Beschreibung
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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 Fertigungsstatus des angeschlossenen Geräts.

Vorgang	Beschreibung
Zeigen	Zeigt den Fertigungsstatus des angeschlossenen Geräts an.
aktualisieren	Updates den Fertigungsstatus des angeschlossenen Geräts.

Vorsicht

Änderungen des Fertigungszustands sind dauerhaft und unumkehrbar.

Show "Manufacturing-State"

Zeigt den Fertigungsstatus des angeschlossenen Geräts an.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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
------------------

Aktualisierung des Fertigungszustands

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

Vorsicht

Änderungen des Fertigungszustands sind dauerhaft und unumkehrbar.

Erforderliche Parameter

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

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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.

Netzwerk

Stellt Informationen zur status von Netzwerkschnittstellen auf dem angeschlossenen Gerät bereit.

Vorgang	Beschreibung
Aktivieren	Aktiviert eine Netzwerkschnittstelle auf dem angeschlossenen Gerät.
Deaktivieren	Deaktiviert eine Netzwerkschnittstelle auf dem angeschlossenen Gerät.
list-firewall-rules	Listen die Firewallregeln für das angeschlossene Gerät.
list-interfaces	Listen die Netzwerkschnittstellen für das angeschlossene Gerät.
Proxy	Verwaltet die Netzwerkproxyeinstellungen.
show-Diagnose	Zeigt netzwerk Diagnose für ein oder alle Drahtlosnetzwerke auf dem angeschlossenen Gerät an.
show-status	Zeigt die Netzwerk-status für das angeschlossene Gerät an.
update-interface	Updates eine Netzwerkschnittstellenkonfiguration für das Gerät.

Netzwerk aktivieren

Aktiviert eine Netzwerkschnittstelle auf dem angeschlossenen Gerät.

Hinweis

Dieser Befehl wird zum Konfigurieren von Ethernet eth0 und wlan0 Verbindungen unterstützt. Wenn Sie oder azspheresvckonfigurierenlo, wird ein Fehler zurückgegeben.

Erforderliche Parameter

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

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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 zum Konfigurieren von Ethernet eth0 und wlan0 Verbindungen unterstützt. Wenn Sie oder azspheresvckonfigurierenlo, wird ein Fehler zurückgegeben.

Erforderliche Parameter

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

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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.

network list-firewall-rules

Listen die Firewallregeln für das angeschlossene Gerät.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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 Firewallregelsatzes: Zeigt den Namen des Firewallregelsatzblocks an.
- Die Werte sind PREROUTING, POSTROUTING, INPUT, FORWARD und OUTPUT.
Ist Regelsatz gültig: Zeigt die status des Regelsatzes an. Die Werte sind True oder False.
Firewallregelsatzregeln: Zeigt die Werte für die folgenden Regeln an:
- Quell-IP: Zeigt die IP-Adresse des sendenden Computers an.
- Quellmaske: 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 benutzeridentifikation an, die auf die Regel angewendet wird. 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 gelöscht werden.
- Schnittstellen-IN-Name: Zeigt den Namen der Eingabeschnittstelle an. Beispiel : wlan0.
- Name der Schnittstelle OUT: Zeigt den Namen der Ausgabeschnittstelle an. Beispiel : wlan0.
- Status: Zeigt den Verbindungsstatus an. Die Werte sind "none", "established" oder "related".
- 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, der den Datenverkehr sendet. Der Wert kann zwischen 0 und 65535 sein.
- Zielportbereich: Zeigt den Portbereich am Ziel 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 Flags ist wie folgt aufgeführt:

URG: Dringendes Zeigerfeld signifikant
ACK: Bestätigungsfeld signifikant
PSH: Pushfunktion
RST: Zurücksetzen der Verbindung
SYN: Synchronisieren von Sequenznummern
FIN: Keine Weiteren Daten vom Absender

Globale Parameter

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

Parameter	Beschreibung
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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

Listen die Netzwerkschnittstellen für das angeschlossene Gerät.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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 Verwendung von Proxyadressen 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 Herstellen einer Verbindung über einen Proxyserver.

Hinweis

Derzeit werden nur HTTP-Proxys unterstützt.

Vorgang	Beschreibung
Proxy anwenden	Konfiguriert den Netzwerkproxy auf dem angefügten Gerät.
Proxylöschung	Löscht die Proxyverbindung auf dem angefügten Gerät.
Proxy-Show	Zeigt die Proxyverbindung auf dem angefügten Gerät an.

Proxy anwenden

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

Erforderliche Parameter

Parameter	Typ	Beschreibung
-a, --address	Schnur	Gibt die Netzwerkadresse des zu verwendenden Proxys an.
-t, --authentication	Schnur	Gibt den zu verwendenden Authentifizierungstyp an. Zulässige Werte: `anonymous` oder `basic`. Wenn der Proxy einen Benutzernamen und ein Kennwort erfordert, legen Sie dies auf `basic`fest, 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	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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.
--Aktivieren	Schnur	Gibt an, ob der Proxy aktiviert werden soll. Sie müssen entweder `--enable` oder `--disable`festlegen.
--Deaktivieren	Schnur	Gibt an, ob der Proxy deaktiviert werden soll. Sie müssen entweder `--enable` oder `--disable`festlegen.
-n, --no-proxy-addresses	Schnur	Gibt ein Array von durch Leerzeichen getrennten Netzwerkadressen an, die das Gerät für die Proxyverbindung vermeiden sollte.
-p, --password	Schnur	Gibt das Kennwort für die Proxyauthentifizierung an, die nur für die Standardauthentifizierung verwendet wird. Maximale Länge: 64 Zeichen.
-u, --username	Schnur	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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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

Proxy-Show

Zeigt die Proxyverbindung auf dem angefügten Gerät an.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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
 ----------- ------- ----- ------------------ ----------------

network show-Diagnose

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

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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 Wi-Fi Netzwerks an, für das Diagnose angezeigt werden soll.

Globale Parameter

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

Parameter	Beschreibung
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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
 ------------------------- --------- ----- ------------- --------------- --------

network show-status

Zeigt die Netzwerk-status für das angeschlossene Gerät an.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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

Updates 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 zum Konfigurieren von Ethernet-Verbindungen eth0 unterstützt. Wenn Sie , oder wlan0konfigurierenlo, azspheresvc wird ein Fehler zurückgegeben.

Erforderliche Parameter

Parameter	Typ	Beschreibung
--hardware-address	Schnur	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 [Eingestellt]	Schnur	Gibt den Namen der zu konfigurierenden Schnittstelle an. Führen Sie azsphere device network list-interfaces aus, um Details der Netzwerkschnittstellen für das angefügte Gerät anzuzeigen. Das `--interface-name` Argument wird eingestellt und in einer zukünftigen Version entfernt. Weitere Informationen finden Sie unter Wichtige Änderungen (Außerbetriebnahme von Features) in der Azure Sphere-CLI.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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

Wiederherstellen

Ersetzt die Systemsoftware auf dem Gerät.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt 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	Schnur	Gibt das Gerätefunktionsimage an, das während der Wiederherstellung auf das Gerät angewendet werden soll.
-i, --images	Schnur	Gibt den Pfad zu einem Ordner an, der die Imagepakete enthält, die auf das Gerät geschrieben werden sollen. Standardmäßig werden bei der Wiederherstellung die Images im SDK verwendet, es sei denn, dieses Flag enthält einen alternativen Pfad.

Globale Parameter

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

Parameter	Beschreibung
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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 FTDI-Anschlüsse mit Strom versorgt werden, und die Gesamtanzahl der angeschlossenen Geräte wird angezeigt. Verwenden Sie diesen Befehl, um Probleme mit der Geräteverbindung unter Windows zu 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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
 -----------

Neu starten

Startet das angeschlossene Gerät neu.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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.

Zeigen

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

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	Schnur	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 angeschlossenes Gerät angeben oder die IP-Adresse oder lokale Verbindungs-ID eines angeschlossenen Geräts angeben. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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 der CLI-Befehlsausgabe.

Das folgende Beispiel zeigt, wie Sie nur die Geräte-ID und die 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 vom Gerät selbst an. Diese Details unterscheiden sich von denen, die der Azure Sphere-Sicherheitsdienst für das Gerät speichert.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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 die Bereitstellung status 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	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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 version-number> 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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 version-number> die aktuelle Betriebssystemversion dar.

Querladen

Verwaltet die Anwendung auf dem Gerät.

Einige Querladeoptionen 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 sowie permanente produktionssignierte Images bereitstellen. Mit der AppDevelopment-Funktion können Sie sowohl produktionssignierte als auch SDK-signierte Images bereitstellen und löschen.

Vorgang	Beschreibung
Löschen	Löscht die aktuelle Anwendung vom Gerät.
Bereitstellen	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 für die Bereitstellung in Sekunden an.

Beachten Sie, dass die Parameter für start, stop, show-statusund show-quota in den Befehl azsphere device app verschoben wurden.

Querladen des Löschens

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 keine Angabe erfolgt, werden alle Anwendungen gelöscht.
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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.

Querladen der Bereitstellung

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

Dieser Befehl schlägt fehl, wenn das Anwendungsmanifest eine Ressource anfordert, die von einer Anwendung verwendet wird, die sich bereits auf dem Gerät befindet. Verwenden Sie in diesem Fall azsphere device sideload delete , um die vorhandene Anwendung zu löschen, und versuchen Sie es dann erneut mit dem Querladen. Der Befehl azsphere device sideload delete löscht sowohl allgemeine Anwendungen als auch Echtzeitanwendungen. Um eine Anwendung zu löschen und die andere zu belassen, geben Sie die Komponenten-ID der zu löschenden Anwendung an.

Derselbe Befehl wird verwendet, um sowohl allgemeine Anwendungen als auch Echtzeitanwendungen bereitzustellen.

Hinweis

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

Der Fertigungsstatus des Geräts ist auf DeviceComplete festgelegt.
Die AppDevelopment-Funktion ist auf dem Gerät nicht vorhanden. Weitere Informationen finden Sie unter Sperren der Peripheriekonfiguration.

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	Schnur	Gibt den Pfad und Dateinamen des Imagepakets an, das auf das Gerät geladen werden soll.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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.
--Kraft	Boolean	Erzwingt die Bereitstellung eines Images, das eine Beta-API verwendet, die möglicherweise nicht mehr unterstützt wird.

Globale Parameter

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

Parameter	Beschreibung
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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.

sideload set-deployment-timeout

Legt den Timeoutwert für die 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 bei einem Querladenbefehl ein Zeitüberschreitungsintervall aufgetreten ist. 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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
 ------------------

sideload show-deployment-timeout

Zeigt den aktuellen Timeoutwert für die 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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-Sicherheitsdienst.
Produktion: Akzeptiert alle Updates vom Azure Sphere-Sicherheitsdienst.
Produktionsbetriebssystemauswertung: Akzeptiert alle Updates vom Azure Sphere-Sicherheitsdienst.
Feldtestbetriebssystemauswertung: Akzeptiert alle Updates vom Azure Sphere-Sicherheitsdienst.

Weitere Informationen zu grundlegenden Elementen, die bei 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 die das Gerät verschoben werden soll. Sie können entweder die Gerätegruppen-ID oder den Namen der Gerätegruppe angeben. Um den Gerätegruppennamen zu verwenden, müssen Sie sowohl den Produktnamen als auch den Namen der `<product-name/device-group-name>` Gerätegruppe im Format angeben.
-d, --device	Schnur	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 angeschlossenes Gerät angeben oder die IP-Adresse oder lokale Verbindungs-ID eines angeschlossenen Geräts angeben. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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 der CLI-Befehlsausgabe.

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

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

WLAN

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

Um das Gerät in einem Wi-Fi Netzwerk zu verwenden, müssen Sie Informationen zum Netzwerk hinzufügen und das Netzwerk auf dem Gerät aktivieren. Obwohl Sie Nicht-ASCII-Zeichen in SSIDs eingeben können, zeigt azsphere sie nicht ordnungsgemäß 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
Hinzufügen	Fügt dem Gerät die Details eines Funknetzwerks hinzu.
Deaktivieren	Deaktiviert ein Drahtlosnetzwerk auf dem Gerät.
Aktivieren	Aktiviert ein Drahtlosnetzwerk auf dem Gerät.
Vergessen	Entfernt die Details eines Drahtlosnetzwerks vom Gerät.
Liste	Listen die aktuelle Wi-Fi-Konfiguration für das Gerät.
reload-config	Lädt das Gerät Wi-Fi Konfiguration neu.
Scan	Sucht nach verfügbaren Netzwerken.
Zeigen	Zeigt Details einer Wi-Fi-Konfiguration an.
show-status	Zeigt die status der Drahtlosen Schnittstelle an.

WLAN hinzufügen

Fügt dem angeschlossenen Gerät Details zu einem Wi-Fi Netzwerk hinzu.

Ein Gerät kann über mehrere Wi-Fi Verbindungen verfügen. Obwohl Sie Nicht-ASCII-Zeichen in SSIDs eingeben können, zeigt azsphere sie nicht ordnungsgemäß 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	Schnur	Gibt die SSID des Netzwerks an. Bei Netzwerk-SSIDs wird die Groß-/Kleinschreibung beachtet.

Optionale Parameter

Parameter	Typ	Beschreibung
--client-cert-id	Schnur	[EAP-TLS] Gibt den Bezeichner (bis zu 16 Zeichen) an, der das Clientzertifikat (enthält sowohl den öffentlichen als auch den privaten Schlüssel) identifiziert. Erforderlich zum Einrichten eines EAP-TLS-Netzwerks.
--client-id <user@domain>	Schnur	[EAP-TLS] Gibt die ID an, die vom RADIUS-Server des Netzwerks für die Authentifizierung erkannt wird. Erforderlich für einige EAP-TLS-Netzwerke.
--config-name	Schnur	Gibt eine Zeichenfolge (bis zu 16 Zeichen) an, die den Namen für die Netzwerkkonfiguration angibt.
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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	Schnur	[EAP-tLS] Gibt den Bezeichner (bis zu 16 Zeichen) an, der das Stammzertifizierungsstellenzertifikat des Servers für EAP-TLS-Netzwerke identifiziert, in denen das Gerät den Server authentifiziert.
--targeted-scan	Boolean	Versucht, eine Verbindung mit einem Netzwerk herzustellen, auch wenn es nicht übertragen wird oder durch Netzwerküberlastung verborgen ist.
-p, --psk	Schnur	Gibt den WPA/WPA2-Schlüssel für das neue Netzwerk an. Lassen Sie aus, um die SSID als offenes Netzwerk hinzuzufügen. Wenn Ihr Schlüssel ein kaufmännisches Und-Zeichen (&) enthält, schließen Sie den Schlüssel in Anführungszeichen ein.

Globale Parameter

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

Parameter	Beschreibung
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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 enthält, 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, verwenden Sie einen umgekehrten Schrägstrich, um das Anführungszeichen zu escapen. Umgekehrte Schrägstriche müssen nicht mit Escapezeichen versehen werden, 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"

WLAN deaktivieren

Deaktiviert ein Wi-Fi 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	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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
----- -------- ------------------ --------------- ------------- ------------

WLAN aktivieren

Aktiviert ein Wi-Fi Netzwerk auf dem angeschlossenen Gerät.

Um von einem Netzwerk in ein anderes zu wechseln, wenn sich beide innerhalb des Bereichs 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	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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
 ----- -------- ------------------ --------------- ------------- ------------

WLAN vergessen

Entfernt Details eines Wi-Fi 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	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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.

WLAN-Liste

Listen die aktuelle Wi-Fi-Konfiguration für das angeschlossene Gerät.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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 Wi-Fi Netzwerkkonfiguration auf dem angeschlossenen Gerät neu. Verwenden Sie diesen Befehl, nachdem Sie ein Zertifikat (azsphere device certificate) hinzugefügt oder entfernt haben, um sicherzustellen, dass EAP-TLS-Netzwerke den neuesten Inhalt des Zertifikatspeichers verwenden.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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.

WLAN-Scan

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

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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
----------------- ------------- ----------------- ----------- ---------

WLAN-Show

Zeigt Details eines Wi-Fi 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	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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
 ----- --------- ------------------ --------------- ------------- ------------

wlan show-status

Zeigt die status der Wi-Fi-Schnittstelle auf dem angeschlossenen Gerät an.

Optionale Parameter

Parameter	Typ	Beschreibung
-d, --device	Schnur	Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. 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. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig 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
--Debuggen	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem `--debug` Flag generierte Ausgabe an.
-h, --help	Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf.
--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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus `table`. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle.
--Abfrage	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe .
--Ausführliche	Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie `--debug` für vollständige Debugprotokolle.

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>
 ----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------