device, devdevice, dev

Verwaltet Azure Sphere-Geräte.Manages Azure Sphere devices.

VorgangOperation BESCHREIBUNGDescription
appapp Ändert den Status von Anwendungen auf einem GerätChanges the status of applications on a device
capability, capcapability, cap Verwaltet GerätefunktionenManages device capabilities
certificate, certcertificate, cert Dient zum Verwalten des Zertifikatspeichers des GerätsManages device certificate store
claimclaim Beansprucht ein zuvor nicht beanspruchtes Gerät für den Azure Sphere-MandantenClaims a previously unclaimed device to the Azure Sphere tenant
enable-cloud-test, ectenable-cloud-test, ect Richtet ein Gerät so ein, dass Debugging deaktiviert ist und Updates empfangen werden.Sets up a device to disable debugging and receive updates
enable-development, edvenable-development, edv Richtet ein Gerät für lokales Debugging einSets up a device for local debugging
image, imgimage, img Verwaltet Images für ein GerätManages images for a device
listlist Zeigt alle Geräte im Mandanten an.Displays all devices in the tenant
list-attachedlist-attached Listet die angeschlossenen Geräte auf.Lists the attached devices
manufacturing-state, mfgmanufacturing-state, mfg Verwaltet den Fertigungszustand des angeschlossenen GerätsManages the manufacturing state of the attached device
Netzwerknetwork Enthält Informationen zum Status von Netzwerkschnittstellen auf dem Gerät.Provides information about the status of network interfaces on the device
recoverrecover Verwendet einen speziellen Wiederherstellungsmodus, um neue Firmware auf das Gerät zu ladenUses special recovery mode to load new firmware onto the device
Rescan-angefügt, RArescan-attached, ra Wiederholen angefügter Geräte als Hilfe zur Problembehandlung (nur Windows)Rescans attached devices as a troubleshooting aid (Windows only)
restartrestart Startet das angeschlossene Gerät neuRestarts the attached device
showshow Zeigt Details zur Updatekonfiguration des Geräts an.Displays details about the update configuration of the device
show-attachedshow-attached Zeigt Details zum angeschlossenen Gerät über das Gerät selbst anDisplays details about the attached device from the device itself
show-countshow-count Zeigt die Gesamtzahl der Geräte in einem Mandanten an.Shows the total number of devices in a tenant
show-deployment-statusshow-deployment-status Zeigt den Status des jüngsten Bereitstellungsupdates an.Displays the status of the most recent deployment update
show-os-versionshow-os-version Zeigt die Betriebssystemversion des lokalen Geräts an.Displays the local device operating system version
sideload, slsideload, sl Lädt ein Image auf das angeschlossene Gerät.Loads an image onto the attached device
updateupdate Aktualisiert ein Gerät, indem es in einer bestimmten Gerätegruppe platziert wirdUpdates a device by placing it in a specific device group
wifiwifi Verwaltet die WLAN-Konfiguration für das GerätManages the Wi-Fi configuration for the device

appapp

Verwaltet Anwendungen auf dem Gerät.Manages applications on the device

Für viele der App-Optionen ist die Funktion appDevelopment erforderlich, die mithilfe von azsphere enable-development abgerufen werden kann.Many of the app options require the appDevelopment capability, which can be acquired by using azsphere enable-development. Um eine SDK-signierte Anwendung oder eine für die Produktion signierte Anwendung starten, beenden oder debuggen zu können, muss das Gerät über die Funktion appDevelopment verfügen.To start, stop, or debug an SDK-signed application or a production-signed application, the device must have the appDevelopment capability.

Sie können azsphere app stop und azsphere app start verwenden, um eine ausgeführte echtzeitfähige Anwendung neu zu starten und zu ermitteln, auf welchem Echtzeitkern sie ausgeführt wird.You can use azsphere app stop and azsphere app start to restart a running real-time capable application to determine which real-time core it is running on.

VorgangOperation BESCHREIBUNGDescription
show-quotashow-quota Zeigt die Speichermenge an, die von der aktuellen Anwendung auf dem Gerät genutzt wird.Displays the amount of storage used by the current application on the device.
show-statusshow-status Gibt den Status der aktuellen Anwendung auf dem Gerät zurück.Returns the status of the current application on the device.
startstart Startet die Anwendung, die auf das Gerät geladen wird.Starts the application that is loaded on the device.
stopstop Beendet die Anwendung, die auf dem Gerät ausgeführt wird.Stops the application that is running on the device.

app show-quotaapp show-quota

Zeigt die Menge an veränderlichem Speicher an, die auf dem angefügten Gerät zugeteilt ist und verwendet wird.Displays the amount of mutable storage allocated and in use on the attached device.

Sie legen das Kontingent für den veränderlichen Speicher im Anwendungsmanifest fest, und über das Azure Sphere-Betriebssystem werden beim Zuteilen von Sektoren für die Datei Kontingente erzwungen.You set the mutable storage quota in the application manifest, and the Azure Sphere OS enforces quotas when it allocates sectors for the file. Wenn Sie den Wert MutableStorage verringern, ändert sich die Menge an Speicher daher nicht, aber der gemeldete zugeteilte Wert unterscheidet sich.As a result, if you decrease the MutableStorage value, the amount of storage in use will not change, but the allocated value reported will be different. Wenn für die Anwendung bereits 16 KB verwendet wurden und Sie den Wert MutableStorage in 8 ändern, meldet der Befehl, dass für die Anwendung 16 KB von 8 KB zugeteiltem Speicher genutzt werden.For example, if the application has already used 16 KB and you change the MutableStorage value to 8, the command reports that the application uses 16 KB of 8 KB allocated. Die Daten verbleiben auf dem Gerät.The data remains on the device.

Optionale ParameterOptional parameters

ParameterParameter BeschreibungDescription
-i, --componentid GUID-i, --componentid GUID ID der Komponente, für die die Speicherinformationen zurückgegeben werden sollen.ID of the component for which to return storage information. Wenn sie weggelassen wird, werden Informationen für alle Anwendungen angezeigt.If omitted, displays information for all applications.
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

C:\>azsphere device app show-quota

8548b129-b16f-4f84-8dbe-d2c847862e78: No mutable storage allocated.
Command completed successfully in 00:00:02.3003524.

C:\> azsphere.exe device sideload deploy -p Mt3620Blink1_Mutable.imagepackage
Deploying 'Mt3620Blink1_Mutable.imagepackage' to the attached device.
Image package 'Mt3620Blink1_Mutable.imagepackage' has been deployed to the attached device.
Command completed successfully in 00:00:04.8939438.

C:\>azsphere device app show-quota
8548b129-b16f-4f84-8dbe-d2c847862e78: No mutable storage allocated.
ee8abc15-41f3-491d-a4c7-4af49948e159: 0KB out of 16KB of mutable storage used.
Command completed successfully in 00:00:02.0410841.

app show-statusapp show-status

Zeigt den aktuellen Status der Anwendungen auf dem Gerät an.Displays the current status of the applications on the device.

Optionale ParameterOptional parameters

ParameterParameter BeschreibungDescription
-i, --componentid GUID-i, --componentid GUID ID der Komponente, deren Status angezeigt werden soll.ID of the component for which to display status. Wenn diese Angabe nicht erfolgt, wird der Status aller Komponenten angezeigt.If omitted, shows status of all components.
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device app show-status
54acba7c-7719-461a-89db-49c807e0fa4d: App state: running

Command completed successfully in 00:00:01.1103343.

app startapp start

Startet Anwendungen auf dem Gerät.Starts applications on the device.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-d, --debug-d, --debug Der Befehl startet die Anwendung für das Debuggen.Command starts the application for debugging. Erfordert „--componentid“.Requires --componentid.
-i, --componentid GUID-i, --componentid GUID ID der zu startenden Komponente.ID of the component to start. Wenn diese Angabe nicht erfolgt, werden alle Anwendungen gestartet.If omitted, starts all applications.
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device app start
54acba7c-7719-461a-89db-49c807e0fa4d: App state: running

Command completed successfully in 00:00:01.1183407.

app stopapp stop

Beendet die Anwendungen auf dem Gerät.Stops the applications on the device.

Optionale ParameterOptional parameters

ParameterParameter BeschreibungDescription
-i, --componentid GUID-i, --componentid GUID ID der zu beendenden Komponente.ID of the component to stop. Wenn diese Angabe nicht erfolgt, werden alle Anwendungen beendet.If omitted, stops all applications.
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device app stop
54acba7c-7719-461a-89db-49c807e0fa4d: App state: stopped

Command completed successfully in 00:00:01.1210256.

capability, capcapability, cap

Verwaltet Gerätefunktionen.Manages device capabilities.

Anhand der Gerätefunktionen werden die Vorgänge bestimmt, die auf einem einzelnen Azure Sphere-Gerät durchgeführt werden können.Device capabilities determine the operations that can be performed on an individual Azure Sphere device. Die Gerätefunktionen werden als Datei über den Azure Sphere-Sicherheitsdienst heruntergeladen, indem der Befehl azsphere device capability download verwendet wird. Sie können mit dem Parameter --apply auf das angeschlossene Azure Sphere-Gerät angewendet werden, oder es kann ein separater Befehl mit azsphere device capability update genutzt werden.The device capabilities are downloaded as a file from the Azure Sphere Security Service using the azsphere device capability download command and can be applied to the attached Azure Sphere device using the --apply parameter, or in a separate command using azsphere device capability update.

VorgangOperation BESCHREIBUNGDescription
Herunterladendownload Lädt eine Gerätefunktionskonfiguration vom Azure Sphere Security Service herunterDownloads a device capability configuration from the Azure Sphere Security Service
selectselect Wählt eine heruntergeladene Funktionsdatei für eine Wartungssitzung aus.Selects a downloaded capability file to use for a servicing session
show-attachedshow-attached Zeigt die Funktionskonfiguration für das angeschlossene Gerät anDisplays the capability configuration for the attached device
updateupdate Wendet eine Gerätefunktionskonfiguration auf das angeschlossene Gerät anApplies a device capability configuration to the attached device

capability downloadcapability download

Lädt eine Gerätefunktionskonfiguration über den Azure Sphere-Sicherheitsdienst herunter.Downloads a device capability from the Azure Sphere Security Service.

Mit der Funktion appDevelopment können Sie SDK-signierte Anwendungen querladen und jede Anwendung auf dem Gerät starten, beenden, debuggen oder löschen.The appDevelopment capability lets you sideload SDK-signed applications and start, stop, debug, or delete any application on the device. Ohne die Funktion appDevelopment können nur cloudgeladene Anwendungen geladen werden. Starten, Beenden, Debuggen und Löschen sind nicht zulässig.Without the appDevelopment capability, only cloud-loaded applications can be loaded and start, stop, debug, and delete are prohibited. Die Funktion appDevelopment wird im Rahmen des Befehls azsphere device enable-development angewendet.The appDevelopment capability is applied as part of the azsphere device enable-development command.

Das Herunterladen der Funktion fieldServicing führt zu einer Datei, in der die Funktion für ein einzelnes Azure Sphere-Gerät enthalten ist.Downloading the fieldServicing capability results in a file containing the capability for a single Azure Sphere device. Die Datei mit der Funktion fieldServicing wird auf Ihren lokalen Computer heruntergeladen und kann zusammen mit dem Befehl azsphere device capability select verwendet werden.The fieldServicing capability file is downloaded to your local computer and can be used in conjunction with the azsphere device capability select command.

Erforderliche ParameterRequired parameters

ParameterParameter BeschreibungDescription
-t, --type capability-type-t, --type capability-type Der Typ der Funktion.Type of capability. Zulässige Werte sind appDevelopment, fieldServicing und none.Values are appDevelopment, fieldServicing, or none. Verwenden Sie none, um die Funktion appDevelopment oder fieldServicing zu entfernen.Use none to remove the appDevelopment capability or the fieldServicing capability.

Optionale ParameterOptional parameters

ParameterParameter BeschreibungDescription
-i, --deviceid id-i, --deviceid id ID des Geräts, für das die Funktionskonfiguration abgerufen werden soll.ID of the device for which to get the capability configuration. Wenn Sie eine Geräte-ID angeben, müssen Sie auch „--output“ verwenden.If you specify a device ID, you must also use --output. Wenn diese Angabe nicht erfolgt, wird eine Funktion für das angeschlossene Gerät abgerufen.If omitted, gets a capability for the attached device.
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-o, --output Pfad-o, --output path Pfad und Dateiname, unter dem die Funktionskonfiguration gespeichert werden soll.Path and filename at which to save the capability configuration. Fügen Sie einen absoluten oder relativen Pfad ein, und Sie müssen über die Erweiterung. Cap verfügen.Include an absolute or relative path and must have the .cap extension. Wenn Sie keinen Pfad angeben, speichert der Befehl die Datei im lokalen Verzeichnis mithilfe der Benennungs * <capability type> - <first eight characters of device ID> . Konvention.*If you do not provide a path, the command will store the file in the local directory using the naming convention <capability type>-<first eight characters of device ID>.cap.
-p, --apply-p, --apply Der Befehl wendet die Gerätefunktionskonfiguration auf das angeschlossene Gerät an.Command applies the device capability configuration to the attached device. Verwenden Sie diesen Parameter nicht in Verbindung mit „--deviceid“ oder „--output“.Do not use with --deviceid or --output.
-s,--SELECT-s, --select Wählt die Geräte Funktions Konfiguration für das angeschlossene Gerät vorübergehend aus.Temporarily selects the device capability configuration for the attached device.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device capability download --type appDevelopment --output ./appdevcap

Downloading device capability configuration for device ID <device ID>.
Successfully downloaded device capability configuration.
Successfully wrote device capability configuration file './appdevcap'.
Command completed successfully in 00:00:07.7393213.

capability selectcapability select

Wählt eine Funktionsdatei für die Verwendung mit dem angeschlossenen Azure Sphere-Gerät aus.Selects a capability file to use with the attached Azure Sphere device.

Der Befehl azsphere device capability select kann mit beliebigen Funktionen verwendet werden, aber am häufigsten wird er zusammen mit der Funktion fieldServicing eingesetzt, um eine Wartungssitzung zu aktivieren.The azsphere device capability select command can be used with any capability, but is most often used with the fieldServicing capability to enable a servicing session. Alle Benutzerrollen haben Zugriff auf den Befehl azsphere device capability select.Any user role has access to the azsphere device capability select command.

Bei Verwendung der Funktion fieldServicing ist die Kommunikation zwischen dem Azure Sphere-Gerät und dem lokalen Computer mit der Funktionsdatei aktiviert.When you use the fieldServicing capability, communication is enabled between the Azure Sphere device and the local computer containing the capability file. Die Funktionsdatei fieldServicing wird für eine Sitzung zwischen dem lokalen Computer und dem Azure Sphere-Gerät verwendet, und jedem Befehl der Sitzung wird eine Meldung vorangestellt, um die genutzte Funktionsdatei anzugeben.The fieldServicing capability file is used for a session between the local computer and the Azure Sphere device, and each command in the session is prepended with a message indicating the capability file in use.

Verwenden Sie azsphere device capability select --none, um eine Wartungssitzung zu beenden.To end a servicing session, use azsphere device capability select --none.

Jede fieldServicing-Funktionsdatei ist für ein bestimmtes Azure Sphere-Gerät eindeutig.Each fieldServicing capability file is unique to a specific Azure Sphere device. Wenn Sie eine Funktionsdatei verwenden möchten, die für ein anderes Gerät bestimmt ist, erhalten Sie die folgende Meldung:If you try to use a capability file meant for another device, you will receive the following message:

error: selected capability is not compatible with device <device ID>

Optionale ParameterOptional parameters

ParameterParameter BeschreibungDescription
-f, --filepath string-f, --filepath string Der Pfad und der Dateiname für die ausgewählte Geräte Funktions Konfigurationsdatei.The path and filename to the device capability configuration file to select. Sie können einen relativen oder absoluten Pfad angeben.You may provide a relative or absolute path.
-n, --none-n, --none Löscht alle zuvor ausgewählten Gerätefunktionskonfigurationen.Clears any previously selected device capability configuration.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device capability select --filepath <file path>

capability show-attachedcapability show-attached

Zeigt die Funktionskonfiguration an, die auf dem angeschlossenen Gerät gespeichert ist.Displays the capability configuration stored on the attached device.

Hinweis

Mit dem Befehl werden die Funktionen angezeigt, die mithilfe einer Funktions Datei konfiguriert wurden, und einige, jedoch nicht alle Funktionen, die standardmäßig auf Boards vorhanden sind.The command displays the capabilities configured using a capability file and some, but not all, capabilities present by default on boards.

Optionale ParameterOptional parameters

ParameterParameter BeschreibungDescription
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device capability show-attached
Device Capabilities:
        Enable App development
Command completed successfully in 00:00:00.8746160.

capability updatecapability update

Wendet eine Gerätefunktionskonfiguration auf das angeschlossene Gerät an.Applies a device capability configuration to the attached device.

Erforderliche ParameterRequired parameters

ParameterParameter BESCHREIBUNGDescription
-f, --filepath Pfad-f, --filepath path Der Pfad und der Dateiname der anzuwendenden Geräte Funktions Datei.The path and filename of the device capability file to apply. Sie können einen relativen oder absoluten Pfad angeben.You may provide a relative or absolute path.

Optionale ParameterOptional parameters

ParameterParameter BeschreibungDescription
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device capability update --filepath appdevcap

Applying device capability configuration to device.
Successfully applied device capability configuration to device.
The device is rebooting.
Command completed successfully in 00:00:07.7393213.

certificate, certcertificate, cert

Dient zum Verwalten der Zertifikate auf dem angeschlossenen GerätManages certificates on the attached device.

VorgangOperation BESCHREIBUNGDescription
addadd Fügt dem Zertifikatspeicher auf dem Gerät ein Zertifikat hinzuAdds a certificate to the certificate store on the device
deletedelete Löscht ein Zertifikat aus dem Zertifikatspeicher des GerätsDeletes a certificate from teh device's certificate store
listlist Listet die Zertifikat-IDs auf, die im Zertifikatspeicher verfügbar sindLists the certificate IDs that are available in the certificate store
showshow Zeigt Details zu einem einzelnen Zertifikat im Zertifikatspeicher des Geräts anDisplays details of an individual certificate in the device's certificate store
show-quotashow-quota Zeigt den verfügbaren freien Speicherplatz im Zertifikatspeicher des Geräts anDisplays the available free space in the device's certificate store

certificate addcertificate add

Fügt dem Zertifikatspeicher des angefügten Geräts ein Zertifikat hinzu.Adds a certificate to the certificate store of the attached device.

Achtung

Da Zertifikat-IDs systemweit für Clientzertifikate und Zertifikate der Stammzertifizierungsstelle gelten, kann ein azsphere-Befehl oder ein Funktionsaufruf, der ein neues Zertifikat hinzufügt, ein Zertifikat überschreiben, das mit einem früheren Befehl oder Funktionsaufruf hinzugefügt wurde. Dies kann Netzwerkverbindungsfehler verursachen.Because certificate IDs are system-wide for both client and Root CA certificates, an azsphere command or a function call that adds a new certificate can overwrite a certificate that was added by an earlier command or function call, potentially causing network connection failures. Es wird dringend empfohlen, klare Verfahren zum Aktualisieren von Zertifikaten zu entwickeln und Zertifikat-IDs sorgfältig auszuwählen.We strongly recommend that you develop clear certificate update procedures and choose certificate IDs carefully.

Weitere Informationen finden Sie unter Zertifikat-IDs.See Certificate IDs for more information.

Erforderliche ParameterRequired parameters

ParameterParameter BESCHREIBUNGDescription
-i, --certid Zeichenfolge-i, --certid string Ein Anzeigename für das hinzuzufügende Zertifikat.A friendly name for the certificate to add. Ein Zeichenfolgenbezeichner (max. 16 Zeichen).A string identifier (up to 16 characters). Gültige Zeichen sind „A“ bis „Z“, „a“ bis „z“, „0“ bis „9“, „.“ und „-“ und „“.Valid characters include 'A' to 'Z', 'a' to 'z', '0' to '9', '.' or '-' or ''. Dieser Bezeichner wird auch in WLAN-Konfigurationen für EAP-TLS-Netzwerke verwendet.This identifier is also used in Wi-Fi configurations for EAP-TLS networks.
-t, --certtype Zeichenfolge-t, --certtype string Der Typ des hinzuzufügenden Zertifikats, entweder „client“ oder „rootca“.The type of certificate to add, either "client" or "rootca".
-pubk, --publickeyfilepath Zeichenfolge-pubk, --publickeyfilepath string Der Pfad zur PEM-Datei eines Zertifikats mit öffentlichem Schlüssel.The path to a public key certificate .pem file. Sie können einen relativen oder absoluten Pfad angeben.You can provide a relative or absolute path.

Optionale ParameterOptional parameters

ParameterParameter BeschreibungDescription
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is required only when multiple devices are attached. Sie können entweder eine Geräte-IP-Adresse oder einen Gerätestandort angeben.You can specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is required only when multiple devices are attached. Sie können entweder eine Geräte-IP-Adresse oder einen Gerätestandort angeben.You can specify either a device IP or device location.
-prvk, --privatekeyfilepath Zeichenfolge-prvk, --privatekeyfilepath string Der Pfad zur PEM-Datei eines Clientzertifikats mit öffentlichem Schlüssel.The path to a client private key certificate .pem file. Erforderlich, wenn ein Zertifikat vom Typ „client“ hinzugefügt wird.Required when adding a certificate of type "client". Sie können einen relativen oder absoluten Pfad angeben.You can provide a relative or absolute path.
-pwd, --privatekeypassword Zeichenfolge-pwd, --privatekeypassword string Optionales Kennwort für den privaten Clientschlüssel.Optional password for the client private key. Das Kennwort ist erforderlich, wenn ein verschlüsselter privater Schlüssel für das Clientzertifikat hinzugefügt wird.The password is required when adding a client certificate private key that is encrypted.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

- azsphere device certificate add --certid TestRootCACert --certtype rootca --publickeyfilepath rootca-test.pem
Certificate 'TestRootCACert' successfully added.

- azsphere device certificate add --certid "server-key-xyz" --certtype rootca --publickeyfilepath <filepath_to_server_ca_public.pem>
Certificate 'server-key-xyz' successfully added.

certificate deletecertificate delete

Löscht ein Zertifikat aus dem Zertifikatspeicher des GerätsDeletes a certificate from the device's certificate store.

Erforderliche ParameterRequired parameters

ParameterParameter BESCHREIBUNGDescription
-i, --certid Zeichenfolge-i, --certid string Der Bezeichner des zu löschenden ZertifikatsThe identifier of the certificate to delete.

Optionale ParameterOptional parameters

ParameterParameter BeschreibungDescription
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is required only when multiple devices are attached. Sie können entweder eine Geräte-IP-Adresse oder einen Gerätestandort angeben.You can specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is required only when multiple devices are attached. Sie können entweder eine Geräte-IP-Adresse oder einen Gerätestandort angeben.You can specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device certificate delete --certid <cert id>

Successfully deleted certificate <cert id>.

certificate listcertificate list

Listet die Zertifikat-IDs auf, die im Zertifikatspeicher verfügbar sindLists the certificate IDs that are available in the certificate store.

Optionale ParameterOptional parameters

ParameterParameter BeschreibungDescription
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is required only when multiple devices are attached. Sie können entweder eine Geräte-IP-Adresse oder einen Gerätestandort angeben.You can specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is required only when multiple devices are attached. Sie können entweder eine Geräte-IP-Adresse oder einen Gerätestandort angeben.You can specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device certificate list

Stored certificates:
- SmplClientCertId
- SmplRootCACertId

certificate showcertificate show

Zeigt Details zu einem einzelnen Zertifikat im Zertifikatspeicher des Geräts anShows details of an individual certificate in the device's certificate store.

Erforderliche ParameterRequired parameters

ParameterParameter BESCHREIBUNGDescription
-i, --certid Zeichenfolge-i, --certid string Der Bezeichner des anzuzeigenden ZertifikatsThe identifier of the certificate to show.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is required only when multiple devices are attached. Sie können entweder eine Geräte-IP-Adresse oder einen Gerätestandort angeben.You can specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is required only when multiple devices are attached. Sie können entweder eine Geräte-IP-Adresse oder einen Gerätestandort angeben.You can specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device certificate show --certid SmplClientCertId

Cert ID : SmplClientCertId
Start Date : 2020-04-22T22:07:12
Expiry Date : 2022-04-22T22:17:12
Subject Name : /CN=user@azuresphere.com
Issuer Name : /DC=com/DC=azuresphere/CN=azuresphere-CA

azsphere device certificate show --certid SmplRootCACertId

Cert ID : SmplRootCACertId
Start Date : 2020-03-22T16:33:47
Expiry Date : 2050-03-22T16:43:46
Subject Name : /DC=com/DC=azuresphere/CN=azuresphere-CA
Issuer Name : /DC=com/DC=azuresphere/CN=azuresphere-CA

certificate show-quotacertificate show-quota

Zeigt den verfügbaren freien Speicherplatz im Zertifikatspeicher des Geräts anDisplays the available free space in the device's certificate store.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is required only when multiple devices are attached. Sie können entweder eine Geräte-IP-Adresse oder einen Gerätestandort angeben.You can specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is required only when multiple devices are attached. Sie können entweder eine Geräte-IP-Adresse oder einen Gerätestandort angeben.You can specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device certificate show-quota

<n> bytes available for certificate and password storage.

Anspruchclaim

Beansprucht ein zuvor nicht beanspruchtes Gerät für den aktuellen Azure Sphere-Mandanten.Claims a previously unclaimed device for the current Azure Sphere tenant.

Wichtig

Stellen Sie vor dem Beanspruchen des Geräts sicher, dass Sie beim richtigen Azure Sphere-Mandanten angemeldet sind.Before you claim the device, ensure that you are signed in to the correct Azure Sphere tenant. Ein Gerät kann nur einmal beansprucht werden.A device can be claimed only once. Sobald ein Gerät beansprucht wurde, kann es nicht mehr in einen anderen Mandanten verschoben werden.Once claimed, a device cannot be moved to a different tenant.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-i, --deviceid GUID-i, --deviceid GUID ID des zu beanspruchenden Geräts.ID of the device to claim. Wenn diese Angabe nicht erfolgt, beansprucht azsphere das angeschlossene Gerät.If omitted, azsphere claims the attached device.
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device claim

Claiming device.
Claiming attached device ID <device ID> into tenant ID 'd343c263-4aa3-4558-adbb-d3fc34631800'.
Successfully claimed device ID <device ID> into tenant 'Microsoft' with ID 'd343c263-4aa3-4558-adbb-d3fc34631800'.
Command completed successfully in 00:00:05.5459143.

enable-cloud-test, ectenable-cloud-test, ect

Bereitet das angeschlossene Gerät für das Testen des Cloudladens vor, indem die Anwendungsentwicklung deaktiviert wird, alle vorhandenen Anwendungen gelöscht und cloudgeladene Anwendungsupdates aktiviert werden.Readies the attached device for testing cloud loading by disabling application development, deleting any existing applications, and enabling cloud-loaded application updates.

Damit dieser Vorgang ausgeführt werden kann, muss ein Gerät mit dem PC verbunden sein, und die Ausführung erfolgt nur für das angeschlossene Gerät.It requires a device to be attached to the PC and operates only on the attached device.

Insbesondere enable-cloud-test:Specifically, enable-cloud-test:

  • Entfernt die Funktion appDevelopment für das angeschlossene GerätRemoves the appDevelopment capability for the attached device
  • Weist das Gerät einer Gerätegruppe zu, die cloudgeladene Anwendungsupdates erlaubt.Assigns the device to a device group that enables cloud-loaded application updates
  • Neustarten des GerätsReboots the device

Die spezifischen Aufgaben, die enable-cloud-test ausführt, sind davon abhängig, ob bereits ein Produkt und eine Gerätegruppe für dieses Gerät zugewiesen wurden.The specific tasks that enable-cloud-test performs depend on whether a product and device group have already been assigned for this device.

Wenn azsphere device enable-cloud-test ohne Parameter ausgegeben wird, wird das Gerät in der Gerätegruppe „Field Test“ des aktuellen Produkts des Geräts platziert.If azsphere device enable-cloud-test is issued without parameters, the device will be placed in the "Field Test" device group of the device's current product. Dies ist eine der Standardgerätegruppen, die automatisch für jedes Produkt erstellt werden, wodurch Anwendungsupdates ermöglicht werden.This is one of the default device groups created automatically for each product, which enables application updates. Ein Fehler wird ausgegeben, wenn auf dem Gerät kein Produkt vorhanden oder keine Gerätegruppe „Field Test“ vorhanden ist.An error will be given if the device doesn't have a product, or a "Field Test" device group doesn't exist within it.

Wenn ein Produkt angegeben ist, wird das Gerät in der Gerätegruppe „Field Test“ dieses Produkts platziert.If a product is specified, the device will be placed in the "Field Test" device group of that product. Wenn diese Gerätegruppe nicht vorhanden ist, wird ein Fehler ausgegeben.An error will be given if this device group doesn't exist.

Wenn eine Gerätegruppe angegeben ist, wird das Gerät darin platziert.If a device group is specified, the device will be placed in it. Wenn die Zielgerätegruppe keine Anwendungsupdates ermöglicht, wird ein Fehler ausgegeben.An error will be given if the target device group doesn't enable application updates.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-dgi, --devicegroupid GUID-dgi, --devicegroupid GUID ID der Gerätegruppe, der das Gerät zugewiesen werden soll.ID of the device group to which to assign the device. Wenn diese Angabe nicht erfolgt, wird das Gerät einer Standardgruppe zugewiesen, die Anwendungsupdates zulässt.If omitted, assigns the device to a default group that enables application updates. Kann nicht in Verbindung mit „--newdevicegroupname“ verwendet werden.Cannot be used with --newdevicegroupname.
-dgn, --devicegroupname Zeichenfolge-dgn, --devicegroupname string Name der Gerätegruppe.Name of the device group. Mit „--productname“ verwenden, um den Befehl auf eine Gerätegruppe anzuwenden, oder „--devicegroupid“ verwenden.Use with --productname to apply command to a device group, or use --devicegroupid.
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-pi, --productid GUID-pi, --productid GUID ID eines vorhandenen Produkts, das auf das Gerät angewendet werden soll.ID of an existing product to apply to the device. Wenn angegeben, wird das Gerät in die Standardgerätegruppe „Field Test“ dieses Produkts verschoben, es sei denn, „--devicegroupname“ ist ebenfalls angegeben.If specified, the device will be moved to the default "Field Test" device group of this product, unless --devicegroupname is also specified.
-pn, --productname Zeichenfolge-pn, --productname string Name eines vorhandenen Produkts.Name of an existing product. Mit „--devicegroupname“ verwenden, um eine Gerätegruppe innerhalb des Produkts anzugeben, oder „--devicegroupid“ verwenden.Use with --devicegroupname to specify a device group within the product, or use --devicegroupid.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

Beispiel 1:Example 1. Zuweisen eines Geräts zu einer vorhandenen Gerätegruppe über seine IDAssign device to existing device group by its ID

In diesem Beispiel wird das angeschlossene Gerät einem vorhandenen Produkt und einer vorhandenen Gerätegruppe zugewiesen.This example assigns the attached device to an existing product and device group.

azsphere device enable-cloud-test --devicegroupid ba23a5ed-f1a8-4d54-9513-5cad5d53598e

Getting device group by ID 'ba23a5ed-f1a8-4d54-9513-5cad5d53598e'.
Removing applications from device.
Removing debugging server from device.
Component '8548b129-b16f-4f84-8dbe-d2c847862e78' deleted or was not present beforehand.
Successfully removed applications from device.
Locking device.
Downloading device capability configuration for device ID <device ID>.
Successfully downloaded device capability configuration.
Applying device capability configuration to device.
Successfully applied device capability configuration to device.
The device is rebooting.
Successfully locked device.
Setting device group 'ba23a5ed-f1a8-4d54-9513-5cad5d53598e' for the device.
(Device ID: <device ID>)
Successfully updated device's device group.
Successfully set up device for application updates.
(Device ID: <device ID>)

Beispiel 2:Example 2. Zuweisen einer anderen Gerätegruppe für das GerätAssign device to different device group

Dieses Beispiel ähnelt dem vorherigen Beispiel, wobei hier das vorhandene Produkt für das Gerät beibehalten wird.This example is similar to the preceding example, but retains the existing product for the device. Hier ändert der Vorgang enable-cloud-test die Gerätegruppe, zu der das Gerät gehört, und entfernt die Funktion „appDevelopment“.Here the enable-cloud-test operation changes the device group to which the device belongs and removes the appDevelopment capability. Dieser Befehl ist nützlich, wenn Sie ein Gerät aus einer Entwicklungsumgebung, in der keine Anwendungsupdates zulässig sind, in eine Produktionsumgebung verschieben möchten, die Anwendungsupdates zulässt.This command is useful for moving a device from a development environment that does not enable application updates to a production environment that does.

azsphere device enable-cloud-test --devicegroupname "Field Test"

Getting device group 'Field Test' for product 'MyToasterWithDgs'.
Removing applications from device.
Removing debugging server from device.
Component '8548b129-b16f-4f84-8dbe-d2c847862e78' deleted or was not present beforehand.
Successfully removed applications from device.
Locking device.
Downloading device capability configuration for device ID <device ID>.
Successfully downloaded device capability configuration.
Applying device capability configuration to device.
Successfully applied device capability configuration to device.
The device is rebooting.
Successfully locked device.
Setting device group '5ac17dc0-85ce-4e5e-9d8b-8708355da252' for the device.
(Device ID: <device ID>)
Successfully updated device's device group.
Successfully set up device for application updates.
(Device ID: <device ID>)
Command completed in 00:00:17.8082885.

Beispiel 3:Example 3. Zuweisen eines Geräts mittels ProduktnameAssign device by product name

In diesem Beispiel wird Cloudladen aktiviert, und das Gerät wird einem Produkt anhand des Namens zugewiesen.This example enables cloud loading and assigns the device to a product by name.

azsphere device enable-cloud-test --productname NewToaster
Getting device group 'Field Test' for product 'NewToaster'.
Removing applications from device.
Removing debugging server from device.
Component '8548b129-b16f-4f84-8dbe-d2c847862e78' deleted or was not present beforehand.
Successfully removed applications from device.
Locking device.
Downloading device capability configuration for device ID <device ID>.
Successfully downloaded device capability configuration.
Applying device capability configuration to device.
Successfully applied device capability configuration to device.
The device is rebooting.
Successfully locked device.
Setting device group '78674bd6-02a8-4a1c-9480-80fff039203f' for the device.
(Device ID: <device ID>)
Successfully updated device's device group.
Successfully set up device for application updates.
(Device ID: <device ID>)

enable-development, edvenable-development, edv

Richtet das angeschlossene Gerät für lokales Debugging ein und deaktiviert cloudgeladene Anwendungsupdates.Sets up the attached device for local debugging and disables cloud-loaded application updates.

Insbesondere enable-development:Specifically, enable-development:

  • Herunterladen und Anwenden der Funktion appDevelopment für/auf das angeschlossene GerätDownloads and applies the appDevelopment capability for the attached device
  • Weist das Gerät einer Gerätegruppe zu, die keine cloudgeladenen Anwendungsupdates zulässt.Assigns the device to a device group that does not enable cloud-loaded application updates
  • Neustarten des GerätsReboots the device

Wenn Sie den Befehl azsphere device enable-development ohne Parameter ausgeben:If you issue the azsphere device enable-development command with no parameters:

  • Wenn das Gerät noch nicht über ein Produkt oder eine Gerätegruppe verfügt, lädt der Befehl die Funktion appDevelopment für das angeschlossene Gerät herunter, wendet sie an und startet das Gerät neu.If the device doesn't already have a product or device group, the command downloads and applies the appDevelopment capability for the attached device, and reboots the device. Alle vorhandenen Apps verbleiben auf dem Gerät, und das Betriebssystem wird aktualisiert.Any existing apps remain on the device, and the OS is updated. Daher ist der Installationsvorgang zum Beanspruchen Ihres Geräts und der Schnellstart zum Erstellen einer Anwendung auf hoher Ebene davon nicht betroffen.Therefore, the install process to claim your device and the Quickstart to build a high-level application will be unaffected.
  • Wenn das Gerät bereits über ein Produkt verfügt, verschiebt der Befehl das Gerät in die Gerätegruppe Development (Entwicklung) des Produkts.If the device already has a product, the command moves the device to the product's Development device group. Anwendungsupdates sind standardmäßig für diese Gruppe deaktiviert. Hierdurch wird sichergestellt, dass quergeladene Apps nicht überschrieben werden.By default, application updates are disabled for this group, thus ensuring that sideloaded apps are not overwritten.

Wenn Sie den Befehl azsphere device enable-development mit dem Parameter „--productname“ ausgeben:If you issue the azsphere device enable-development command with the --productname parameter:

  • Platziert das Gerät in der Gerätegruppe „Development“ für das Produkt.Places the device in the "Development" device group for the product. Wenn diese Gerätegruppe nicht vorhanden ist, wird ein Fehler ausgegeben.An error occurs if this device group doesn't exist.

Wenn Sie den Befehl azsphere device enable-development mit dem Parameter „--devicegroupid“ ausgeben:If you issue the azsphere device enable-development command with the --devicegroupid parameter:

  • Platziert das Gerät in der angegebenen Gerätegruppe.Places the device in the specified device group is specified. Die Zielgerätegruppe darf keine Anwendungsupdates ermöglichen. Wenn die Gerätegruppe Anwendungsupdates ermöglicht, tritt ein Fehler auf.The target device group must not enable application updates; if the device group enables application updates, an error occurs.

In einigen Fällen meldet azsphere device enable-development einen Fehler und schlägt vor, dass Sie das Gerät beanspruchen.In some cases, azsphere device enable-development reports an error and suggests that you claim the device. 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.If you have already claimed the device, use azsphere tenant show-selected to ensure that you are logged in to the tenant in which you claimed the device. Falls nicht, verwenden Sie azsphere login, um sich beim richtigen Mandanten anzumelden.If not, use azsphere login to log into the correct tenant. Wenn Sie sicher sind, dass Sie beim richtigen Mandanten angemeldet sind, verwenden Sie „azsphere device claim“, um das Gerät zu beanspruchen.When you're sure you're logged into the appropriate tenant, use azsphere device claim to claim the device.

Optionale ParameterOptional parameters

ParameterParameter BeschreibungDescription
-dgi, --devicegroupid GUID-dgi, --devicegroupid GUID ID einer Gerätegruppe, die keine OTA-Anwendungsupdates anwendet.ID of a device group that does not apply over-the-air application updates. Wenn diese Angabe nicht erfolgt, wird das Gerät einer Standardgruppe zugewiesen.If omitted, assigns the device to a default group.
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-dgn, --devicegroupname Zeichenfolge-dgn, --devicegroupname string Name der Gerätegruppe.Name of the device group. Mit „--productname“ verwenden, um den Befehl auf eine Gerätegruppe anzuwenden, oder „--devicegroupid“ verwenden.Use with --productname to apply command to a device group, or use --devicegroupid.
-r, --enablertcoredebugging-r, --enablertcoredebugging Der Befehl installiert Treiber, die zum Debuggen von Anwendungen mit Ausführung auf einem Echtzeitkern benötigt werden.Command installs drivers required to debug applications running on a real-time core. Für diese Option sind Administratorberechtigungen erforderlich.This option requires administrator permissions.
-pi, --productid GUID-pi, --productid GUID ID eines vorhandenen Produkts, das auf das Gerät angewendet werden soll.ID of an existing product to apply to the device. Wenn angegeben, wird das Gerät in die Standardgerätegruppe „Development“ dieses Produkts verschoben, es sei denn, „--devicegroupname“ ist ebenfalls angegeben.If specified, the device will be moved to the default "Development" device group of this product, unless --devicegroupname is also specified.
-pn, --productname Zeichenfolge-pn, --productname string ProduktnameProduct name. Mit „--devicegroupname“ verwenden, um den Befehl auf eine Gerätegruppe anzuwenden, oder „--devicegroupid“ verwenden.Use with --devicegroupname to apply command to a device group, or use --devicegroupid.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device enable-development --enablertcoredebugging

Installing USB drivers to enable real-time core debugging.
Drivers installed for all attached devices
Getting device capability configuration for application development.
Downloading device capability configuration for device ID <device ID>.
Successfully downloaded device capability configuration.
Successfully wrote device capability configuration file 'C:\Users\Administrator\AppData\Local\Temp\tmpD15E.tmp'.
Setting device group ID '63bbe6ea-14be-4d1a-a6e7-03591d882b42' for device with ID <device ID>.
Successfully disabled over-the-air updates.
Enabling application development capability on attached device.
Applying device capability configuration to device.
Successfully applied device capability configuration to device.
The device is rebooting.
Application development capability enabled.
Successfully set up device <device ID> for application development, and disabled over-the-air updates.
Command completed successfully in 00:00:07.7393213.

image, imgimage, img

Gibt Informationen zu den Images zurück, die auf dem angeschlossenen Gerät installiert oder darauf ausgerichtet sind.Returns information about the images that are installed on or targeted to the attached device.

VorgangOperation BESCHREIBUNGDescription
list-installedlist-installed Stellt Details zu den Images bereit, die aktuell auf dem angeschlossenen Gerät installiert sindProvides details about the images that are currently installed on the attached device
list-targetedlist-targeted Stellt Details zu den Images bereit, die auf das angeschlossene Gerät ausgerichtet sind.Provides details about the images that are targeted to the attached device.

image list-installedimage list-installed

Listet die Images auf, die auf dem angeschlossenen Gerät installiert sind.Lists the images that are installed on the attached device. Die Liste mit den Informationen enthält die Komponenten- und Image-IDs.The list of information includes the component and image IDs.

Hinweis

Lange Imagenamen werden auf 15 Zeichen gekürzt.Long image names will be truncated at 15 characters.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-f, --full-f, --full Die Liste enthält alle Softwareimages, die auf dem Gerät installiert sind.All software images that are installed on the device are included in the list. Standardmäßig werden nur Anwendungsimages, Debugger und Boardkonfigurationsimages aufgeführt.By default, lists only application images, debuggers, and board configuration images.
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device image list-installed
Installed images:
 --> gdbserver
   --> Image type:   Application
   --> Component ID: 8548b129-b16f-4f84-8dbe-d2c847862e78
   --> Image ID:     43d2707f-0bc7-4956-92c1-4a3d0ad91a74
 --> Mt3620Blink4
   --> Image type:   Application
   --> Component ID: 970d2ff1-86b4-4e50-9e80-e5af2845f465
   --> Image ID:     e53ce989-0ecf-493d-8056-fc0683a566d3
Command completed successfully in 00:00:01.6189314.

image list-targetedimage list-targeted

Listet die Images auf, die in den Azure Sphere Security Service hochgeladen wurden und bei der nächsten Aktualisierung des Geräts installiert werden.Lists the images that have been uploaded to the Azure Sphere Security Service and will be installed the next time the device is updated.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-f, --full-f, --full Die Liste enthält alle Softwareimages, die auf dem Gerät installiert werden.All software images that will be installed on the device are included in the list. Standardmäßig werden nur Anwendungsimages aufgelistet.By default, lists only application images.
-i, --deviceid GUID-i, --deviceid GUID Gibt die ID des Geräts an, für das Zielimages aufgelistet werden sollen.Specifies the ID of the device for which to list targeted images. Standardmäßig werden die Images für das angeschlossene Gerät aufgelistet.By default, lists images for the attached device.
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device image list-targeted

Successfully retrieved the current image set for device with ID <device ID> from your Azure Sphere tenant:
 --> ID:   [6e9cdc9d-c9ca-4080-9f95-b77599b4095a]
 --> Name: 'ImageSet-Mt3620Blink1-2018.07.19-18.15.42'
Images to be installed:
 --> [ID: 116c0bc5-be17-47f9-88af-8f3410fe7efa]
Command completed successfully in 00:00:04.2733444.

listlist

Listet alle Geräte in einem Mandanten auf.Lists all devices in a tenant. Listen werden nach den ersten 500 Geräten abgeschnitten.Lists truncates after first 500 devices.

Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device list

list-attachedlist-attached

Listet die Geräte auf, die an den lokalen PC angeschlossen sind.Lists the devices attached to the local PC.

Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device list-attached

manufacturing-state, mfgmanufacturing-state, mfg

Verwaltet den Fertigungszustand des angeschlossenen Geräts.Manages the manufacturing state of the attached device.

VorgangOperation BESCHREIBUNGDescription
showshow Zeigt den Fertigungszustand des angeschlossenen Geräts anDisplays the manufacturing state of the attached device
updateupdate Aktualisiert den Fertigungszustand des angeschlossenen GerätsUpdates the manufacturing state of the attached device

Achtung

Änderungen am Fertigungszustand sind dauerhaft und können nicht rückgängig gemacht werden.Manufacturing state changes are permanent and irreversible.

manufacturing-state showmanufacturing-state show

Zeigt den Fertigungszustand des angeschlossenen Geräts an.Displays the manufacturing state of the attached device.

Optionale ParameterOptional parameters

ParameterParameter BeschreibungDescription
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device manufacturing-state show
Manufacturing State: AllComplete
Command completed successfully in 00:00:00.9005143.

manufacturing-state updatemanufacturing-state update

Aktualisiert den Fertigungszustand des angeschlossenen Geräts, sofern der Zustand nicht bereits „AllComplete“ lautet.Updates the manufacturing state of the attached device if the state is not already AllComplete.

Dieser Befehl ist für die Verwendung während des Fertigungsprozesses vorgesehen.This command is intended for use during the manufacturing process.

Achtung

Änderungen am Fertigungszustand sind dauerhaft und können nicht rückgängig gemacht werden.Manufacturing state changes are permanent and irreversible.

Erforderliche ParameterRequired parameters

ParameterParameter BESCHREIBUNGDescription
-s, --state SettableManufacturingStates-s, --state SettableManufacturingStates Der für das Gerätfestzulegenden Fertigungszustand.Manufacturing state to set for the device.

Optionale ParameterOptional parameters

ParameterParameter BeschreibungDescription
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is required only when multiple devices are attached. Sie können entweder eine Geräte-IP-Adresse oder einen Gerätestandort angeben.You can specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is required only when multiple devices are attached. Sie können entweder eine Geräte-IP-Adresse oder einen Gerätestandort angeben.You can specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device manufacturing-state update --state AllComplete
Manufacturing State: AllComplete
Command completed successfully in 00:00:00.9005143.

Netzwerknetwork

Enthält Informationen zum Status von Netzwerkschnittstellen auf dem angeschlossenen Gerät.Provides information about the status of network interfaces on the attached device.

VorgangOperation BESCHREIBUNGDescription
Auflisten von Firewallregelnlist-firewall-rules Listet die Firewallregeln für das angeschlossene Gerät auf.Lists the firewall rules for the attached device.
Listen Schnittstellenlist-interfaces Listet die Netzwerkschnittstellen für das angeschlossene Gerät auf.Lists the network interfaces for the attached device.
SD, Show-Diagnosticssd, show-diagnostics Zeigt die Netzwerk Diagnose für ein oder alle Drahtlos Netzwerke auf dem angeschlossenen Gerät an.Shows network diagnostics for one or all wireless networks on the attached device.
show-statusshow-status Zeigt den Netzwerkstatus für das angeschlossene Gerät an.Shows the network status for the attached device.

Netzwerk Liste-Firewallregelnnetwork list-firewall-rules

Listet die Firewallregeln für das angeschlossene Gerät auf.Lists the firewall rules for the attached device.

Optionale ParameterOptional parameters

ParameterParameter BeschreibungDescription
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Gibt die IP-Adresse des Geräts an, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation -l, --devicelocation (Multigerät, nur Windows) Gibt die FTDI-Speicherort-ID des Geräts an, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.

Die folgenden Regeln werden angezeigt:The following rules are displayed:

  • Firewall RuleSet Name: zeigt den Namen des firewallregelsatz-Blocks an.Firewall Ruleset Name: Displays the name of the firewall ruleset block. Bei den Werten handelt es sich um vorab Eingaben, Eingaben, Vorwärtsund Ausgaben.The values are PREROUTING, INPUT, FORWARD, and OUTPUT.
  • Is RuleSet valid: zeigt den Status des RuleSets an.Is Ruleset Valid: Displays the status of the ruleset. Die Werte sind true oder false.The values are True or False.
  • Firewallregelsatz-Regeln: zeigt die Werte für die folgenden Regeln an:Firewall Ruleset Rules: Displays the values for the following rules:
    • Quell-IP: zeigt die IP-Adresse des sendenden Computers an.Source IP: Displays the IP address of the sending machine
    • Quell Maske: zeigt die Netzwerk Maske des sendenden Computers an.Source Mask: Displays the network mask of the sending machine
    • Ziel-IP: zeigt die IP-Adresse des Ziel Computers an.Destination IP: Displays the IP address of the destination machine
    • UID: zeigt die Benutzer Identifizierung an, die auf die Regel angewendet wurde.UID: Displays the user identification applied to the rule. 4294967295 (0xFFFFFFFF) bedeutet, dass keine UID angewendet wurde und daher für alle Benutzer gilt.4294967295 (0xFFFFFFFF) means no UID was applied and therefore it applies to everyone.
    • Aktion: zeigt die Aktion an, die ausgeführt werden soll.Action: Displays the action to be taken. Die Werte können Accept oder Droplauten.The values can be accept or drop.
    • Interface in Name: zeigt den Namen der Eingabeschnittstelle an.Interface IN name: Displays the input interface name. Beispielsweise wlan0.For example, wlan0.
    • Interface out Name: zeigt den Namen der Ausgabeschnittstelle an.Interface OUT name: Displays the output interface name. Beispielsweise wlan0.For example, wlan0.
    • State: zeigt den Verbindungsstatus an.State: Displays the connection state. Die Werte sind None, festgelegtoder verknüpft.The values are none, established, or related.
    • TCP-Maske: zeigt das Array von TCP-Masken an.TCP Mask: Displays the array of TCP masks. Die Werte lauten FIN, SYN, RST, PSH, ACKund URG.The values are fin, syn, rst, psh, ack, and urg.
    • TCP-CMP: zeigt das Array von TCP-Flags an.TCP Cmp: Displays the array of TCP flags. Die Werte sind URG, ACK, PSH, RST, sybund FIN.The values are urg, ack, psh, rst, syb, and fin.
    • TCP Inv: Boolescher Wert gibt an, dass der Sinn der TCP-Flags umgekehrt werden soll.TCP Inv: Boolean indicates that sense of the TCP flags should be inverted. Die Werte sind true oder false.The values are True or False.
    • Protocol: Hiermit wird das Protokoll der Firewallregel angezeigt.Protocol: Displays the protocol of the firewall rule. Die Werte lauten ICMP, IGMP, TCPund UDP.The values are icmp, igmp, tcp, udp.
    • Quell Port Bereich: zeigt den Port Bereich von der Quelle an, die den Datenverkehr sendet.Source Port Range: Displays the port range from source that sends the traffic. Der Wert kann zwischen 0 und 65535 liegen.The value can be between 0 and 65535.
    • Ziel Port Bereich: zeigt den Port Bereich auf dem Ziel an, der den Datenverkehr empfängt.Destination Port Range: Displays the port range on destination that receives the traffic. Der Wert kann zwischen 0 und 65535 liegen.The value can be between 0 and 65535.
    • Pakete: zeigt die Anzahl der Pakete an.Packets: Displays the number of packets
    • Bytes: zeigt die Anzahl von Bytes an.Bytes: Displays the number of bytes

Eine kurze Zusammenfassung der Flags wird unten dargestellt:A brief summary of the flags is presented below:

  • Urg: dringender Zeiger Bereich signifikantURG: Urgent Pointer field significant
  • ACK: Bestätigungs Feld signifikantACK: Acknowledgment field significant
  • PSH: Push-FunktionPSH: Push Function
  • RST: Zurücksetzen der VerbindungRST: Reset the connection
  • SYN: Sequenznummern synchronisierenSYN: Synchronize sequence numbers
  • FIN: keine weiteren Daten vom AbsenderFIN: No more data from sender
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device network list-firewall-rules
Firewall Ruleset Name: PREROUTING
Is Ruleset Valid: False
No rules found.

Firewall Ruleset Name: INPUT
Is Ruleset Valid: True
Firewall Ruleset Rules:
   Source IP             : <value>
   Source Mask           : <value>
   Destination IP        : <value>
   UID                   : <value>
   Action                : accept
   Interface IN name     :
   Interface OUT name    :
   State                 : none
   TCP Mask              : {  }
   TCP Cmp               : {  }
   TCP Inv               : False
   Protocol              : any
   Source Port Range     : { min: 0, max: 65535 }
   Destination Port Range: { min: 0, max: 65535 }
   Packets               : 1
   Bytes                 : 97

Firewall Ruleset Name: FORWARD
Is Ruleset Valid: True
Firewall Ruleset Rules:
   Source IP             : 0.0.0.0
   Source Mask           : 0.0.0.0
   Destination IP        : 0.0.0.0
   UID                   : 4294967295
   Action                : drop
   Interface IN name     :
   Interface OUT name    :
   State                 : none
   TCP Mask              : {  }
   TCP Cmp               : {  }
   TCP Inv               : False
   Protocol              : any
   Source Port Range     : { min: 0, max: 65535 }
   Destination Port Range: { min: 0, max: 65535 }
   Packets               : 0
   Bytes                 : 0

Firewall Ruleset Name: OUTPUT
Is Ruleset Valid: True
Firewall Ruleset Rules:
   Source IP             : 0.0.0.0
   Source Mask           : 0.0.0.0
   Destination IP        : 127.0.0.1
   UID                   : 4294967295
   Action                : accept
   Interface IN name     :
   Interface OUT name    :
   State                 : none
   TCP Mask              : {  }
   TCP Cmp               : {  }
   TCP Inv               : False
   Protocol              : tcp
   Source Port Range     : { min: 0, max: 65535 }
   Destination Port Range: { min: 0, max: 65535 }
   Packets               : 0
   Bytes                 : 0

Firewall Ruleset Name: POSTROUTING
Is Ruleset Valid: False
No rules found.

Netzwerk Listen-Schnittstellennetwork list-interfaces

Listet die Netzwerkschnittstellen für das angeschlossene Gerät auf.Lists the network interfaces for the attached device.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Gibt die IP-Adresse des Geräts an, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation -l, --devicelocation (Multigerät, nur Windows) Gibt die FTDI-Speicherort-ID des Geräts an, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device network list-interfaces
Interface name                   : lo
Network interface up             : True
Connected to network             : False
Acquired IP address              : False
Connected to internet            : False

Interface name                   : sl0
Network interface up             : True
Connected to network             : False
Acquired IP address              : False
Connected to internet            : False

Interface name                   : wlan0
Network interface up             : True
Connected to network             : False
Acquired IP address              : False
Connected to internet            : False

Netzwerk Show-Diagnostics, SDnetwork show-diagnostics, sd

Zeigt die Diagnose für ein oder alle Netzwerke auf dem angeschlossenen Gerät an.Shows diagnostics for one or all networks on the attached device.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Gibt die IP-Adresse des Geräts an, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation -l, --devicelocation (Multigerät, nur Windows) Gibt die FTDI-Speicherort-ID des Geräts an, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-i,--ID-i, --id Die ID des Netzwerks, für das die Diagnose angezeigt werden soll.The ID of the network for which to show diagnostics.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device network show-diagnostics
Timestamp           : 2020-06-23t16:48:50+0000
Network ID          : 0
SSID                : <value>
Last Recorded Error : NetworkNotFound
Configuration State : enabled
Connection State    : disconnected
No certificate errors logged.

Timestamp:             2020-02-20 02:54:20pm
Network Id:            1
SSID:                  pskNetwork
Last Recorded Error:   WrongKey
Configuration State:   enabled
Connection State:      disconnected

Timestamp:             2020-02-20 02:53:30pm
Network Id:            0
SSID:                  EAP-TLS Wifi
Last Recorded Error:   ConnectionFailed
Configuration State:   temp-disabled
Connection State:      disconnected
No certificate errors logged.

Netzwerk Anzeige-Statusnetwork show-status

Zeigt den Netzwerkstatus für das angeschlossene Gerät an.Shows the the network status for the attached device.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Gibt die IP-Adresse des Geräts an, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation -l, --devicelocation (Multigerät, nur Windows) Gibt die FTDI-Speicherort-ID des Geräts an, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device network show-status
Is device authentication ready: False
Network time sync status      : incomplete

recoverrecover

Ersetzt die Systemsoftware auf dem Gerät.Replaces the system software on the device.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-i, --images Ordner-i, --images folder Pfad zu einem Ordner, der die Imagepakete enthält, die auf das Gerät geschrieben werden sollen.Path to a folder that contains the image packages to write to the device. Bei der Wiederherstellung werden standardmäßig die Images im SDK verwendet, es sei denn, mit diesem Flag wird ein alternativer Pfad angegeben.By default, recovery uses the images in the SDK unless an alternate path is provided with this flag.
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device recover --images .\recovery`

Rescan-angefügt, RArescan-attached, ra

Die angeschlossenen Geräte werden durch den netzwerkrad-und den gesamten FTDI-Port neu skaliert.Rescans the attached devices by power-cycling all their FTDI ports. Verwenden Sie diesen Befehl bei der Behandlung von Geräte Verbindungsproblemen unter Windows.Use this command when troubleshooting device connection problems on Windows. Dieser Befehl wird nur unter Windows ausgeführt.This command runs only on Windows.

Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device rescan-attached
Rescanning has found 1 attached device.

restartrestart

Startet das angeschlossene Gerät neu.Restarts the attached device.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-ip, --deviceip -ip, --deviceip (Multigerät, nur Windows) Gibt die IP-Adresse des Geräts an, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation -l, --devicelocation (Multigerät, nur Windows) Gibt die FTDI-Speicherort-ID des Geräts an, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device restart
Restarting device.
Device restarted successfully.
Command completed successfully in 00:00:10.2668755.

showshow

Zeigt Informationen an, die der Azure Sphere Security Service für ein Gerät speichert.Displays information that the Azure Sphere Security Service stores for a device. Diese Details unterscheiden sich von den Informationen, die das Gerät selbst speichert.These details differ from those that the device itself stores.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-i, --deviceid GUID-i, --deviceid GUID ID des Geräts.ID of the device. Zeigt standardmäßig Informationen zum angeschlossenen Gerät an.By default, shows information about the attached device.
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device show
Retrieved the over-the-air update configuration for device with ID <device ID>:
 --> Device group: 'System Software' with ID '63bbe6ea-14be-4d1a-a6e7-03591d882b42'
 --> SKU: '9d606c43-1fad-4990-b207-554a025e0869' of type 'Chip'
 --> SKU: '946410a0-0057-4b11-af68-d56a684f6681' of type 'Product'
Command completed successfully in 00:00:03.0219123.

show-attachedshow-attached

Zeigt Informationen zum angeschlossenen Gerät über das Gerät selbst an.Displays information about the attached device from the device itself. Diese Details unterscheiden sich von den Informationen, die der Azure Sphere Security Service für das Gerät speichert.These details differ from those that the Azure Sphere Security Service stores for the device.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

Device ID: <device ID>
IP address: 192.168.35.2
Connection path: 1423
Command completed successfully in 00:00:03.3654153.

show-deployment-statusshow-deployment-status

Zeigt den Bereitstellungsstatus von Anwendungs- und Betriebssystemupdates für das Gerät an.Displays the deployment status of application and operating system updates for the device.

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.Use this command to find out which version of the Azure Sphere OS your device is running or whether the current deployment update has completed.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device show-deployment-status
The Azure Sphere Security Service is targeting this device with OS version <versionNumber>
Your device has the expected version of the Azure Sphere OS: <versionNumber>.
Command completed successfully in 00:00:03.8184016.

In diesem Beispiel <versionNumber> stellt die aktuelle Betriebssystemversion dar.In this example, <versionNumber> represents the current operating system version.

show-countshow-count

Zeigt die Anzahl der Geräte im aktuellen Mandanten an.Displays the number of devices in the current tenant.

Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device show-count

show-os-versionshow-os-version

Zeigt die aktuelle Betriebssystemversion auf dem angeschlossenen Gerät an.Displays the current operating system version on the attached device.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device show-os-version

sideload, slsideload, sl

Verwaltet die Anwendung auf dem Gerät.Manages the application on the device.

Für einige Querladeoptionen ist die Funktion appDevelopment erforderlich, die mithilfe von enable-development abgerufen werden kann.Some sideload options require the appDevelopment capability, which can be acquired by using enable-development. Um eine SDK-signierte Anwendung querladen oder eine SDK-signierte oder für die Produktion signierte Anwendung starten, beenden, debuggen oder löschen zu können, muss das Gerät über die Funktion appDevelopment verfügen.To sideload an SDK-signed application, or to start, stop, debug, or delete an SDK-signed application or a production-signed application, the device must have the appDevelopment capability.

VorgangOperation BESCHREIBUNGDescription
deletedelete Löscht die aktuelle Anwendung vom Gerät.Deletes the current application from the device.
deploydeploy Lädt eine Anwendung auf das Gerät.Loads an application onto the device.

Beachten Sie, dass die Parameter für „start“, „stop“, „show-status“ und „show-quota“ in den Befehl azsphere device app verschoben wurden.Note that the parameters to start, stop, show-status, and show-quota have been moved to the azsphere device app command.

sideload deletesideload delete

Löscht Anwendungen vom Gerät.Deletes applications from the device.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-i, --componentid GUID-i, --componentid GUID ID der Anwendung, die vom Gerät gelöscht werden soll.ID of the application to delete from the device. Wenn diese Angabe nicht erfolgt, werden alle Anwendungen gelöscht.If omitted, deletes all applications.
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

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

sideload deploysideload deploy

Lädt eine Anwendung auf das angeschlossene Gerät und startet die Anwendung.Loads an application onto the attached device and starts the application.

Dieser Befehl kann nicht ausgeführt werden, wenn das Anwendungsmanifest eine Ressource anfordert, die von einer Anwendung verwendet wird, die bereits auf dem Gerät vorhanden ist.This command fails if the application manifest requests a resource that is being used by an application that is already on the device. Verwenden Sie in diesem Fall azsphere device sideload delete, um die vorhandene Anwendung zu löschen, und wiederholen Sie dann den Vorgang zum Querladen.In this case, use azsphere device sideload delete to delete the existing application and then try sideloading again. Mit dem Befehl azsphere device sideload delete werden sowohl allgemeine Anwendungen als auch Echtzeitanwendungen gelöscht. Geben Sie die Komponenten-ID einer zu löschenden Anwendung an, um eine Anwendung zu löschen und die andere beizubehalten.The azsphere device sideload delete command will delete both high level applications and real time applications; to delete one application and leave the other specify the component ID of the application to delete.

Derselbe Befehl wird verwendet, um sowohl allgemeine Anwendungen als auch echtzeitfähige Anwendungen bereitzustellen.The same command is used to deploy both high-level applications and real-time capable applications.

Erforderliche ParameterRequired parameters

ParameterParameter BESCHREIBUNGDescription
-p, --imagepackage Pfad-p, --imagepackage path Pfad und Dateiname des Imagepakets, das auf das Gerät geladen werden soll.Path and filename of the image package to load on the device. Die Bereitstellung mittels Querladen schlägt fehl, wenn das Gerät nicht über die Funktion appDevelopment verfügt.Sideload deployment will fail if the device does not have the appDevelopment capability.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
--force--force Der Befehl erzwingt die Bereitstellung eines Images, für das eine Beta-API genutzt wird, die unter Umständen nicht mehr unterstützt wird.Command forces the deployment of an image that uses a Beta API that may no longer be supported.
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-m, --manualstart-m, --manualstart Der Befehl startet die Anwendung nicht nach dem Laden.Command does not start the application after loading it.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device sideload deploy --imagepackage "C:\Users\Test\Documents\Visual Studio 2017\Projects\Mt3620Blink6\Mt3620Blink6\bin\ARM\Debug\Mt3620Blink6.imagepackage"
Deploying 'C:\Users\Test\Documents\Visual Studio 2017\Projects\Mt3620Blink6\Mt3620Blink6\bin\ARM\Debug\Mt3620Blink6.imagepackage' to the attached device.
Image package 'C:\Users\Test\Documents\Visual Studio 2017\Projects\Mt3620Blink6\Mt3620Blink6\bin\ARM\Debug\Mt3620Blink6.imagepackage' has been deployed to the attached device.
Command completed successfully in 00:00:03.0567304.

aktualisierenupdate

Verschiebt das Gerät in eine andere Gerätegruppe in Ihrem Azure Sphere-Mandanten.Moves the device into a different device group in your Azure Sphere tenant.

Zusätzlich zu den Gerätegruppen, die Sie in einem Produkt erstellen, werden fünf Standardgerätegruppen hinzugefügt, wenn ein Produkt erstellt wird:In addition to device groups you create in a product, five default device groups are added when a product is created:

  • Die Gerätegruppe Development (Entwicklung) deaktiviert Cloudanwendungsupdates und liefert das Retail Evaluation OS.Development device group disables cloud application updates and delivers the Retail Evaluation OS.
  • Die Gerätegruppe Field Test (Feldtest) aktiviert Cloudanwendungsupdates und liefert das Retail OS.Field Test device group enables cloud application updates, and delivers the Retail OS.
  • Die Gerätegruppe Production (Produktion) aktiviert Cloudanwendungsupdates und liefert das Retail OS.Production device group enables cloud application updates, and delivers the Retail OS.
  • Die Gerätegruppe Production OS Evaluation (Produktions-BS Evaluierung) aktiviert Cloudanwendungsupdates und liefert das Retail Evaluation OS.Production OS Evaluation device group enables cloud application updates and delivers the Retail Evaluation OS.
  • Die Gerätegruppe Field Test OS Evaluation (Feldtest-BS Evaluierung) aktiviert Cloudanwendungsupdates und liefert das Retail Evaluation OS.Field Test OS Evaluation device group enables cloud application updates and delivers the Retail Evaluation OS.

Optionale ParameterOptional parameters

ParameterParameter BeschreibungDescription
-dgi, --devicegroupid GUID-dgi, --devicegroupid GUID ID der Gerätegruppe.ID of the device group. Entweder die Gerätegruppen-ID oder ein Paar aus Produktname und Gerätegruppenname verwenden.Use either device group ID or a device group name and product name pair.
-dgn, --devicegroupname Zeichenfolge-dgn, --devicegroupname string Name der Gerätegruppe.Name of the device group. Entweder die Gerätegruppen-ID oder ein Paar aus Produktname und Gerätegruppenname verwenden.Use either device group ID or a device group name and product name pair.
-i, --deviceid GUID-i, --deviceid GUID ID des zu verschiebenden Geräts.ID of the device to move. Standardmäßig wird das angeschlossene Gerät verschoben.By default, moves the attached device.
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-pn, --productname Zeichenfolge-pn, --productname string Der Name des Produkts.Name of the product. Entweder die Gerätegruppen-ID oder ein Paar aus Produktname und Gerätegruppenname verwenden.Use either device group ID or a device group name and product name pair.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device update --devicegroupid 63bbe6ea-14be-4d1a-a6e7-03591d882b42
Successfully moved device <device ID> to device group '63bbe6ea-14be-4d1a-a6e7-03591d882b42' in your Azure Sphere tenant.

Command completed successfully in 00:00:02.7316538.

wifiwifi

Ändert die Drahtloskonfiguration für das angeschlossene Gerät.Changes the wireless configuration for the attached device.

Damit Sie das Gerät in einem Drahtlosnetzwerk verwenden können, müssen Sie dem Gerät Informationen über das Netzwerk hinzufügen und das Netzwerk auf dem Gerät aktivieren.To use the device on a wireless network, you must add information about the network and enable the network on the device. Sie können zwar ASCII-fremde Zeichen in SSIDs eingeben, azsphere zeigt diese jedoch nicht richtig an.Although you can input non-ASCII characters in SSIDs, azsphere does not display them properly.

Wenn Ihre Anwendung die WifiConfig-API verwendet, müssen Sie auch die WifiConfig-Funktion in die Datei „app_manifest.json“ der Anwendung einschließen.If your application uses the WifiConfig API, you must also include the WifiConfig capability in the application's app_manifest.json file.

VorgangOperation BESCHREIBUNGDescription
addadd Fügt dem Gerät die Details eines Drahtlosnetzwerks hinzu.Adds the details of a wireless network to the device.
disabledisable Deaktiviert ein Drahtlosnetzwerk auf dem Gerät.Disables a wireless network on the device.
enableenable Aktiviert ein Drahtlosnetzwerk auf dem Gerät.Enables a wireless network on the device.
forgetforget Entfernt die Details eines Drahtlosnetzwerks vom Gerät.Removes the details of a wireless network from the device.
listlist Listet die aktuelle WLAN-Konfiguration für das Gerät auf.Lists the current Wi-Fi configuration for the device.
reload-configreload-config Lädt die WLAN-Konfiguration des Geräts erneutReloads the device Wi-Fi configuration.
scanscan Sucht nach verfügbaren Netzwerken.Scans for available networks.
showshow Zeigt Details einer WLAN-Konfiguration anDisplays details of a Wi-Fi configuration.
show-statusshow-status Zeigt den Status der Drahtlosschnittstelle an.Displays the status of the wireless interface.

wifi addwifi add

Fügt dem Gerät Informationen über eine WLAN-Verbindung hinzu.Adds information about a Wi-Fi connection to the device.

Ein Gerät kann über mehrere WLAN-Verbindungen verfügen.A device can have multiple Wi-Fi connections.

Sie können zwar ASCII-fremde Zeichen in SSIDs eingeben, azsphere zeigt diese jedoch nicht richtig an.Although you can input non-ASCII characters in SSIDs, azsphere does not display them properly.

Der Befehl azsphere kann eine Verbindung mit verborgenen SSIDs herstellen, wenn Sie den Parameter --targeted-scan verwenden.The azsphere command can connect to hidden SSIDs if you include the --targeted-scan parameter.

Erforderliche ParameterRequired parameters

ParameterParameter BeschreibungDescription
-s, --ssid Zeichenfolge-s, --ssid string SSID des Netzwerks.SSID of the network. Bei Netzwerk-SSIDs ist die Groß-/Kleinschreibung zu beachten.Network SSIDs are case-sensitive.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-cc, --clientcertid Zeichenfolge-cc, --clientcertid string [EAP-TLS:] Eine Zeichenfolge (max. 16 Zeichen), die das Clientzertifikat angibt (das den öffentlichen und den privaten Schlüssel enthält).[EAP-TLS] A string (up to 16 characters) that identifies the client certificate (containing both the public and private key). Erforderlich zum Einrichten eines EAP-TLS-Netzwerks.Required to set up an EAP-TLS network.
-cid, --clientid *user@domain*-cid, --clientid *user@domain* [EAP-TLS:] ID für die Authentifizierung durch den RADIUS-Server des Netzwerks.[EAP-TLS] ID recognized for authentication by the network's RADIUS server. Wird bei einigen EAP-TLS-Netzwerken benötigt.Required for some EAP-TLS networks.
-cn, --configname Zeichenfolge-cn, --configname string Zeichenfolge (max. 16 Zeichen), die den Namen der Netzwerkkonfiguration angibtA string (up to 16 characters) that specifies the name for the network configuration.
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is required only when multiple devices are attached. Sie können entweder eine Geräte-IP-Adresse oder einen Gerätestandort angeben.You can specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is required only when multiple devices are attached. Sie können entweder eine Geräte-IP-Adresse oder einen Gerätestandort angeben.You can specify either a device IP or device location.
-p, --psk Zeichenfolge-p, --psk string WPA-/WPA2-Schlüssel für das neue Netzwerk.WPA/WPA2 key for the new network. Auslassen, um die SSID als offenes Netzwerk hinzuzufügen.Omit to add the SSID as an open network. Wenn Ihr Schlüssel ein kaufmännisches Und-Zeichen (&) enthält, setzen Sie den Schlüssel in Anführungszeichen.If your key contains an ampersand (&), enclose the key in quotation marks.
-ca, --rootcacertid Zeichenfolge-ca, --rootcacertid string [EAP-TLS:] Eine Zeichenfolge (max. 16 Zeichen), die das Zertifikat der Stammzertifizierungsstelle des Servers für EAP-TLS-Netzwerke angibt, mit dem das Gerät den Server authentifiziert.[EAP-tLS] A string (up to 16 characters) that identifies the server's root CA certificate for EAP-TLS networks where the device authenticates the server.
-t, --targeted-scan-t, --targeted-scan Der Befehl versucht, eine Verbindung mit einem Netzwerk herzustellen, auch wenn keine Übertragung stattfindet oder es durch Netzwerküberlastung verborgen ist.Command attempts to connect to a network even when it is not broadcasting or is hidden by network congestion.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device wifi add --ssid MyNetwork --psk myKey123

Add network succeeded:
ID : 2
SSID : MyNetwork
Configuration state : enabled
Connection state : unknown
Security state : psk
Command completed successfully in 00:00:01.7039497.

Wenn die Netzwerk-SSID oder der Netzwerkschlüssel eingebettete Leerzeichen oder ein kaufmännisches Und-Zeichen enthält, setzen Sie die SSID oder den Schlüssel in Anführungszeichen.If the network SSID or key has embedded spaces or an ampersand, enclose the SSID or key in quotation marks. Wenn die SSID oder der Schlüssel ein Anführungszeichen enthält, versehen Sie das Anführungszeichen mit einem umgekehrten Schrägstrich als Escapezeichen.If the SSID or key includes a quotation mark, use a backslash to escape the quotation mark. Umgekehrte Schrägstriche benötigen keine Escapezeichen, wenn sie Teil eines Werts sind.Backslashes do not require escape if they are part of a value. Beispiel:For example:

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

wifi disablewifi disable

Deaktiviert ein Drahtlosnetzwerk auf dem angeschlossenen Gerät.Disables a wireless network on the attached device.

Erforderliche ParameterRequired parameters

ParameterParameter BESCHREIBUNGDescription
-i, --id Ganze Zahl-i, --id integer ID des zu deaktivierenden Netzwerks.ID of the network to disable.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device wifi disable --id 2
Successfully disabled network:
ID                  : 2
SSID                : NETGEAR21-5G
Configuration state : disabled
Connection state    : disconnected
Security state      : psk
Command completed successfully in 00:00:01.4166658.

wifi enablewifi enable

Aktiviert ein Drahtlosnetzwerk auf dem angeschlossenen Gerät.Enables a wireless network on the attached device.

Um von einem Netzwerk zu einem anderen zu wechseln, wenn sich beide in Reichweite befinden, deaktivieren Sie das aktuell verbundene Netzwerk, bevor Sie das neue Netzwerk aktivieren.To change from one network to another if both are within range, disable the currently connected network before you enable the new network.

Erforderliche ParameterRequired parameters

ParameterParameter BESCHREIBUNGDescription
-i, --id Ganze Zahl-i, --id integer ID des zu aktivierenden Netzwerks.ID of the network to enable.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-ip, --deviceip -ip, --deviceip (Multigerät, nur Windows) Gibt die IP-Adresse des Geräts an, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation -l, --devicelocation (Multigerät, nur Windows) Gibt die FTDI-Speicherort-ID des Geräts an, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device wifi enable --id 2
Successfully enabled network:
ID                  : 2
SSID                : NETGEAR21-5G
Configuration state : enabled
Connection state    : connected
Security state      : psk
Command completed successfully in 00:00:01.4063645.

wifi forgetwifi forget

Löscht Informationen über ein Drahtlosnetzwerk vom Gerät.Deletes information about a wireless network from the device.

Erforderliche ParameterRequired parameters

ParameterParameter BESCHREIBUNGDescription
-i, --id Ganze Zahl-i, --id integer ID des zu löschenden Netzwerks.ID of the network to delete.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-ip, --deviceip -ip, --deviceip (Multigerät, nur Windows) Gibt die IP-Adresse des Geräts an, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation -l, --devicelocation (Multigerät, nur Windows) Gibt die FTDI-Speicherort-ID des Geräts an, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device wifi forget --id 1
Successfully removed network.
Command completed successfully in 00:00:01.0055424.

wifi listwifi list

Zeigt Informationen zu allen WLAN-Verbindungen auf dem Gerät an.Displays information about all the Wi-Fi connections on the device.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device wifi list
Network list:

ID                  : 0
SSID                : NETGEAR21
Configuration state : enabled
Connection state    : connected
Security state      : psk

ID                  : 1
SSID                : A_WiFi_SSID
Configuration state : enabled
Connection state    : disconnected
Security state      : open

ID                  : 2
SSID                : NETGEAR21-5G
Configuration state : enabled
Connection state    : disconnected
Security state      : psk

ID                  : 3
SSID                : eap-sphere
Configuration state : enabled
Connection state    : disconnected
Security state      : eaptls
Targetd scan        : False
Configuration name  : SampleCfg
Command completed successfully in 00:00:00.7698180.

wifi reload-configwifi reload-config

Lädt die WLAN-Konfiguration des angeschlossenen Geräts erneut.Reloads the device Wi-Fi configuration on the attached device. Verwenden Sie diesen Befehl, nachdem Sie ein Zertifikat (azsphere-Gerätezertifikat) hinzugefügt oder entfernt haben, um sicherzustellen, dass EAP-TLS-Netzwerke den aktuellen Inhalt des Zertifikatspeichers verwenden.Use this command after you add or remove a certificate (azsphere device certificate) to ensure that EAP-TLS networks use the most recent contents of the certificate store.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device wifi reload-config

Wi-Fi configuration was successfully reloaded

wifi scanwifi scan

Sucht nach Drahtlosnetzwerken, die sich in Reichweite des Geräts befinden.Scans for wireless networks within range of the device. Der Befehl gibt zwar bis zu 64 Drahtlosnetzwerke zurück, die Anzahl der angezeigten Drahtlosnetzwerke kann jedoch durch Umgebungsfaktoren wie die Dichte der in Reichweite befindlichen Zugriffspunkte eingeschränkt werden.The command will return up to 64 wireless network, but the number of wireless networks displayed may be limited by environmental factors such as the density of access points in range.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP-Adresse oder einen Gerätestandort angeben.You can specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP-Adresse oder einen Gerätestandort angeben.You can specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device wifi scan

Scan results:
SSID : NETGEAR21
Security state : psk
BSSID : 44:94:fc:36:c8:65
Signal level : -66
Frequency : 2442

SSID : CenturyLink9303
Security state : psk
BSSID : 58:8b:f3:09:ae:d2
Signal level : -75
Frequency : 2412

SSID : NETGEAR21-5G
Security state : psk
BSSID : 44:94:fc:36:c8:64
Signal level : -86
Frequency : 5765

SSID : belkin.c32
Security state : psk
BSSID : 08:86:3b:0b:cc:32
Signal level : -86
Frequency : 2462
Command completed successfully in 00:00:07.4163320.

wifi showwifi show

Zeigt Details zu einer WLAN-Netzwerkkonfiguration auf dem angeschlossenen Gerät anDisplays details of a Wi-Fi network configuration on the attached device.

Erforderliche ParameterRequired parameters

ParameterParameter BESCHREIBUNGDescription
-i, --id Ganze Zahl-i, --id integer Die ID der anzuzeigenden NetzwerkkonfigurationThe ID of the network configuration to show.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere device wifi show -id 0

ID                  : 0
SSID                : eap-sphere
Configuration state : enabled
Connection state    : disconnected
Security state      : eaptls
Targeted scan       : False
Configuration name  : SmplNetCfg
CA Cert ID          : SmplRootCACertId
Client Cert ID      : SmplClientCertId
Client identity     : user@azuresphere-test.com

wifi show-statuswifi show-status

Zeigt Informationen zur aktuellen WLAN-Verbindung auf dem Gerät an.Displays information about the current Wi-Fi connection on the device.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-ip, --deviceip Zeichenfolge-ip, --deviceip string (Multigerät, nur Windows) Die IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) IP address of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
-l, --devicelocation Zeichenfolge-l, --devicelocation string (Multigerät, nur Windows) Die FTDI-Speicherort-ID des Geräts, das für diesen Vorgang verwendet werden soll.(Multi-device, Windows only) FTDI location ID of the device to use for this operation. Dies ist nur erforderlich, wenn mehrere Geräte angeschlossen sind.This is only required when multiple devices are attached. Sie können entweder eine Geräte-IP oder einen Gerätestandort angeben.You may specify either a device IP or device location.
Globale ParameterGlobal parameters

ParameterParameter BESCHREIBUNGDescription
-v, --verbose-v, --verbose Erzeugt eine ausführliche AusgabeProvides verbose output
-?, --help-?, --help Zeigt Hilfe zum Befehl anDisplays help on the command

BeispielExample

azsphere dev wifi show-status
SSID                : NETGEAR23
Configuration state : enabled
Connection state    : connected
Security state      : psk
Frequency           : 2417
Mode                : station
Key management      : WPA2-PSK
WPA State           : COMPLETED
IP Address          : 192.168.1.9
MAC Address         : be:98:26:be:0d:e0

Command completed successfully in 00:00:01.7341825.