az sphere device

Verwalten von Azure Sphere-Geräten

Vorgang	Beschreibung
az sphere device rescan-attached	Zeigt die Anzahl der angeschlossenen Geräte an.
az sphere device list-attached	Listet alle angeschlossenen Geräte auf.
az sphere device show-attached	Zeigen Sie die Details des angeschlossenen Geräts an.
az sphere device list	Listen Sie alle Geräte in Ihrem Katalog, Produkt oder Ihrer Gerätegruppe auf.
az sphere device show-count	Zeigen Sie die Anzahl der Geräte in Ihrem Katalog, Produkt oder Ihrer Gerätegruppe an.
az sphere device show	Zeigen Sie Details eines vorhandenen Geräts in Ihrer Ressourcengruppe und im Katalog an.
az sphere device assign	Weisen Sie ein Gerät einer Gerätegruppe in Ihrer Ressourcengruppe und ihrem Katalog zu.
az sphere device unassign	Heben Sie die Zuweisung eines Geräts zu einer Gerätegruppe in Ihrer Ressourcengruppe und ihrem Katalog auf.
az sphere device restart	Starten Sie das angeschlossene Gerät neu.
az sphere device claim	Fordern Sie ein Gerät in Ihrer Ressourcengruppe und ihrem Katalog an.
az sphere device recover	Verwenden Sie den Wiederherstellungsmodus, um neue Firmware auf das angeschlossene Gerät zu laden.
az sphere device show-os-version	Zeigen Sie die Betriebssystemversion auf dem angeschlossenen Gerät an.
az sphere device show-deployment-status	Anzeigen der Bereitstellung status des Betriebssystems auf einem Gerät.
az sphere device enable-development	"Aktivieren Sie ein Gerät für die Entwicklung, indem Sie das Querladen und Debuggen auf dem angeschlossenen Gerät aktivieren und es einer Gerätegruppe zuweisen, die Anwendungsupdates aus der Cloud deaktiviert. Standardmäßig ist dies die Gerätegruppe Entwicklung des Produkts des Geräts, aber es können andere Gerätegruppen angegeben werden. Nicht für die Verwendung in Fertigungsszenarien
az sphere device enable-cloud-test	"Aktivieren Sie ein Gerät zum Testen des Ladens in die Cloud, indem Sie die Entwicklung und das Debuggen auf dem angefügten Gerät deaktivieren und es einer Gerätegruppe zuweisen, die Anwendungsupdates aus der Cloud ermöglicht. Standardmäßig ist dies die Feldtestgerätegruppe des Produkts des Geräts, aber es können andere Gerätegruppen angegeben werden. Nicht für die Verwendung in Fertigungsszenarien

Befehle

az sphere device rescan-attached

Zeigt die Anzahl der angeschlossenen Geräte an.

Erforderliche Parameter

Parameter	Beschreibung
--catalog -c	Der Azure Sphere-Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie den Namen des Azure Sphere-Katalogs an. Sie können den Azure Sphere-Standardkatalog mit az config set defaults.sphere.catalog=<name>konfigurieren. Werte aus: az sphere catalog list.
--resource-group -r	Name der Azure-Ressourcengruppe. Sie können die Standardgruppe mit az config set defaults.group=<name>konfigurieren. Werte aus: az group list.

Beispiele

Zeigt die Anzahl der angeschlossenen Geräte an.

az sphere device rescan-attached

az sphere device list-attached

Listet alle angeschlossenen Geräte auf.

Erforderliche Parameter

Parameter	Beschreibung
--catalog -c	Der Azure Sphere-Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie den Namen des Azure Sphere-Katalogs an. Sie können den Azure Sphere-Standardkatalog mit az config set defaults.sphere.catalog=<name>konfigurieren. Werte aus: az sphere catalog list.
--resource-group -r	Name der Azure-Ressourcengruppe. Sie können die Standardgruppe mit az config set defaults.group=<name>konfigurieren. Werte aus: az group list.

Beispiele

Listet alle angeschlossenen Geräte auf.

az sphere device list-attached

az sphere device show-attached

Zeigen Sie die Details des angeschlossenen Geräts an.

Erforderliche Parameter

Parameter	Beschreibung
--catalog -c	Der Azure Sphere-Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie den Namen des Azure Sphere-Katalogs an. Sie können den Azure Sphere-Standardkatalog mit az config set defaults.sphere.catalog=<name>konfigurieren. Werte aus: az sphere catalog list.
--resource-group -r	Name der Azure-Ressourcengruppe. Sie können die Standardgruppe mit az config set defaults.group=<name>konfigurieren. Werte aus: az group list.

Optionale Parameter

Parameter	Beschreibung
--device -d	Das Gerät, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Geben Sie die ID, IP-Adresse oder lokale Verbindungs-ID eines angefügten Geräts an. Werte aus: az sphere device list

Beispiele

Details des angeschlossenen Geräts anzeigen.

az sphere device show-attached

Zeigen Sie Details des angegebenen Geräts an.

az sphere device show-attached --device <DeviceIdValue>

az sphere device list

Listen Sie alle Geräte in Ihrem Katalog, Produkt oder Ihrer Gerätegruppe auf.

Erforderliche Parameter

Parameter	Beschreibung
--catalog -c	Der Azure Sphere-Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie den Namen des Azure Sphere-Katalogs an. Sie können den Azure Sphere-Standardkatalog mit az config set defaults.sphere.catalog=<name>konfigurieren. Werte aus: az sphere catalog list.
--resource-group -r	Name der Azure-Ressourcengruppe. Sie können die Standardgruppe mit az config set defaults.group=<name>konfigurieren. Werte aus: az group list.

Optionale Parameter

Parameter	Beschreibung
--product -p	Der Produktname. Werte aus: az sphere product list
--device-group -dg	Die anzuzeigende Gerätegruppe. Werte aus: az sphere device

Beispiele

Listet alle Geräte in einer Ressourcengruppe und einem Katalog auf.

az sphere device list --resource-group MyResourceGroup --catalog MyCatalog

Listet alle Geräte in einer Ressourcengruppe, einem Katalog und einem Produkt auf.

az sphere device list --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct

Listet alle Geräte in einer Ressourcengruppe, einem Katalog, einem Produkt und einer Gerätegruppe auf.

az sphere device list --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup

az sphere device show-count

Zeigen Sie die Anzahl der Geräte in Ihrem Katalog, Produkt oder Ihrer Gerätegruppe an.

Erforderliche Parameter

Parameter	Beschreibung
--catalog -c	Der Azure Sphere-Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie den Namen des Azure Sphere-Katalogs an. Sie können den Azure Sphere-Standardkatalog mit az config set defaults.sphere.catalog=<name>konfigurieren. Werte aus: az sphere catalog list.
--resource-group -r	Name der Azure-Ressourcengruppe. Sie können die Standardgruppe mit az config set defaults.group=<name>konfigurieren. Werte aus: az group list.

Optionale Parameter

Parameter	Beschreibung
--product -p	Der Produktname. Werte aus: az sphere product list
--device-group -dg	Die anzuzeigende Gerätegruppe. Werte aus: az sphere device

Beispiele

Zeigt die Anzahl der Geräte in einer Ressourcengruppe und einem Katalog an.

az sphere device show-count --resource-group MyResourceGroup --catalog MyCatalog

Zeigt die Anzahl der Geräte in einer Ressourcengruppe, einem Katalog und einem Produkt an.

az sphere device show-count --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct

Zeigt die Anzahl der Geräte in einer Ressourcengruppe, einem Katalog, einem Produkt und einer Gerätegruppe an.

az sphere device show-count --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup

az sphere device show

Zeigen Sie Details eines vorhandenen Geräts in Ihrer Ressourcengruppe und im Katalog an.

Erforderliche Parameter

Parameter	Beschreibung
--catalog -c	Der Azure Sphere-Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie den Namen des Azure Sphere-Katalogs an. Sie können den Azure Sphere-Standardkatalog mit az config set defaults.sphere.catalog=<name>konfigurieren. Werte aus: az sphere catalog list.
--resource-group -r	Name der Azure-Ressourcengruppe. Sie können die Standardgruppe mit az config set defaults.group=<name>konfigurieren. Werte aus: az group list.

Optionale Parameter

Parameter	Beschreibung
--device -d	Das Gerät, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Geben Sie die ID, IP-Adresse oder lokale Verbindungs-ID eines angefügten Geräts an. Werte aus: az sphere device list

Beispiele

Zeigen Sie Die Details eines Geräts mithilfe der Ressourcengruppe, des Katalognamens und der Geräte-ID an.

az sphere device show --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

az sphere device assign

Weisen Sie ein Gerät einer Gerätegruppe in Ihrer Ressourcengruppe und ihrem Katalog zu.

Erforderliche Parameter

Parameter	Beschreibung
--device -d	Das Gerät, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Geben Sie die ID, IP-Adresse oder lokale Verbindungs-ID eines angefügten Geräts an. Werte aus: az sphere device list
--target-product	Der Name des Zielprodukts. Werte aus: az sphere product list
--target-device-group	Der Name der Zielgerätegruppe. Werte aus: az sphere device
--catalog -c	Der Azure Sphere-Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie den Namen des Azure Sphere-Katalogs an. Sie können den Azure Sphere-Standardkatalog mit az config set defaults.sphere.catalog=<name>konfigurieren. Werte aus: az sphere catalog list.
--resource-group -r	Name der Azure-Ressourcengruppe. Sie können die Standardgruppe mit az config set defaults.group=<name>konfigurieren. Werte aus: az group list.

Beispiele

Weisen Sie ein Gerät mithilfe der Ressourcengruppe, des Katalognamens, des Zielproduktnamens, des Zielgerätegruppennamens und der Geräte-ID zu.

az sphere device assign --resource-group MyResourceGroup --catalog MyCatalog --target-product MyProduct --target-device-group MyCurrentDeviceGroup --device <DeviceIdValue>

az sphere device unassign

Heben Sie die Zuweisung eines Geräts zu einer Gerätegruppe in Ihrer Ressourcengruppe und ihrem Katalog auf.

Erforderliche Parameter

Parameter	Beschreibung
--device -d	Das Gerät, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Geben Sie die ID, IP-Adresse oder lokale Verbindungs-ID eines angefügten Geräts an. Werte aus: az sphere device list
--catalog -c	Der Azure Sphere-Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie den Namen des Azure Sphere-Katalogs an. Sie können den Azure Sphere-Standardkatalog mit az config set defaults.sphere.catalog=<name>konfigurieren. Werte aus: az sphere catalog list.
--resource-group -r	Name der Azure-Ressourcengruppe. Sie können die Standardgruppe mit az config set defaults.group=<name>konfigurieren. Werte aus: az group list.

Beispiele

Heben Sie die Zuweisung eines Geräts mithilfe der Ressourcengruppe, des Katalognamens und der Geräte-ID auf.

az sphere device unassign --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

az sphere device restart

Starten Sie das angeschlossene Gerät neu.

Erforderliche Parameter

Parameter	Beschreibung
--catalog -c	Der Azure Sphere-Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie den Namen des Azure Sphere-Katalogs an. Sie können den Azure Sphere-Standardkatalog mit az config set defaults.sphere.catalog=<name>konfigurieren. Werte aus: az sphere catalog list.
--resource-group -r	Name der Azure-Ressourcengruppe. Sie können die Standardgruppe mit az config set defaults.group=<name>konfigurieren. Werte aus: az group list.

Optionale Parameter

Parameter	Beschreibung
--device -d	Das Gerät, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Geben Sie die ID, IP-Adresse oder lokale Verbindungs-ID eines angefügten Geräts an. Werte aus: az sphere device list

Beispiele

Starten Sie das angeschlossene Gerät neu.

az sphere device restart

Starten Sie ein angegebenes Gerät neu.

az sphere device restart --device <DeviceIdValue>

az sphere device claim

Fordern Sie ein Gerät in Ihrer Ressourcengruppe und ihrem Katalog an.

Erforderliche Parameter

Parameter	Beschreibung
--catalog -c	Der Azure Sphere-Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie den Namen des Azure Sphere-Katalogs an. Sie können den Azure Sphere-Standardkatalog mit az config set defaults.sphere.catalog=<name>konfigurieren. Werte aus: az sphere catalog list.
--resource-group -r	Name der Azure-Ressourcengruppe. Sie können die Standardgruppe mit az config set defaults.group=<name>konfigurieren. Werte aus: az group list.

Optionale Parameter

Parameter	Beschreibung
--device -d	Das Gerät, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Geben Sie die ID, IP-Adresse oder lokale Verbindungs-ID eines angefügten Geräts an. Werte aus: az sphere device list
--product -p	Der Produktname. Werte aus: az sphere product list
--device-group -dg	Die anzuzeigende Gerätegruppe. Werte aus: az sphere device

Beispiele

Fordern Sie ein Gerät mithilfe der Ressourcengruppe, des Katalognamens und der Geräte-ID an.

az sphere device claim --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

Fordern Sie ein Gerät mithilfe der Ressourcengruppe, des Katalognamens, des Produktnamens, des Gerätegruppennamens und der Geräte-ID an.

az sphere device claim --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --device <DeviceIdValue>

az sphere device recover

Verwenden Sie den Wiederherstellungsmodus, um neue Firmware auf das angeschlossene Gerät zu laden.

Erforderliche Parameter

Parameter	Beschreibung
--catalog -c	Der Azure Sphere-Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie den Namen des Azure Sphere-Katalogs an. Sie können den Azure Sphere-Standardkatalog mit az config set defaults.sphere.catalog=<name>konfigurieren. Werte aus: az sphere catalog list.
--resource-group -r	Name der Azure-Ressourcengruppe. Sie können die Standardgruppe mit az config set defaults.group=<name>konfigurieren. Werte aus: az group list.

Optionale Parameter

Parameter	Beschreibung
--device -d	Das Gerät, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Geben Sie die ID, IP-Adresse oder lokale Verbindungs-ID eines angefügten Geräts an. Werte aus: az sphere device list
--Fähigkeit	Dateiname eines Gerätefunktionsimages, das während der Wiederherstellung auf das Gerät angewendet werden soll. (Pfad)
--Bilder	Ordner mit den Bildpaketen, die auf das Gerät geschrieben werden sollen. Wenn nicht angegeben, werden die neuesten Betriebssystemimages heruntergeladen und verwendet. (Pfad)

Beispiele

Wiederherstellen eines angeschlossenen Geräts.

az sphere device recover

Stellen Sie ein angeschlossenes Gerät mit bestimmten Funktionen und Images wieder her.

az sphere device recover --capability myCapability.cap --images myImagesFolder

az sphere device show-os-version

Zeigen Sie die Betriebssystemversion auf dem angeschlossenen Gerät an.

Erforderliche Parameter

Parameter	Beschreibung
--catalog -c	Der Azure Sphere-Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie den Namen des Azure Sphere-Katalogs an. Sie können den Azure Sphere-Standardkatalog mit az config set defaults.sphere.catalog=<name>konfigurieren. Werte aus: az sphere catalog list.
--resource-group -r	Name der Azure-Ressourcengruppe. Sie können die Standardgruppe mit az config set defaults.group=<name>konfigurieren. Werte aus: az group list.

Optionale Parameter

Parameter	Beschreibung
--device -d	Das Gerät, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Geben Sie die ID, IP-Adresse oder lokale Verbindungs-ID eines angefügten Geräts an. Werte aus: az sphere device list

Beispiele

Zeigen Sie die Betriebssystemversion auf dem angeschlossenen Gerät an.

az sphere device show-os-version

Anzeigen der Betriebssystemversion auf einem angegebenen Gerät.

az sphere device show-os-version --device <DeviceIdValue>

az sphere device show-deployment-status

Anzeigen der Bereitstellung status des Betriebssystems auf einem Gerät.

Erforderliche Parameter

Parameter	Beschreibung
--catalog -c	Der Azure Sphere-Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie den Namen des Azure Sphere-Katalogs an. Sie können den Azure Sphere-Standardkatalog mit az config set defaults.sphere.catalog=<name>konfigurieren. Werte aus: az sphere catalog list.
--resource-group -r	Name der Azure-Ressourcengruppe. Sie können die Standardgruppe mit az config set defaults.group=<name>konfigurieren. Werte aus: az group list.

Optionale Parameter

Parameter	Beschreibung
--device -d	Das Gerät, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Geben Sie die ID, IP-Adresse oder lokale Verbindungs-ID eines angefügten Geräts an. Werte aus: az sphere device list

Beispiele

Zeigen Sie die Bereitstellung status des Betriebssystems mithilfe der Ressourcengruppe, des Katalognamens und der Geräte-ID an.

az sphere device show-deployment-status --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

az sphere device enable-development

"Aktivieren Sie ein Gerät für die Entwicklung, indem Sie das Querladen und Debuggen auf dem angeschlossenen Gerät aktivieren und es einer Gerätegruppe zuweisen, die Anwendungsupdates aus der Cloud deaktiviert. Standardmäßig ist dies die Gerätegruppe Entwicklung des Produkts des Geräts, aber es können andere Gerätegruppen angegeben werden. Nicht für die Verwendung in Fertigungsszenarien

Erforderliche Parameter

Parameter	Beschreibung
--catalog -c	Der Azure Sphere-Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie den Namen des Azure Sphere-Katalogs an. Sie können den Azure Sphere-Standardkatalog mit az config set defaults.sphere.catalog=<name>konfigurieren. Werte aus: az sphere catalog list.
--resource-group -r	Name der Azure-Ressourcengruppe. Sie können die Standardgruppe mit az config set defaults.group=<name>konfigurieren. Werte aus: az group list.

Optionale Parameter

Parameter	Beschreibung
--device -d	Das Gerät, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Geben Sie die ID, IP-Adresse oder lokale Verbindungs-ID eines angefügten Geräts an. Werte aus: az sphere device list
--enable-rt-core-debugging -r	Installieren Sie Treiber, die zum Debuggen von Anwendungen erforderlich sind, die auf einem Echtzeitkern ausgeführt werden. Erfordert Administratorberechtigungen.
--product -p	Der Produktname. Werte aus: az sphere product list
--device-group -dg	Die anzuzeigende Gerätegruppe. Werte aus: az sphere device

Beispiele

Aktivieren Sie ein Gerät für die Entwicklung, indem Sie das Querladen und Debuggen mithilfe der Ressourcengruppe, des Katalognamens, der Geräte-ID und der Standardgerätegruppe Entwicklung aktivieren.

az sphere device enable-development --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

Aktivieren Sie ein Gerät für die Entwicklung, indem Sie das Querladen und Debuggen mithilfe der Ressourcengruppe, des Katalognamens, des Produktnamens, des Gerätegruppennamens und der Geräte-ID aktivieren.

az sphere device enable-development --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --device <DeviceIdValue>

az sphere device enable-cloud-test

"Aktivieren Sie ein Gerät zum Testen des Ladens in die Cloud, indem Sie die Entwicklung und das Debuggen auf dem angefügten Gerät deaktivieren und es einer Gerätegruppe zuweisen, die Anwendungsupdates aus der Cloud ermöglicht. Standardmäßig ist dies die Feldtestgerätegruppe des Produkts des Geräts, aber es können andere Gerätegruppen angegeben werden. Nicht für die Verwendung in Fertigungsszenarien

Erforderliche Parameter

Parameter	Beschreibung
--catalog -c	Der Azure Sphere-Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie den Namen des Azure Sphere-Katalogs an. Sie können den Azure Sphere-Standardkatalog mit az config set defaults.sphere.catalog=<name>konfigurieren. Werte aus: az sphere catalog list.
--resource-group -r	Name der Azure-Ressourcengruppe. Sie können die Standardgruppe mit az config set defaults.group=<name>konfigurieren. Werte aus: az group list.

Optionale Parameter

Parameter	Beschreibung
--device -d	Das Gerät, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Geben Sie die ID, IP-Adresse oder lokale Verbindungs-ID eines angefügten Geräts an. Werte aus: az sphere device list
--product -p	Der Produktname. Werte aus: az sphere product list
--device-group -dg	Die anzuzeigende Gerätegruppe. Werte aus: az sphere device

Beispiele

Aktivieren Sie ein Gerät zum Testen der Cloud mithilfe der Ressourcengruppe, des Katalognamens, der Geräte-ID und der Standardmäßigen Feldtestgerätegruppe.

az sphere device enable-cloud-test --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

Aktivieren Sie ein Gerät zum Testen der Cloud mithilfe von Ressourcengruppe, Katalogname, Produktname, Gerätegruppenname und Geräte-ID.

az sphere device enable-cloud-test --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --device <DeviceIdValue>