Verwalten von Gerätegruppen
Wichtig
Dies ist die Dokumentation zu Azure Sphere (Legacy). Azure Sphere (Legacy) wird am 27. September 2027 eingestellt, und Benutzer müssen bis zu diesem Zeitpunkt zu Azure Sphere (integriert) migrieren. Verwenden Sie die Versionsauswahl oberhalb des Inhaltsverzeichniss, um die Dokumentation zu Azure Sphere (Integriert) anzuzeigen.
In diesem Thema wird beschrieben, wie Sie Ihre Gerätegruppen mit dem CLI- oder Azure Sphere-Explorer verwalten. Bei den Schritten in diesem Thema wird davon ausgegangen, dass Sie mit den Konzepten von Azure Sphere-Mandanten, -Produkten und -Gerätegruppen vertraut sind.
Auflisten von Gerätegruppen
Auflisten aller Gerätegruppen in Ihrem Azure Sphere-Mandanten mithilfe des Azsphere-Gerätegruppenlistenbefehls oder mithilfe der Gerätegruppen-Listen-API.
So listen Sie alle Gerätegruppen auf:
azsphere device-group list
Listen Sie die Gerätegruppen in einem bestimmten Produkt mithilfe des Befehls "Azsphere-Produktgerätegruppenliste" oder mithilfe der API "Produkt - Gruppen" auf.
azsphere product device-group list --product <product-name>
Erweitern Sie den Mandantenknoten für den Mandanten, an dem Sie interessiert sind.
Erweitern Sie den Mandantenknoten für den Mandanten, an dem Sie interessiert sind.
So zeigen Sie die Produkte und Gerätegruppen eines Mandanten an:
Erweitern Sie den Mandantenknoten für den Mandanten, an dem Sie interessiert sind.
Wenn keine Produkte aufgeführt sind, erstellen Sie ein Produkt.
Wenn das Gerät bereits einem Produkt zugeordnet und einer Gruppe zugewiesen ist, können Sie die Gerätegruppe jederzeit aktualisieren.
So zeigen Sie die Produkte und Gerätegruppen eines Mandanten an:
Erweitern Sie den Mandantenknoten für den Mandanten, an dem Sie interessiert sind.
Wenn keine Produkte aufgeführt sind, erstellen Sie ein Produkt.
Wenn das Gerät bereits einem Produkt zugeordnet und einer Gruppe zugewiesen ist, können Sie die Gerätegruppe jederzeit aktualisieren.
Erstellen einer Gerätegruppe
Erstellen Sie eine Gerätegruppe mithilfe des Azsphere-Gerätegruppen-Erstellungsbefehls oder mithilfe der Gerätegruppe – Api erstellen.
Gehen Sie wie folgt vor, um eine Gerätegruppe zu erstellen:
azsphere device-group create --product <product-name> --name <device-group-name> --description <device-group-description>
Namen für Gerätegruppen können nur alphanumerische Zeichen und Leerzeichen enthalten. Sie dürfen 50 Zeichen nicht überschreiten. Wenn entweder der Name oder die Beschreibung Leerzeichen enthält, schließen Sie ihn in Anführungszeichen ein.
Sie können die folgenden optionalen Parameter einschließen:
--os-feed
Gibt den Betriebssystemfeedtyp an, der für Betriebssystemupdates verwendet werden soll.--application-update
legt die Richtlinie für Anwendungsupdates für diese Gerätegruppe fest.
Erweitern Sie für den Mandanten, an dem Sie interessiert sind, den Knoten "Produkt".
Klicken Sie für das produkt, an dem Sie interessiert sind, mit der rechten Maustaste, und wählen Sie "Neue Gerätegruppe" aus.
Geben Sie einen Namen für die Gerätegruppe an, und drücken Sie die EINGABETASTE. Namen für Gerätegruppen können nur alphanumerische Zeichen und Leerzeichen enthalten. Sie dürfen 50 Zeichen nicht überschreiten. Wenn Sie einen ungültigen Namen angeben, wird im Ausgabefenster ein Fehler gemeldet.
Sie können eine Gerätegruppe in Visual Studio Code erstellen, aber nicht löschen. Um eine Gerätegruppe zu löschen, verwenden Sie den Befehl zum Löschen der Azsphere-Gerätegruppe oder die öffentliche Azure Sphere-API.
Erweitern Sie für den Mandanten, an dem Sie interessiert sind, den Knoten "Produkt".
Klicken Sie für das produkt, an dem Sie interessiert sind, mit der rechten Maustaste, und wählen Sie "Neue Gerätegruppe" aus.
Geben Sie einen Namen für die Gerätegruppe an, und drücken Sie die EINGABETASTE , oder klicken Sie auf " Übernehmen". Namen für Gerätegruppen können nur alphanumerische Zeichen und Leerzeichen enthalten. Sie dürfen 50 Zeichen nicht überschreiten. Wenn Sie einen ungültigen Namen angeben, wird im Ausgabefenster ein Fehler gemeldet.
Sie können eine Gerätegruppe in Visual Studio erstellen, aber nicht löschen. Verwenden Sie zum Löschen von Produkten den Befehl zum Löschen von Azsphere-Geräten oder die öffentliche Azure Sphere-API.
Aktualisieren der Gerätegruppe
Sie können den Namen oder die Beschreibung einer Gerätegruppe mithilfe des Azsphere Gerätegruppenaktualisierungsbefehls oder mithilfe der Gerätegruppe – Patch-API ändern.
So aktualisieren Sie den Namen und die Beschreibung einer Gerätegruppe:
azsphere device-group update --device-group <device group ID or product-name/device-group-name> --new-name <new-device-group-name> --new-description <new-device-group-description>
Sie können die os-feed
Parameter auch mithilfe des Azsphere Gerätegruppenaktualisierungsbefehls application-update
aktualisieren.
Erweitern Sie für den Mandanten, an dem Sie interessiert sind, den Knoten "Produkt".
Erweitern Sie für das Produkt, an dem Sie interessiert sind, den Produktknoten, um die enthaltenen Gerätegruppen anzuzeigen. Sie können die Gerätegruppe umbenennen oder die Beschreibung, den Betriebssystemfeedtyp oder die Updaterichtlinie aktualisieren:
Um eine Gerätegruppe umzubenennen, klicken Sie mit der rechten Maustaste auf den Gerätegruppennamen, wählen Sie "Umbenennen" aus, geben Sie einen neuen Namen ein, und drücken Sie dann die EINGABETASTE. Namen für Gerätegruppen können nur alphanumerische Zeichen und Leerzeichen enthalten. Sie dürfen 50 Zeichen nicht überschreiten. Wenn Sie einen ungültigen Namen angeben, wird im Ausgabefenster ein Fehler gemeldet.
Um die Beschreibung für die Gerätegruppe zu aktualisieren, klicken Sie mit der rechten Maustaste auf den Gerätegruppennamen, wählen Sie "Beschreibung aktualisieren", geben Sie eine neue Beschreibung ein, und drücken Sie dann die EINGABETASTE.
Um den Betriebssystemfeedtyp zu aktualisieren, erweitern Sie die Gerätegruppe, klicken Sie mit der rechten Maustaste auf den Betriebssystemfeedtyp, wählen Sie "Aktualisieren" aus, und wählen Sie dann im Menü "Retail" oder "RetailEval" aus.
Um die Updaterichtlinie zu ändern, erweitern Sie die Gerätegruppe, klicken Sie mit der rechten Maustaste auf "Updaterichtlinie", wählen Sie "Aktualisieren" aus, und wählen Sie dann "No3rdPartyAppUpdates " oder "UpdateAll " aus dem Menü aus. (Die dritte Option, NoUpdates ist derzeit für die interne Verwendung reserviert. Wenn Sie diese Option auswählen, wird im Ausgabefenster ein Fehler gemeldet.)
Verschieben Eines Geräts in eine andere Gerätegruppe mithilfe des Azsphere-Geräteaktualisierungsbefehls oder mithilfe der Geräte-Move-API .
Erweitern Sie für den Mandanten, an dem Sie interessiert sind, den Knoten "Produkt".
Erweitern Sie für das Produkt, an dem Sie interessiert sind, den Produktknoten, um die enthaltenen Gerätegruppen anzuzeigen. Sie können die Gerätegruppe umbenennen oder die Beschreibung, den Betriebssystemfeedtyp oder die Updaterichtlinie aktualisieren:
Um eine Gerätegruppe umzubenennen, wählen Sie den Gerätegruppennamen aus, drücken Sie F2 , oder klicken Sie mit der rechten Maustaste auf den Gerätegruppennamen, und wählen Sie "Umbenennen" aus, geben Sie einen neuen Namen ein, und drücken Sie dann die EINGABETASTE , oder klicken Sie auf " Übernehmen". Namen für Gerätegruppen können nur alphanumerische Zeichen und Leerzeichen enthalten. Sie dürfen 50 Zeichen nicht überschreiten. Wenn Sie einen ungültigen Namen angeben, wird im Ausgabefenster ein Fehler gemeldet.
Um die Beschreibung für die Gerätegruppe zu aktualisieren, erweitern Sie die Gerätegruppe, wählen Sie "Beschreibung" aus, drücken Sie F2, oder klicken Sie mit der rechten Maustaste auf "Beschreibung", und wählen Sie "Ändern" aus, geben Sie eine neue Beschreibung ein, und drücken Sie dann die EINGABETASTE, oder klicken Sie auf "Übernehmen".
Um den Betriebssystemfeedtyp zu aktualisieren, erweitern Sie die Gerätegruppe, wählen Sie den Betriebssystemfeedtyp aus, drücken Sie F2, oder klicken Sie mit der rechten Maustaste auf den Betriebssystemfeedtyp, und wählen Sie "Ändern" aus, wählen Sie "Einzelhandel" oder "RetailEval" im Menü aus, und drücken Sie dann die EINGABETASTE, oder klicken Sie auf "Übernehmen".
Um die Updaterichtlinie zu ändern, erweitern Sie die Gerätegruppe, wählen Sie die Updaterichtlinie aus, drücken Sie F2, oder klicken Sie mit der rechten Maustaste auf "Richtlinie aktualisieren", und wählen Sie "Ändern", wählen Sie "No3rdPartyAppUpdates" oder "UpdateAll" im Menü aus, und drücken Sie dann die EINGABETASTE, oder klicken Sie auf "Übernehmen". (Die dritte Option, NoUpdates ist derzeit für die interne Verwendung reserviert. Wenn Sie diese Option auswählen, wird im Ausgabefenster ein Fehler gemeldet).
Verschieben Eines Geräts in eine andere Gerätegruppe mithilfe des Azsphere-Geräteaktualisierungsbefehls oder mithilfe der Geräte-Move-API .
Verschieben eines Geräts in eine andere Gerätegruppe
Verschieben Eines Geräts in eine andere Gerätegruppe mithilfe des Azsphere-Geräteaktualisierungsbefehls oder mithilfe der Geräte-Move-API .
Geben Sie entweder die Gerätegruppen-ID oder eine Kombination des Produktnamens und des Gerätegruppennamens <im Format "Produktname>/<Gerätegruppenname> " an:
azsphere device update --device-group <device-group-id>
azsphere device update --device-group <product-name/device-group-name>
Löschen einer Gerätegruppe
Löschen Sie eine angegebene Gerätegruppe in Ihrem Azure Sphere-Mandanten mit dem Befehl zum Löschen der Azsphere-Gerätegruppe oder mithilfe der Gerätegruppe - Lösch-API.
Eine Gerätegruppe kann nur gelöscht werden, wenn:
- Der Benutzer verfügt über Administratorberechtigungen für den Mandanten.
- Die Gerätegruppe ist leer und enthält keine Geräte. Der Befehl "gerätegruppenspezifische Geräteliste " listet alle Geräte in einer Gerätegruppe auf. Führen Sie azsphere Device Update --device-group aus, um das Gerät in eine andere Gerätegruppe zu verschieben.
Geben Sie entweder die Gerätegruppen-ID oder eine Kombination des Produktnamens und des Gerätegruppennamens <im Format "Produktname>/<Gerätegruppenname> " an:
azsphere device-group delete --device-group <device-group-id>
azsphere device-group delete --device-group <product-name/device-group-name>