Verwalten von Gerätegruppen
In diesem Thema wird beschrieben, wie Sie Ihre Gerätegruppen mithilfe der 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
Listen Sie alle Gerätegruppen in Ihrem Azure Sphere-Mandanten auf, indem Sie den Befehl azsphere device-group list oder die Gerätegruppe - List-API verwenden.
So listen Sie alle Gerätegruppen auf:
azsphere device-group list
Listen Sie die Gerätegruppen in einem bestimmten Produkt auf, indem Sie den Befehl azsphere product device-group list oder die API Product – List Groups verwenden.
azsphere product device-group list --product <product-name>
Erweitern Sie den Knoten Mandant für den Mandanten, an dem Sie interessiert sind.
Erweitern Sie den Knoten Mandant für den Mandanten, an dem Sie interessiert sind.
So zeigen Sie die Produkte und Gerätegruppen eines Mandanten an:
Erweitern Sie den Knoten Mandant 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 Knoten Mandant 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 mit dem Befehl azsphere device-group create oder mithilfe der API Gerätegruppe – Erstellen .
So erstellen Sie eine Gerätegruppe:
azsphere device-group create --product <product-name> --name <device-group-name> --description <device-group-description>
Namen für Gerätegruppen dürfen nur alphanumerische Zeichen und Leerzeichen enthalten. Sie dürfen 50 Zeichen nicht überschreiten. Wenn der Name oder die Beschreibung Leerzeichen enthält, schließen Sie sie in Anführungszeichen ein.
Sie können die folgenden optionalen Parameter einschließen:
--os-feedgibt den Betriebssystemfeedtyp an, der für Betriebssystemupdates verwendet werden soll.--application-updatelegt 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, das Sie interessieren, 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 dürfen 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. Verwenden Sie zum Löschen einer Gerätegruppe den Befehl azsphere device-group delete 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, das Sie interessieren, 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 dürfen 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 azsphere device-group delete oder die öffentliche Azure Sphere-API.
Aktualisieren der Gerätegruppe
Sie können den Namen oder die Beschreibung einer Gerätegruppe mithilfe des Befehls azsphere device-group update 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 und application-update auch mit dem Befehl azsphere device-group 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 ihre Beschreibung, den Typ des Betriebssystemfeeds oder die Richtlinie aktualisieren:
Um eine Gerätegruppe umzubenennen, klicken Sie mit der rechten Maustaste auf den Namen der Gerätegruppe, wählen Sie Umbenennen aus, geben Sie einen neuen Namen ein, und drücken Sie dann die EINGABETASTE. Namen für Gerätegruppen dürfen 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 Namen der Gerätegruppe, und wählen Sie Beschreibung aktualisieren aus, 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 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 im Menü No3rdPartyAppUpdates oder UpdateAll 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 Sie ein Gerät mithilfe des Befehls azsphere device update oder mithilfe der Api Geräte – Verschieben in eine andere Gerätegruppe.
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 ihre Beschreibung, den Typ des Betriebssystemfeeds oder die Richtlinie aktualisieren:
Um eine Gerätegruppe umzubenennen, wählen Sie den Namen der Gerätegruppe aus, drücken Sie F2 , oder klicken Sie mit der rechten Maustaste auf den Namen der Gerätegruppe, 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 dürfen 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 Typ des Betriebssystemfeeds aus, drücken Sie F2 , oder klicken Sie mit der rechten Maustaste auf Betriebssystemfeedtyp , und wählen Sie Ändern aus, wählen Sie im Menü Retail oder RetailEval 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 Updaterichtlinie aus, drücken Sie F2 , oder klicken Sie mit der rechten Maustaste auf Richtlinie aktualisieren , und wählen Sie Ändern aus, wählen Sie im Menü No3rdPartyAppUpdates oder UpdateAll 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 Sie ein Gerät mithilfe des Befehls azsphere device update oder mithilfe der Api Geräte – Verschieben in eine andere Gerätegruppe.
Verschieben eines Geräts in eine andere Gerätegruppe
Verschieben Sie ein Gerät mithilfe des Befehls azsphere device update oder mithilfe der Api Geräte – Verschieben in eine andere Gerätegruppe.
Geben Sie entweder die Gerätegruppen-ID oder eine Kombination aus Produktname und Gerätegruppenname im <Format product-name>/<device-group-name> 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, indem Sie den Befehl azsphere device-group delete oder die API Gerätegruppe – Löschen verwenden.
Eine Gerätegruppe kann nur in folgenden Fällen gelöscht werden:
- Der Benutzer verfügt über Administratorberechtigungen für den Mandanten.
- Die Gerätegruppe ist leer und enthält keine Geräte. Der Befehl azsphere device-group device list 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 aus Produktname und Gerätegruppenname im <Format product-name>/<device-group-name> an:
azsphere device-group delete --device-group <device-group-id>
azsphere device-group delete --device-group <product-name/device-group-name>