device, devdevice, dev

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

VorgangOperation BESCHREIBUNGDescription
appapp Ändert den Status von Anwendungen auf einem Gerät.Changes the status of applications on a device.
capability, capcapability, cap Verwaltet GerätefunktionenManages device capabilities
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
recoverrecover Verwendet einen speziellen Wiederherstellungsmodus, um neue Firmware auf das Gerät zu ladenUses special recovery mode to load new firmware onto the device
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 einzelnes Gerät, indem es in einer bestimmten Gerätegruppe platziert wird.Updates a single 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 [Mehrere Geräte] IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] FTDI-Standort-ID des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] FTDI-Standort-ID des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] FTDI-Standort-ID des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] FTDI-Standort-ID des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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.

Aktuell ist nur die Funktion appDevelopment verfügbar, mit der Sie SDK-signierte Imagepakete auf das Gerät querladen sowie jedes Imagepaket starten, beenden, debuggen oder vom Gerät löschen können.Currently, the only capability is appDevelopment, which enables you to sideload SDK-signed image packages to the device and to start, stop, debug, or delete any image package from the device.

VorgangOperation BESCHREIBUNGDescription
Herunterladendownload Lädt eine Gerätefunktionskonfiguration vom Azure Sphere Security Service herunterDownloads a device capability configuration from the Azure Sphere Security Service
show-attachedshow-attached Zeigt die Funktionskonfiguration für das angeschlossene Gerät anDisplays the capability configuration for the attached device
updateupdate Der Befehl wendet eine Gerätefunktionskonfiguration auf das angeschlossene Gerät an.Command applies a device capability configuration to the attached device

capability downloadcapability download

Lädt eine Gerätefunktion vom Azure Sphere Security Service herunter und wendet sie auf ein Gerät an.Downloads a device capability from the Azure Sphere Security Service and applies it to a device.

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.

Erforderliche ParameterRequired parameters

ParameterParameter BESCHREIBUNGDescription
-t, --type capability-type-t, --type capability-type Typ der Funktion – entweder appDevelopment oder none.Type of capability, either appDevelopment or none. Verwenden Sie none, um die Funktion appDevelopment zu entfernen.Use none to remove the appDevelopment 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 [Mehrere Geräte] IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] FTDI-Standort-ID des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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. Geben Sie einen Pfad an, auch für das aktuelle Verzeichnis.Include a path, even for the current directory. Für den Parameter „--deviceid“ erforderlich.Required with the --deviceid parameter.
-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.
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 show-attachedcapability show-attached

Zeigt die Funktionskonfiguration für das angeschlossene Gerät an.Displays the capability configuration for the attached device.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-ip, --deviceip Zeichenfolge-ip, --deviceip string [Mehrere Geräte] IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] FTDI-Standort-ID des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 Pfad und Name der anzuwendenden Gerätefunktionsdatei.Path and name of the device capability file to apply.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-ip, --deviceip Zeichenfolge-ip, --deviceip string [Mehrere Geräte] IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] FTDI-Standort-ID des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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.

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 [Mehrere Geräte] IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] FTDI-Standort-ID des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] FTDI-Standort-ID des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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

BeispieleExamples

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. Bei Geräten in diesem Zustand wird das Betriebssystem aktualisiert, aber Ihre Apps werden nicht entfernt.Any existing apps remain on the device, and the OS is updated, devices in this state get their OS updated but their apps aren’t removed. 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. Dadurch wird sichergestellt, dass quergeladene Apps nicht überschrieben werden.By default, application updates are disabled for this 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 [Mehrere Geräte] IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] FTDI-Standort-ID des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] FTDI-Standort-ID des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] FTDI-Standort-ID des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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äts, sofern dieser nicht bereits „AllComplete“ lautet.Updates the manufacturing state of the attached device if it is not already AllComplete.

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 [Mehrere Geräte] IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] FTDI-Standort-ID des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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. Aktuell kann nur der Zustand „AllComplete“ festgelegt werden.Currently the only settable state is AllComplete.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-ip, --deviceip Zeichenfolge-ip, --deviceip string [Mehrere Geräte] IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] FTDI-Standort-ID des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 update --state AllComplete
Manufacturing State: AllComplete
Command completed successfully in 00:00:00.9005143.

recoverrecover

Ersetzt die Systemsoftware auf dem Gerät.Replaces the system software on the device. Wenn Sie diesen Befehl ohne Parameter verwenden, wird das aktuelle Releaseimage heruntergeladen und auf dem Board installiert.If you use this command without parameters, the latest release image will be downloaded and installed to the board.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-c, --capability Dateiname-c, --capability filename Dateiname des Gerätefunktionsimages, das auf das Gerät angewendet werden soll.Filename of the device capability image to apply to the device. Gilt nur für Microsoft.For Microsoft use only.
-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 [Mehrere Geräte] IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] FTDI-Standort-ID des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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

restartrestart

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

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-ip, --deviceip -ip, --deviceip [Mehrere Geräte] Gibt die IP-Adresse des Geräts an, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] Gibt die FTDI-Standort-ID des Geräts an, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] FTDI-Standort-ID des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] FTDI-Standort-ID des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] FTDI-Standort-ID des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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.

<versionNumber> stellt in diesem Beispiel 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 [Mehrere Geräte] IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] FTDI-Standort-ID des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 viele Querladeoptionen ist die Funktion appDevelopment erforderlich, die mithilfe von enable-development abgerufen werden kann.Many of the 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 [Mehrere Geräte] IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] FTDI-Standort-ID des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] FTDI-Standort-ID des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] FTDI-Standort-ID des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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.
scanscan Sucht nach verfügbaren Netzwerken.Scans for available networks.
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
-ip, --deviceip Zeichenfolge-ip, --deviceip string [Mehrere Geräte] IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] FTDI-Standort-ID des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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.
-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.
-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 [Mehrere Geräte] IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] FTDI-Standort-ID des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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.

Optionale ParameterOptional parameters

ParameterParameter BESCHREIBUNGDescription
-ip, --deviceip -ip, --deviceip [Mehrere Geräte] Gibt die IP-Adresse des Geräts an, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] Gibt die FTDI-Standort-ID des Geräts an, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 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 [Mehrere Geräte] Gibt die IP-Adresse des Geräts an, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] Gibt die FTDI-Standort-ID des Geräts an, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] Gibt die IP-Adresse des Geräts an, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] Gibt die FTDI-Standort-ID des Geräts an, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] FTDI-Standort-ID des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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
Command completed successfully in 00:00:00.7698180.

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 [Mehrere Geräte] IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] FTDI-Standort-ID des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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.

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 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 [Mehrere Geräte] IP-Adresse des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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 [Mehrere Geräte] FTDI-Standort-ID des Geräts, das für diesen Vorgang verwendet werden soll.[Multi-Device] 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.

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.