Azure Sphere-Gerät

Verwalten von Azure Sphere Geräten.

Operation Description
az kugelgerät rescan-attached Zeigt die Anzahl der angeschlossenen Geräte an.
az kugelgerät list-attached Auflisten aller angeschlossenen Geräte.
az kugelgerät show-attached Zeigen Sie die Details des angeschlossenen Geräts an.
az Sphere Geräteliste Listet alle Geräte in Ihrem Katalog, Produkt oder der Gerätegruppe auf.
az Sphere-Gerät Anzahl anzeigen Zeigen Sie die Anzahl der Geräte in Ihrem Katalog, Produkt oder ihrer Gerätegruppe an.
Az Kugelgerät anzeigen Zeigen Sie Details eines vorhandenen Geräts in Ihrer Ressourcengruppe und ihrem Katalog an.
az kugelgerät zuweisen Weisen Sie einer Gerätegruppe in Ihrer Ressourcengruppe und ihrem Katalog ein Gerät zu.
az Sphere-Gerät Zuweisung aufheben Entfernen Sie die Zuweisung eines Geräts zu einer Gerätegruppe in Ihrer Ressourcengruppe und Ihrem Katalog.
az Sphere-Gerät neu starten Starten Sie das angeschlossene Gerät neu.
az Kugel-Geräteanspruch Fordern Sie ein Gerät in Ihrer Ressourcengruppe und ihrem Katalog an.
az Azure Sphere-Gerät wiederherstellen Verwenden Sie den Wiederherstellungsmodus, um neue Firmware auf das angeschlossene Gerät zu laden.
az kugelgerät show-os-version Zeigt die Betriebssystemversion auf dem angeschlossenen Gerät an.
az sphere device show-deployment-status Zeigen Sie den Bereitstellungsstatus des Betriebssystems auf einem Gerät an.
az kugelgerät enable-development "Aktivieren Sie ein Gerät für die Entwicklung, indem Sie das Querladen und Debuggen auf dem angeschlossenen Gerät aktivieren und einer Gerätegruppe zuweisen, die Anwendungsupdates aus der Cloud deaktiviert. Standardmäßig ist dies die Gerätegruppe "Entwicklung" des Produkts des Geräts, andere Gerätegruppen können jedoch angegeben werden. Nicht zur Verwendung in Fertigungsszenarien: Weitere Informationen finden Sie unter https://aka.ms/AzureSphereManufacturing.
az kugelgerät enable-cloud-test "Aktivieren Sie ein Gerät zum Testen des Ladens der Cloud, indem Sie die Entwicklung und das Debuggen auf dem angeschlossenen Gerät deaktivieren und einer Gerätegruppe zuweisen, die Anwendungsupdates aus der Cloud ermöglicht. Standardmäßig ist dies die Feldtestgerätegruppe des Produkts des Geräts, andere Gerätegruppen können jedoch angegeben werden. Nicht zur Verwendung in Fertigungsszenarien: Weitere Informationen finden Sie unter https://aka.ms/AzureSphereManufacturing.

Commands

az kugelgerät rescan-attached

Zeigt die Anzahl der angeschlossenen Geräte an.

Erforderliche Parameter

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

Beispiele

Zeigt die Anzahl der angeschlossenen Geräte an.

az sphere device rescan-attached

az kugelgerät list-attached

Auflisten aller angeschlossenen Geräte.

Erforderliche Parameter

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

Beispiele

Auflisten aller angeschlossenen Geräte.

az sphere device list-attached

az kugelgerät show-attached

Zeigen Sie die Details des angeschlossenen Geräts an.

Optionale Parameter

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

Beispiele

Details des angeschlossenen Geräts anzeigen.

az sphere device show-attached

Details des angegebenen Geräts anzeigen.

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

az Sphere-Geräteliste

Listet alle Geräte in Ihrem Katalog, Produkt oder der Gerätegruppe auf.

Erforderliche Parameter

Parameter Description
--catalog -c Der Azure Sphere Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie Azure Sphere Katalognamen an. Sie können den Standardkatalog Azure Sphere mithilfe von az config set defaults.sphere.catalog=<name> konfigurieren. Werte aus: az Sphere-Katalogliste.
--resource-group -g 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 Description
--product -p Produktname Werte aus: az sphere Produktliste.
--device-group -dg Der Name der Gerätegruppe. Werte aus: az sphere device-group list.

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 kugelgerät show-count

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

Erforderliche Parameter

Parameter Description
--catalog -c Der Azure Sphere Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie Azure Sphere Katalognamen an. Sie können den Standardkatalog Azure Sphere mithilfe von az config set defaults.sphere.catalog=<name> konfigurieren. Werte aus: az Sphere-Katalogliste.
--resource-group -g 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 Description
--product -p Produktname Werte aus: az sphere Produktliste.
--device-group -dg Der Name der Gerätegruppe. Werte aus: az sphere device-group list.

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 Kugelgerät anzeigen

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

Erforderliche Parameter

Parameter Description
--catalog -c Der Azure Sphere Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie Azure Sphere Katalognamen an. Sie können den Standardkatalog Azure Sphere mithilfe von az config set defaults.sphere.catalog=<name> konfigurieren. Werte aus: az Sphere-Katalogliste.
--resource-group -g 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 Description
--device -d Das Gerät, das für diesen Befehl als Ziel verwendet werden soll. Dies ist erforderlich, wenn kein Gerät oder mehrere Geräte angeschlossen sind, um das Zielgerät zu unterscheiden. Wenn das Gerät angeschlossen ist, können Sie entweder Geräte-ID, IP-Adresse oder lokale Verbindungs-ID angeben. Andernfalls müssen Sie nur die Geräte-ID angeben. Werte aus: az sphere device list.

Beispiele

Zeigen Sie Details zu einem Gerät mit Ressourcengruppe, Katalogname und Geräte-ID an.

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

az sphere-Gerät zuweisen

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

Erforderliche Parameter

Parameter Description
--device -d Das Gerät, das für diesen Befehl als Ziel verwendet werden soll. Dies ist erforderlich, wenn kein Gerät oder mehrere Geräte angeschlossen sind, um das Zielgerät zu unterscheiden. Wenn das Gerät angeschlossen ist, können Sie entweder Geräte-ID, IP-Adresse oder lokale Verbindungs-ID angeben. Andernfalls müssen Sie nur die Geräte-ID angeben. Werte aus: az sphere device list.
--target-product Der Name des Zielprodukts. Werte aus: az sphere Produktliste.
--target-device-group Der Name der Zielgerätegruppe. Werte aus: az sphere device-group list.
--catalog -c Der Azure Sphere Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie Azure Sphere Katalognamen an. Sie können den Standardkatalog Azure Sphere mithilfe von az config set defaults.sphere.catalog=<name> konfigurieren. Werte aus: az Sphere-Katalogliste.
--resource-group -g 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-Gerät Zuweisung aufheben

Entfernen Sie die Zuweisung eines Geräts zu einer Gerätegruppe in Ihrer Ressourcengruppe und Ihrem Katalog.

Erforderliche Parameter

Parameter Description
--device -d Das Gerät, das für diesen Befehl als Ziel verwendet werden soll. Dies ist erforderlich, wenn kein Gerät oder mehrere Geräte angeschlossen sind, um das Zielgerät zu unterscheiden. Wenn das Gerät angeschlossen ist, können Sie entweder Geräte-ID, IP-Adresse oder lokale Verbindungs-ID angeben. Andernfalls müssen Sie nur die Geräte-ID angeben. Werte aus: az sphere device list.
--catalog -c Der Azure Sphere Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie Azure Sphere Katalognamen an. Sie können den Standardkatalog Azure Sphere mithilfe von az config set defaults.sphere.catalog=<name> konfigurieren. Werte aus: az Sphere-Katalogliste.
--resource-group -g 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-Gerät neu starten

Starten Sie das angeschlossene Gerät neu.

Erforderliche Parameter

Parameter Description
--catalog -c Der Azure Sphere Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie Azure Sphere Katalognamen an. Sie können den Standardkatalog Azure Sphere mithilfe von az config set defaults.sphere.catalog=<name> konfigurieren. Werte aus: az Sphere-Katalogliste.
--resource-group -g 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 Description
--device -d Das Gerät, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Geben Sie die ID, DIE IP-Adresse oder die lokale Verbindungs-ID eines angefügten Geräts an. Werte aus: az sphere device list-attached.

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 Anspruch auf eine Kugelvorrichtung

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

Erforderliche Parameter

Parameter Description
--catalog -c Der Azure Sphere Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie Azure Sphere Katalognamen an. Sie können den Standardkatalog Azure Sphere mithilfe von az config set defaults.sphere.catalog=<name> konfigurieren. Werte aus: az Sphere-Katalogliste.
--resource-group -g 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 Description
--device -d Das Gerät, das für diesen Befehl als Ziel verwendet werden soll. Dies ist erforderlich, wenn kein Gerät oder mehrere Geräte angeschlossen sind, um das Zielgerät zu unterscheiden. Wenn das Gerät angeschlossen ist, können Sie entweder Geräte-ID, IP-Adresse oder lokale Verbindungs-ID angeben. Andernfalls müssen Sie nur die Geräte-ID angeben. Werte aus: az sphere device list.
--product -p Der Produktname, für den das Gerät reklamiert werden soll. Werte aus: az sphere Produktliste.
--device-group -dg Der Gerätegruppenname, unter dem das Gerät beansprucht werden soll. Werte aus: az sphere device-group list.

Beispiele

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

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-Gerät wiederherstellen

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

Erforderliche Parameter

Parameter Description
--catalog -c Der Azure Sphere Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie Azure Sphere Katalognamen an. Sie können den Standardkatalog Azure Sphere mithilfe von az config set defaults.sphere.catalog=<name> konfigurieren. Werte aus: az Sphere-Katalogliste.
--resource-group -g 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 Description
--device -d Das Gerät, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Geben Sie die ID, DIE IP-Adresse oder die lokale Verbindungs-ID eines angefügten Geräts an. Werte aus: az sphere device list-attached.
--Fähigkeit Dateiname eines Gerätefunktionsimages, das während der Wiederherstellung auf das Gerät angewendet werden soll. (Path).
--Bilder Ordner, der die Bildpakete enthält, die auf das Gerät geschrieben werden sollen. Wenn nicht angegeben, werden die neuesten Betriebssystemimages heruntergeladen und verwendet. (Path).

Beispiele

Angeschlossenes Gerät wiederherstellen.

az sphere device recover

Wiederherstellen eines angeschlossenen Geräts mit bestimmten Funktionen und Bildern.

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

az kugelgerät show-os-version

Zeigt die Betriebssystemversion auf dem angeschlossenen Gerät an.

Erforderliche Parameter

Parameter Description
--catalog -c Der Azure Sphere Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie Azure Sphere Katalognamen an. Sie können den Standardkatalog Azure Sphere mithilfe von az config set defaults.sphere.catalog=<name> konfigurieren. Werte aus: az Sphere-Katalogliste.
--resource-group -g 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 Description
--device -d Das Gerät, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Geben Sie die ID, DIE IP-Adresse oder die lokale Verbindungs-ID eines angefügten Geräts an. Werte aus: az sphere device list-attached.

Beispiele

Zeigt die Betriebssystemversion auf dem angeschlossenen Gerät an.

az sphere device show-os-version

Zeigt die Betriebssystemversion auf einem angegebenen Gerät an.

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

az sphere device show-deployment-status

Zeigen Sie den Bereitstellungsstatus des Betriebssystems auf einem Gerät an.

Erforderliche Parameter

Parameter Description
--catalog -c Der Azure Sphere Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie Azure Sphere Katalognamen an. Sie können den Standardkatalog Azure Sphere mithilfe von az config set defaults.sphere.catalog=<name> konfigurieren. Werte aus: az sphere catalog list.
--resource-group -g 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 Description
--device -d Das Gerät, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Geben Sie die ID, DIE IP-Adresse oder die lokale Verbindungs-ID eines angefügten Geräts an. Werte aus dem Befehl: az sphere device list-attached.

Beispiele

Zeigen Sie den Bereitstellungsstatus 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-Gerät enable-development

"Aktivieren Sie ein Gerät für die Entwicklung, indem Sie das Querladen und Debuggen auf dem angeschlossenen Gerät aktivieren und einer Gerätegruppe zuweisen, die Anwendungsupdates aus der Cloud deaktiviert. Standardmäßig ist dies die Gerätegruppe "Entwicklung" des Produkts des Geräts, andere Gerätegruppen können jedoch angegeben werden. Nicht zur Verwendung in Fertigungsszenarien: siehe https://aka.ms/AzureSphereManufacturing für weitere Informationen.

Erforderliche Parameter

Parameter Description
--catalog -c Der Azure Sphere Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie Azure Sphere Katalognamen an. Sie können den Standardkatalog Azure Sphere mithilfe von az config set defaults.sphere.catalog=<name> konfigurieren. Werte aus: az Sphere-Katalogliste.
--resource-group -g 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 Description
--device -d Das Gerät, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Geben Sie die ID, DIE IP-Adresse oder die lokale Verbindungs-ID eines angefügten Geräts an. Werte aus dem Befehl: az sphere device list-attached.
--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 Zielproduktname. Das Gerät wird der Standardmäßigen Gerätegruppe "Entwicklung" des ausgewählten Produkts zugewiesen, es sei denn, die Gerätegruppe ist ebenfalls angegeben. Werte aus: az sphere produktliste.
--device-group -dg Der Gerätegruppenname, dem das Gerät zugewiesen wird. Standardmäßig ist dies die Gerätegruppe "Entwicklung" des Produkts. Werte aus: az sphere device-group list.

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 Standardmäßigen Entwicklungsgerätegruppe 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 kugelgerät enable-cloud-test

"Aktivieren Sie ein Gerät zum Testen des Ladens der Cloud, indem Sie die Entwicklung und das Debuggen auf dem angeschlossenen Gerät deaktivieren und einer Gerätegruppe zuweisen, die Anwendungsupdates aus der Cloud ermöglicht. Standardmäßig ist dies die Feldtestgerätegruppe des Produkts des Geräts, andere Gerätegruppen können jedoch angegeben werden. Nicht zur Verwendung in Fertigungsszenarien: Weitere Informationen finden Sie unter https://aka.ms/AzureSphereManufacturing.

Erforderliche Parameter

Parameter Description
--catalog -c Der Azure Sphere Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie Azure Sphere Katalognamen an. Sie können den Standardkatalog Azure Sphere mithilfe von az config set defaults.sphere.catalog=<name> konfigurieren. Werte aus: az Sphere-Katalogliste.
--resource-group -g 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 Description
--device -d Das Gerät, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angeschlossen sind. Geben Sie die ID, DIE IP-Adresse oder die lokale Verbindungs-ID eines angefügten Geräts an. Werte aus dem Befehl: az sphere device list-attached.
--product -p Der Zielproduktname. Das Gerät wird der standardmäßigen Feldtestgerätegruppe des ausgewählten Produkts zugewiesen, es sei denn, die Gerätegruppe ist ebenfalls angegeben. Werte aus: az sphere Produktliste.
--device-group -dg Der Gerätegruppenname, dem das Gerät zugewiesen wird. Standardmäßig ist dies die Feldtestgerätegruppe des Produkts. Werte aus: az sphere device-group list.

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 der Ressourcengruppe, des Katalognamens, des Produktnamens, des Gerätegruppennamens und der Geräte-ID.

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